Omni-Video
POST
/kling/v1/videos/omni-video
网站中的模型与调用示例
Omni-Video
请求参数
{
"contentType": "application/json",
"properties": {
"aspect_ratio": {
"description": "画幅比例。未使用首帧且非视频编辑时建议必填。",
"enum": [
"16:9",
"9:16",
"1:1"
],
"type": "string",
"x-apifox-enum": [
{
"description": "",
"name": "横屏",
"value": "16:9"
},
{
"description": "",
"name": "竖屏",
"value": "9:16"
},
{
"description": "",
"name": "方屏",
"value": "1:1"
}
],
"x-i18n": {
"en-US": {
"description": "Aspect ratio. It is recommended that this field be required when the first frame is not used and is not used for video editing."
}
}
},
"callback_url": {
"description": "任务完成回调地址，须公网可达",
"format": "uri",
"type": "string",
"x-i18n": {
"en-US": {
"description": "Task completion callback address must be reachable by the public network"
}
}
},
"duration": {
"description": "视频时长（秒）。o1: 5/10；v3-omni: 3~15；refer_type=base 时由视频探测覆盖，可不传。",
"oneOf": [
{
"pattern": "^[0-9]+$",
"type": "string"
},
{
"minimum": 1,
"type": "integer"
}
],
"x-i18n": {
"en-US": {
"description": "Video duration (seconds). o1: 5/10; v3-omni: 3~15; when refer_type=base, it is covered by video detection and does not need to be transmitted."
}
}
},
"element_list": {
"description": "主体引用列表。",
"items": {
"additionalProperties": false,
"properties": {
"element_id": {
"description": "主体 ID，来自创建主体接口",
"oneOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "integer"
}
],
"x-i18n": {
"en-US": {
"description": "Principal ID, from create principal interface"
}
}
}
},
"required": [
"element_id"
],
"type": "object"
},
"type": "array",
"x-i18n": {
"en-US": {
"description": "List of subject references."
}
}
},
"external_task_id": {
"description": "调用方外部任务 ID，用于业务关联",
"type": "string",
"x-i18n": {
"en-US": {
"description": "Caller external task ID, used for business correlation"
}
}
},
"image_list": {
"description": "参考图列表。用于主体/场景/风格参考或首尾帧。",
"items": {
"additionalProperties": false,
"properties": {
"image_url": {
"description": "图片 URL 或 Base64",
"minLength": 1,
"type": "string",
"x-i18n": {
"en-US": {
"description": "Image URL or Base64"
}
}
},
"type": {
"description": "首尾帧类型。有 end_frame 必须有 first_frame。",
"enum": [
"first_frame",
"end_frame"
],
"type": "string",
"x-apifox-enum": [
{
"description": "视频起始帧",
"name": "首帧",
"value": "first_frame"
},
{
"description": "须与 first_frame 成对",
"name": "尾帧",
"value": "end_frame"
}
],
"x-i18n": {
"en-US": {
"description": "First and last frame type. There must be first_frame if there is end_frame."
}
}
}
},
"type": "object"
},
"type": "array",
"x-i18n": {
"en-US": {
"description": "Reference figure list. Used for subject/scene/style reference or first and last frames."
}
}
},
"mode": {
"default": "pro",
"description": "生成模式。缺省网关补 pro；4k 仅 kling-v3-omni。",
"enum": [
"std",
"pro",
"4k"
],
"type": "string",
"x-apifox-enum": [
{
"description": "",
"name": "标准",
"value": "std"
},
{
"description": "网关缺省值",
"name": "高品质",
"value": "pro"
},
{
"description": "仅 kling-v3-omni",
"name": "4K",
"value": "4k"
}
],
"x-i18n": {
"en-US": {
"description": "Generate schema. The default gateway is pro; 4k only kling-v3-omni."
}
}
},
"model_name": {
"description": "Omni 模型名称，必填。o1 不支持 sound/4k/multi_shot；v3-omni 全功能。",
"enum": [
"kling-video-o1",
"kling-v3-omni"
],
"type": "string",
"x-apifox-enum": [
{
"description": "标准 Omni，duration 仅 5/10 秒",
"name": "Video O1",
"value": "kling-video-o1"
},
{
"description": "支持 sound、4k、multi_shot，duration 3~15 秒",
"name": "V3 Omni",
"value": "kling-v3-omni"
}
],
"x-i18n": {
"en-US": {
"description": "Omni model name, required. o1 does not support sound/4k/multi_shot; v3-omni is fully functional."
}
}
},
"multi_prompt": {
"description": "自定义分镜列表。shot_type=customize 时必填，最多 6 镜。",
"items": {
"additionalProperties": false,
"properties": {
"duration": {
"description": "该分镜时长（秒），≥1",
"oneOf": [
{
"pattern": "^[0-9]+(\\.[0-9]+)?$",
"type": "string"
},
{
"minimum": 1,
"type": "number"
},
{
"minimum": 1,
"type": "integer"
}
],
"x-i18n": {
"en-US": {
"description": "The duration of the storyboard (seconds), ≥1"
}
}
},
"index": {
"description": "分镜序号，从 1 起",
"minimum": 1,
"type": "integer",
"x-i18n": {
"en-US": {
"description": "Storyboard number, starting from 1"
}
}
},
"prompt": {
"description": "该分镜提示词，≤512 字符",
"maxLength": 512,
"minLength": 1,
"type": "string",
"x-i18n": {
"en-US": {
"description": "The storyboard prompt word, ≤512 characters"
}
}
}
},
"required": [
"index",
"prompt",
"duration"
],
"type": "object"
},
"maxItems": 6,
"type": "array",
"x-i18n": {
"en-US": {
"description": "Customized storyboard list. Required when shot_type=customize, up to 6 shots."
}
}
},
"multi_shot": {
"default": false,
"description": "是否多镜头，默认 false。仅 kling-v3-omni 可为 true。",
"type": "boolean",
"x-i18n": {
"en-US": {
"description": "Whether to use multiple lenses, default false. Only kling-v3-omni can be true."
}
}
},
"prompt": {
"description": "文本提示词，≤2500 字符。multi_shot=false 时必填；multi_shot=true 时无效。",
"maxLength": 2500,
"type": "string",
"x-i18n": {
"en-US": {
"description": "Text prompt word, ≤2500 characters. Required when multi_shot=false; invalid when multi_shot=true."
}
}
},
"shot_type": {
"description": "分镜方式。multi_shot=true 时必填；customize 须配合 multi_prompt。",
"enum": [
"customize"
],
"type": "string",
"x-apifox-enum": [
{
"description": "须传 multi_prompt，各镜 duration 之和等于顶层 duration",
"name": "自定义分镜",
"value": "customize"
}
],
"x-i18n": {
"en-US": {
"description": "Storyboarding method. Required when multi_shot=true; customize must match multi_prompt."
}
}
},
"sound": {
"description": "有声开关。on 仅 kling-v3-omni；o1 传 on 会 400。",
"enum": [
"on",
"off"
],
"type": "string",
"x-apifox-enum": [
{
"description": "仅 v3-omni",
"name": "开启有声",
"value": "on"
},
{
"description": "默认无声",
"name": "关闭有声",
"value": "off"
}
],
"x-i18n": {
"en-US": {
"description": "Audible switch. on only kling-v3-omni; passing on from o1 will result in 400."
}
}
},
"video_list": {
"description": "参考视频列表，最多 1 条。",
"items": {
"additionalProperties": false,
"properties": {
"keep_original_sound": {
"description": "是否保留视频原声",
"enum": [
"yes",
"no"
],
"type": "string",
"x-apifox-enum": [
{
"description": "",
"name": "保留",
"value": "yes"
},
{
"description": "",
"name": "不保留",
"value": "no"
}
],
"x-i18n": {
"en-US": {
"description": "Whether to keep the original sound of the video"
}
}
},
"refer_type": {
"description": "feature=特征参考；base=视频编辑（duration 由视频探测决定）。",
"enum": [
"feature",
"base"
],
"type": "string",
"x-apifox-enum": [
{
"description": "不可与 sound=on 同用（v3-omni）",
"name": "特征参考",
"value": "feature"
},
{
"description": "duration 无效，由视频时长覆盖",
"name": "待编辑",
"value": "base"
}
],
"x-i18n": {
"en-US": {
"description": "feature=feature reference; base=video editing (duration is determined by video detection)."
}
}
},
"video_url": {
"description": "参考视频 URL，须公网可访问",
"minLength": 1,
"type": "string",
"x-i18n": {
"en-US": {
"description": "Reference video URL, accessible from the public network"
}
}
}
},
"required": [
"video_url",
"refer_type"
],
"type": "object"
},
"maxItems": 1,
"type": "array",
"x-i18n": {
"en-US": {
"description": "Reference video list, maximum 1."
}
}
},
"watermark_info": {
"additionalProperties": false,
"description": "水印配置，网关透传",
"properties": {
"enabled": {
"description": "true 生成含水印结果",
"type": "boolean",
"x-i18n": {
"en-US": {
"description": "true generates watermarked results"
}
}
}
},
"type": "object",
"x-i18n": {
"en-US": {
"description": "Watermark configuration, gateway transparent transmission"
}
}
}
},
"required": [
"model_name"
]
}请求示例 · 新手推荐：Omni 文生视频 · 最小可用提交通路（o1）
{
"aspect_ratio": "16:9",
"duration": "5",
"mode": "pro",
"model_name": "kling-video-o1",
"multi_shot": false,
"prompt": "A cinematic aerial shot over a misty mountain lake at sunrise"
}请求示例 · 新手推荐：Omni 垫图生视频 · image_list
{
"aspect_ratio": "16:9",
"duration": "5",
"image_list": [
{
"image_url": "{{image_url_1}}"
},
{
"image_url": "{{image_url_2}}"
}
],
"mode": "pro",
"model_name": "kling-video-o1",
"multi_shot": false,
"prompt": "The character walks through a neon alley, cyberpunk style"
}请求示例 · 新手推荐：Omni 首尾帧 · first_frame + end_frame
{
"duration": "5",
"image_list": [
{
"image_url": "{{first_frame_url}}",
"type": "first_frame"
},
{
"image_url": "{{end_frame_url}}",
"type": "end_frame"
}
],
"mode": "pro",
"model_name": "kling-video-o1",
"multi_shot": false,
"prompt": "Smooth transition from day to night over the same street"
}请求示例 · 新手推荐：Omni V3 有声 · sound=on
{
"aspect_ratio": "16:9",
"duration": 8,
"mode": "pro",
"model_name": "kling-v3-omni",
"multi_shot": false,
"prompt": "A jazz band performs on a rainy street corner",
"sound": "on"
}请求示例 · 进阶推荐：Omni 视频编辑 · refer_type=base
{
"mode": "pro",
"model_name": "kling-v3-omni",
"multi_shot": false,
"prompt": "Replace the background with a futuristic city skyline",
"video_list": [
{
"keep_original_sound": "no",
"refer_type": "base",
"video_url": "{{video_url}}"
}
]
}请求示例 · 进阶推荐：Omni 视频特征参考 · refer_type=feature
{
"aspect_ratio": "16:9",
"duration": "10",
"mode": "pro",
"model_name": "kling-video-o1",
"multi_shot": false,
"prompt": "A dancer mimics the motion style of the reference video",
"video_list": [
{
"keep_original_sound": "yes",
"refer_type": "feature",
"video_url": "{{ref_video_url}}"
}
]
}请求示例 · 进阶推荐：Omni 主体引用 · element_list
{
"aspect_ratio": "1:1",
"duration": 6,
"element_list": [
{
"element_id": "{{element_id}}"
}
],
"mode": "pro",
"model_name": "kling-v3-omni",
"multi_shot": false,
"prompt": "The subject walks into a sunlit studio and waves at camera"
}请求示例 · 进阶推荐：Omni V3 多镜头 customize
{
"aspect_ratio": "16:9",
"mode": "pro",
"model_name": "kling-v3-omni",
"multi_prompt": [
{
"duration": 3,
"index": 1,
"prompt": "Wide shot of an empty train platform"
},
{
"duration": 4,
"index": 2,
"prompt": "Train arrives, doors open, passengers exit"
},
{
"duration": 3,
"index": 3,
"prompt": "Close-up on a ticket fluttering in the wind"
}
],
"multi_shot": true,
"shot_type": "customize"
}请求示例 · 进阶推荐：Omni 回调与 external_task_id
{
"aspect_ratio": "9:16",
"callback_url": "{{callback_url}}",
"duration": 5,
"external_task_id": "{{external_task_id}}",
"mode": "pro",
"model_name": "kling-v3-omni",
"multi_shot": false,
"prompt": "Product showcase rotating on a clean white pedestal"
}请求参数
Header 参数
Body 参数application/json必填
请求示例代码
返回响应
修改于 2026-10-24 18:33:09