Kling v3 Omni
可灵 3.0-Omni 视频生成模型,在 Kling v3 基础上额外支持参考视频(视频源编辑 / 视频特征参考)
授权
在请求 Header 中传入 Authorization: Bearer <YOUR_API_KEY>。前往 API Keys 管理页 创建和管理 API Key。
请求体
固定值 kling/kling-v3-omni
提示词,可包含正向与负向描述,长度不超过 2500 字符。
Omni 模型支持在提示词中通过 <<<>>> 语法引用主体、图片、视频等素材,例如:<<<element_1>>>、<<<image_1>>>、<<<video_1>>>。
必填规则:
- 当
extra_params.multi_shot=false,或extra_params.multi_shot=true且extra_params.shot_type=intelligence时,本字段不得为空;- 当
extra_params.multi_shot=true且extra_params.shot_type=customize时,本字段被忽略,各分镜提示词由extra_params.multi_prompt提供。
"A slow pan across a misty mountain valley at sunrise, cinematic"
输出分辨率,默认 720P。
720P, 1080P 输出宽高比,默认 16:9。
16:9, 9:16, 1:1 视频时长(秒),默认 5。枚举值:3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15。
使用视频编辑功能(
reference_videos[].refer_type=base)时,本参数无效——输出时长与输入视频一致,按输入视频时长四舍五入取整计费。
3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 是否生成声音,默认 false。
参考图列表。可作为主体 / 场景 / 风格参考,也可作为视频首帧或尾帧。
输入模式(由 reference_type 组合决定):
- 图生视频:1 张
first_frame; - 首尾帧生视频:1 张
first_frame+ 1 张last_frame(暂不支持仅尾帧——传入last_frame时必须同时提供first_frame); - 多参考图生视频:N 张
asset(非首尾帧的素材可省略reference_type,默认即为asset)。
与 reference_videos 的组合规则:
- 传入
reference_videos[].refer_type=base(待编辑视频)时,reference_images不可使用first_frame/last_frame,仅支持asset; - 其他情况下
asset类型可与reference_videos共存。
图片要求:
- 格式:
jpg/jpeg/png; - 大小 ≤ 10 MB;
- 宽高尺寸 ≥ 300px,宽高比介于
1:2.5 ~ 2.5:1之间。
数量上限("参考图 + 多图主体" 总数):
- 无参考视频,仅含多图主体:≤ 7;
- 无参考视频,含视频主体:≤ 4;
- 有参考视频,仅含多图主体:≤ 4。
多图主体 / 视频主体通过
prompt中的<<<image_n>>>/<<<video_n>>>等占位符引用。
7参考视频列表。至多 1 段。
两种用途(由 refer_type 区分):
base(默认)— 待编辑视频,对原视频直接重绘/编辑;此模式下不能再通过reference_images指定first_frame/last_frame;feature— 特征参考视频,仅提取运动/风格等特征辅助生成。
通过 keep_original_sound 选择是否保留原视频音轨——该参数对 feature 同样生效。
传入参考视频时,
generate_audio将被强制视为false(不会额外生成音频)。
视频要求:
- 格式:
MP4/MOV; - 大小 ≤ 200 MB;
- 时长 ≥ 3s(上限随模型版本而定);
- 宽高尺寸:720px ~ 2160px(含);
- 帧率:
24 ~ 60 fps(输出统一为 24 fps); - 仅支持公网可访问 URL,不支持 base64。
1可灵官方扩展参数,全部选填。

