可灵 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 组合决定):
first_frame;first_frame + 1 张 last_frame(暂不支持仅尾帧——传入 last_frame 时必须同时提供 first_frame);asset(非首尾帧的素材可省略 reference_type,默认即为 asset)。与 reference_videos 的组合规则:
reference_videos[].refer_type=base(待编辑视频)时,reference_images 不可使用 first_frame / last_frame,仅支持 asset;asset 类型可与 reference_videos 共存。图片要求:
jpg / jpeg / png;1:2.5 ~ 2.5:1 之间。数量上限("参考图 + 多图主体" 总数):
参考视频列表。至多 1 段。
两种用途(由 refer_type 区分):
base(默认)— 待编辑视频,对原视频直接重绘/编辑;此模式下不能再通过 reference_images 指定 first_frame / last_frame;feature — 特征参考视频,仅提取运动/风格等特征辅助生成。通过 keep_original_sound 选择是否保留原视频音轨——该参数对 feature 同样生效。
传入参考视频时,
generate_audio将被强制视为false(不会额外生成音频)。
视频要求:
MP4 / MOV;24 ~ 60 fps(输出统一为 24 fps);1可灵官方扩展参数,全部选填。