{
"task_id": "task_2042864638838083584",
"model": "kling/kling-v3-omni",
"created_at": "2026-04-13T07:17:39.146Z",
"request_id": "291a4117-9df8-4349-aee1-bdf8ffcacb9a"
}{
"error": {
"code": "INVALID_PARAMETER",
"message": "reference_videos only supports at most 1 entry",
"status": 400,
"request_id": "req_abc123"
}
}Kling v3 Omni
可灵 3.0-Omni 视频生成模型，支持 asset 参考视频和 edit_source 视频编辑，两种视频输入均可附带最多 4 张 asset 参考图片
{
"task_id": "task_2042864638838083584",
"model": "kling/kling-v3-omni",
"created_at": "2026-04-13T07:17:39.146Z",
"request_id": "291a4117-9df8-4349-aee1-bdf8ffcacb9a"
}{
"error": {
"code": "INVALID_PARAMETER",
"message": "reference_videos only supports at most 1 entry",
"status": 400,
"request_id": "req_abc123"
}
}授权
在请求 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[].reference_type=edit_source）时，本参数无效——输出时长与输入视频一致，按输入视频时长四舍五入取整计费。
3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 是否生成声音，默认 false。
支持 asset 参考图片、first_frame 首帧、last_frame 尾帧。无视频时最多 7 张 asset 图片；有视频时可附带 0~4 张 asset 图片。当前接口不开放 first_frame / last_frame 与视频组合。
图片要求：
- 格式：
jpg/jpeg/png； - 大小 ≤ 10 MB；
- 宽高尺寸 ≥ 300px，宽高比介于
1:2.5 ~ 2.5:1之间。
7Show child attributes
Show child attributes
最多 1 段视频。asset（默认）用于参考生成，edit_source 用于编辑原视频。两种模式均可附带 0~4 张 reference_type=asset 的参考图片。
keep_original_sound 控制该素材的原音轨处理；省略时跟随模型默认。传入视频时 generate_audio 不生效。
视频要求：
- 格式：
MP4/MOV； - 大小 ≤ 200 MB；
- 时长 ≥ 3s（上限随模型版本而定）；
- 宽高尺寸：720px ~ 2160px（含）；
- 帧率：
24 ~ 60 fps（输出统一为 24 fps）； - 仅支持公网可访问 URL，不支持 base64。
1Show child attributes
Show child attributes
可灵官方扩展参数，全部选填。
Show child attributes
Show child attributes