Omni-Video

POST

/kling/v1/videos/omni-video

创建 Omni-Video 视频生成任务（文生视频、图生视频、视频编辑等）。

Authorizations

bearer

Type

HTTP (bearer)

Request Body

application/json

object

模型名称。枚举值：kling-video-o1、kling-v3-omni

文本提示词，可包含正向描述和负向描述。
可将提示词模板化来满足不同的视频生成需求。
不能超过 2500 个字符。
当 multi_shot 参数为 false 时，当前参数不得为空。

object[]

参考图列表，包括主体、场景、风格等参考图片，也可作为首帧或尾帧生成视频。
当作为首帧或尾帧生成视频时：
通过 type 参数定义图片是否为首尾帧：first_frame 为首帧，end_frame 为尾帧。
暂时不支持仅尾帧，即有尾帧图时必须有首帧图。
首帧或首尾帧生视频时，不能使用视频编辑功能。

object[]

参考视频，通过 URL 方式获取。
可作为特征参考视频，也可作为待编辑视频，默认为待编辑视频；可选择性保留视频原声。
通过 refer_type 参数区分参考视频类型：feature 为特征参考视频，base 为待编辑视频。
参考视频为待编辑视频时，不能定义视频首尾帧。
通过 keep_original_sound 参数选择是否保留视频原声，yes 为保留，no 为不保留；当前参数对特征参考视频（feature）也生效。

生成视频的模式。
枚举值：std、pro。
std：标准模式（标准），基础模式，性价比高。
pro：专家模式（高品质），高表现模式，生成视频质量更佳。

生成视频的画面纵横比（宽:高）。
枚举值：16:9、9:16、1:1。
未使用首帧参考或视频编辑功能时，当前参数必填。

生成视频时长，单位 s。
枚举值：3、4、5、6、7、8、9、10。
使用文生视频、首帧图生视频时，仅支持 5 和 10s。
使用视频编辑功能（refer_type 为 base）时，输出结果与传入视频时长相同，此时当前参数无效；按输入视频时长四舍五入取整计量计费。
kling-v3-omni 支持枚举值：3–15；使用视频编辑功能（refer_type 为 base）时规则同上。

object[]

主体

是否生成多镜头视频。
当前参数为 true 时，prompt 参数无效。
当前参数为 false 时，shot_type 参数及 multi_prompt 参数无效。

分镜方式。
枚举值：customize。
当 multi_shot 参数为 true 时，当前参数必填。

object[]