Omni-Video

POSThttps://www.aipro2.com/kling/v1/videos/omni-video

可灵 Omni 统一视频生成入口，支持文生视频、垫图、首尾帧、视频编辑、主体引用与多镜头分镜。

Header 参数

• Content-Typestring
  请求体 Content-Type，一般为 application/json

  示例application/json
• Authorizationstring
  Bearer API Key

  示例Bearer {{YOUR_API_KEY}}

请求体参数

application/json

• aspect_ratiostring
  画幅比例。未使用首帧且非视频编辑时建议必填。

  可选值16:99:161:1
• callback_urlstring
  任务完成回调地址，须公网可达
• durationoneOf
  视频时长（秒）。o1: 5/10；v3-omni: 3~15；refer_type=base 时由视频探测覆盖，可不传。
• element_listarray<object>
  主体引用列表。
• external_task_idstring
  调用方外部任务 ID，用于业务关联
• image_listarray<object>
  参考图列表。用于主体/场景/风格参考或首尾帧。
• modestring
  生成模式。缺省网关补 pro；4k 仅 kling-v3-omni。

  可选值stdpro4k

  默认值pro
• model_name*string
  Omni 模型名称，必填。o1 不支持 sound/4k/multi_shot；v3-omni 全功能。

  可选值kling-video-o1kling-v3-omni
• multi_promptarray<object>
  自定义分镜列表。shot_type=customize 时必填，最多 6 镜。
• multi_shotboolean
  是否多镜头，默认 false。仅 kling-v3-omni 可为 true。

  默认值false
• promptstring
  文本提示词，≤2500 字符。multi_shot=false 时必填；multi_shot=true 时无效。
• shot_typestring
  分镜方式。multi_shot=true 时必填；customize 须配合 multi_prompt。

  可选值customize
• soundstring
  有声开关。on 仅 kling-v3-omni；o1 传 on 会 400。

  可选值onoff
• video_listarray<object>
  参考视频列表，最多 1 条。
• watermark_infoobject
  水印配置，网关透传

响应

application/json

无响应结构说明

请求体示例新手推荐：Omni 文生视频 · 最小可用提交通路（o1）新手推荐：Omni 垫图生视频 · image_list新手推荐：Omni 首尾帧 · first_frame + end_frame新手推荐：Omni V3 有声 · sound=on进阶推荐：Omni 视频编辑 · refer_type=base进阶推荐：Omni 视频特征参考 · refer_type=feature进阶推荐：Omni 主体引用 · element_list进阶推荐：Omni V3 多镜头 customize进阶推荐：Omni 回调与 external_task_id

1{2  "aspect_ratio": "16:9",3  "duration": "5",4  "mode": "pro",5  "model_name": "kling-video-o1",6  "multi_shot": false,7  "prompt": "A cinematic aerial shot over a misty mountain lake at sunrise"8}

代码示例cURLPythonJavaScriptGoPHP

1curl -X POST "https://www.aipro2.com/kling/v1/videos/omni-video" \2  -H "Authorization: Bearer <API Key>" \3  -H "Content-Type: application/json" \4  -d '{5    "aspect_ratio": "16:9",6    "duration": "5",7    "mode": "pro",8    "model_name": "kling-video-o1",9    "multi_shot": false,10    "prompt": "A cinematic aerial shot over a misty mountain lake at sunrise"11  }'

响应示例 · 200example

1{2  "code": 0,3  "data": {4    "task_id": "task_example_001"5  },6  "message": "success"7}