Kling 全能视频任务
Kling
Kling 全能视频 kling-v3-omni
通过 /kling/v1/videos/omni-video 提交 Kling 原生全能视频任务。
POST
Kling 全能视频任务
授权
在请求头中传入 Authorization: Bearer <token>。
请求体
application/json
模型名称
可用选项:
kling-v3-omni 是否生成多镜头视频。 当前参数为 true 时，prompt 参数无效。 当前参数为 false 时，shot_type 参数及 multi_prompt 参数无效。
分镜方式。 当 multi_shot 参数为 true 时，当前参数必填。
可用选项:
customize, intelligence 文本提示词，可包含正向描述和负向描述。
- 可将提示词模板化来满足不同的视频生成需求
- 不能超过 2,500 个字符
当 multi_shot 为 false 或 multi_shot参数为true且shot-type参数为intelligence时，当前参数不得为空。
Omni模型可通过Prompt与主体、图片、视频等内容实现多种能力：
- 通过<<<>>>的格式来指定某个主体、图片或视频，如：<<<element_1>>>、<<<image_1>>>、<<<video_1>>>Maximum string length:
2500各分镜信息，如提示词、时长等。 通过 index、prompt、duration 参数定义分镜序号及相应提示词和时长。
- 最多支持 6 个分镜，最小支持 1 个分镜。
- 每个分镜相关内容的最大长度不超过 512。
- 每个分镜的时长不大于当前任务的总时长，不小于 1。
- 所有分镜的时长之和等于当前任务的总时长。
当 multi_shot 为 true 且 shot_type 为 customize 时，当前参数不得为空。格式如下：
"multi_prompt":[{ "index": int, "prompt": "string", "duration": "5" },{ "index": int, "prompt": "string","duration": "5" }]参考图列表，包括主体、场景、风格等参考图片
- 包括主体、场景、风格等参考图片，也可作为首帧或尾帧生成视频；当作为首帧或尾帧生成视频时：
- 通过 type 参数来定义图片是否为首尾帧：first_frame 为首帧，end_frame 为尾帧；其中：
- 如图片非首帧或尾帧，请勿配置 type 参数
- 暂时不支持仅尾帧，即有尾帧图时必须有首帧图
- 首帧或首尾帧生视频时，不能使用视频编辑功能
- 通过 type 参数来定义图片是否为首尾帧：first_frame 为首帧，end_frame 为尾帧；其中：
用 key:value 承载，如下：
"image_list":[{ "image_url": "image_url"},{ "image_url": "image_url" }]图片要求：
- 支持传入图片Base64编码或图片URL（确保可访问）
- 格式：.jpg / .jpeg / .png
- 文件大小：≤10MB
- 尺寸：宽和高都不小于300px，宽高比1:2.5 ~ 2.5:1
- 参考图片数量与参考主体数量和参考主体类型有关，其中：
- 无参考视频+仅有多图主体时，参考图片与多图主体数量之和不得超过7；
数量限制：
- 参考图片数量与参考主体数量和参考主体类型有关，其中：
- 无参考视频+仅有多图主体时，参考图片与多图主体数量之和不得超过7；
- 无参考视频+有视频主体时，参考图片与多图主体数量之和不得超过4；
- 有参考视频+仅有多图主体时，参考图片与多图主体数量之和不得超过4；
- 使用kling-video-o1模型时，数组中超过2张图片时，不支持设置首尾帧
- image_url 参数值不得为空
主体参考列表，基于主体库中主体的ID配置。
- 用 key:value 承载，格式如下：
"element_list":[{ "element_id": long },{ "element_id": long }]- 主体分为视频定制主体（简称：视频角色主体）和图片定制主体（简称：多图主体），适用范围不同，请注意区分
- 参考主体数量与主体类型、有无参考视频、参考图片数量等因素有关，其中：
- 当使用首帧或首尾帧生成视频时，kling-v3-omni模型最多支持3个主体；
- 当使用首尾帧生成视频时，kling-video-o1模型不支持主体；
- 无参考视频+仅有多图主体时，参考图片与多图主体数量之和不得超过7；
- 无参考视频+仅有视频角色主体时，视频角色主体数量不得超过3；
- 无参考视频+同时有视频角色主体和多图主体时，视频角色主体数量不得超过3，参考图片与多图主体数量之和不得超过4；
- 有参考视频+仅有多图主体时，参考图片与多图主体数量之和不得超过4；
- 有参考视频时，不支持使用视频角色主体；
参考视频，通过URL方式获取。
视频类型：
- 可作为特征参考视频，也可作为待编辑视频，默认为待编辑视频
- 通过 refer_type 参数区分参考视频类型：feature 为特征参考视频，base 为待编辑视频
- 参考视频为待编辑视频时，不能定义视频首尾帧
- 通过 keep_original_sound 参数选择是否保留视频原声：yes 保留，no 不保留（对 feature 类型也生效）
有参考视频时，sound 参数值只能为 off。
用 key:value 承载，格式如下：
"video_list":[{ "video_url": "video_url", "refer_type": "base", "keep_original_sound": "yes" }]视频要求：
- 格式：仅支持 MP4/MOV
- 时长：不少于 3 秒，上限与模型版本有关，详见能力地图
- 分辨率：720px-2160px（宽高尺寸）
- 帧率：24-60fps（生成视频时会输出为 24fps）
- 至多 1 段视频，大小≤200MB
- video_url 参数值不得为空
生成视频时是否同时生成声音。
可用选项:
on, off 生成视频的模式
- std：标准模式（标准），基础模式，性价比高，输出视频分辨率为720P。
- pro：专家模式（高品质），高表现模式，生成视频质量更佳，输出视频分辨率为1080P。
- 4k：4K模式，高表现（同pro），生成视频质量更佳，输出视频分辨率为4K。
可用选项:
std, pro, 4k 生成视频的画面纵横比（宽:高）
- 未使用首帧参考或视频编辑功能时，当前参数必填。
可用选项:
1:1, 16:9, 9:16 请求的视频时长，单位秒。
- 使用视频编辑功能（"refer_type":"base"）时，输出结果与传入视频时长相同，此时当前参数无效；此时，按输入视频时长四舍五入取整计量计费
可用选项:
3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 是否同时生成含水印的结果。
本次任务结果回调通知地址，如果配置，服务端会在任务状态发生变更时主动通知。
自定义任务ID。