Omni 视频生成
使用多种参考素材生成或编辑 Kling 4.0 视频。
feature_video 用于参考视频的特征与运动节奏，base_video 用于编辑已有视频。图片、视频、元素和音色合计最多 15 项，并需同时满足各类素材限制；元素与音色使用已有 ID，本页不包含素材管理接口。
/kling/omni-video/kling-4.0组合提示词、图片、视频、元素和音色生成或编辑视频。feature_video 用于视频参考，base_video 用于编辑；Omni 与其他两个生成端点使用同一个 Kling 4.0 模型。
Authorization
bearerAuth 使用平台 API Key：Authorization: Bearer your-api-key。
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
素材类型与引用
contents 必须包含提示词项 type: "prompt"，其他素材按需添加。id 用于提示词中的 @引用；所有填写的素材引用 ID 在同一任务中不得重复。
| 素材 | type | 来源与必填要求 |
|---|---|---|
| 图片 | first_frame / middle_frame / last_frame / refer_image | url 必填，支持 URL 或 Base64；id 可选 |
| 视频 | feature_video / base_video | url 必填，使用视频 URL；id 可选 |
| 元素 | element | element_id 与 id 均必填 |
| 音色 | voice | voice_id 与 id 均必填 |
element_id 是系统生成的元素 ID，可通过元素相关 API 查询；voice_id 是音色 ID，自定义音色通过自定义音色 API 获取，也可使用官方说明中的系统预设音色。它们与本次请求的素材引用 id 不是同一个参数。
元素的概念与使用方式参见 官方元素库指南，音色来源参见 官方音色定制说明。请使用对应区域的素材 ID，不要直接复用其他区域的预设 ID。
素材限制
| 素材 | 格式与大小 | 尺寸、时长与数量 |
|---|---|---|
| 图片 | JPG、JPEG、PNG；每张不超过 30MB | 宽高均不少于 300px；宽高比 2:5～5:2；最多 10 张 |
| 视频 | MP4、MOV；单文件不超过 300MB | 每段及输入视频总时长均为 3～30 秒；宽高 700～4553px，总像素不超过 8294400；宽高比 2:5～5:2；输入 24～60fps，输出 24fps |
| 元素 | 多图元素或视频角色元素 | 最多 7 个，其中视频角色元素最多 3 个 |
| 音色 | 已有自定义音色或系统预设音色 | 最多 3 个 |
组合素材时还需同时满足：
- 图片、视频、元素和音色合计不超过 15 项。
- 视频与视频角色元素合计不超过 5 项，
base_video最多 1 段。 - 输入视频总时长包括
feature_video、base_video和视频角色元素的源视频时长。
常见错误与排查
| 响应或错误信息 | 检查与处理 |
|---|---|
HTTP 401，Invalid token | 检查 Bearer 鉴权格式及 API Key 是否属于请求站点 |
HTTP 400，contents cannot be empty | 提供非空的 contents 数组 |
HTTP 400，prompt cannot be empty | 在 contents 中加入 type: "prompt" 的非空文本项 |
HTTP 400，contents[0].type ... is invalid | 按本页枚举填写素材类型，并检查报错索引对应的项 |
HTTP 400，Invalid element id | 检查 element_id，不要用本次素材引用 id 代替元素 ID |
HTTP 400，Invalid voice id | 检查 voice_id，不要用本次素材引用 id 代替音色 ID |
HTTP 400，invalid JSON request body | 检查 JSON 的引号、逗号、括号与注释 |
HTTP 400 可能返回 code/message/data 或 error 对象。fail_to_fetch_task 的具体原因在 message 中；该字段可能是包含 code/message/request_id 的 JSON 字符串。请保留请求 ID 以便排查，不要提供 API Key。