Omni-Video

创建任务

POST/v1/videos/omni-video

cURL

curl --request POST \
  --url https://api-beijing.klingai.com/v1/videos/omni-video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model_name": "kling-video-o1",
  "prompt": "让<<<image_1>>>中的人物向镜头挥手",
  "image_list": [ \
    { \
      "image_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png" \
    } \
  ],
  "duration": "5",
  "mode": "pro",
  "aspect_ratio": "16:9",
  "callback_url": "",
  "external_task_id": ""
}'

200

{
  "code": 0, // 错误码；具体定义见错误码
  "message": "string", // 错误信息
  "request_id": "string", // 请求ID，系统生成，用于跟踪请求、排查问题
  "data": {
    "task_id": "string", // 任务ID，系统生成
    "task_info": { //任务创建时的参数信息
      "external_task_id": "string" //客户自定义任务ID
    },
    "task_status": "string", // 任务状态，枚举值：submitted（已提交）、processing（处理中）、succeed（成功）、failed（失败）
    "created_at": 1722769557708, // 任务创建时间，Unix时间戳、单位ms
    "updated_at": 1722769557708 //任务更新时间，Unix时间戳、单位ms
  }
}

Omni 模型可以通过 Prompt 结合元素、图片、视频等内容实现多种能力。

请求头

Content-Typestring必填默认值 application/json

数据交换格式

Authorizationstring必填

鉴权信息，参考接口鉴权

请求体

model_namestring可选默认值 kling-video-o1

模型名称

枚举值：kling-video-o1kling-v3-omni

multi_shotboolean可选默认值 false

是否生成多镜头视频。

当前参数为 true 时，prompt 参数无效，且不支持设定首尾帧生视频。当前参数为 false 时，shot_type 参数及 multi_prompt 参数无效。

shot_typestring可选

分镜方式。

枚举值：customizeintelligence

当 multi_shot 参数为 true 时，当前参数必填。

promptstring可选

文本提示词，可包含正向描述和负向描述。

  • 可将提示词模板化来满足不同的视频生成需求
  • 不能超过 2,500 个字符

当 "multi_shot 为 false "或" multi_shot参数为true且shot-type参数为intelligence"时，当前参数不得为空

Omni模型可通过Prompt与主体、图片、视频等内容实现多种能力：

不同模型版本、视频模式支持范围不同，详见 能力地图

请求范例

curl --location 'https://api-beijing.klingai.com/v1/videos/omni-video' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model_name": "kling-video-o1",
    "prompt": "让<<<image_1>>>中的人物向镜头挥手",
    "image_list": [ \
        { \
         "image_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-1.png" \
        }
    ],
    "duration": "5",
    "mode": "pro",
    "aspect_ratio": "16:9"
}'

FAQ

1、生成视频时长（duration）什么情况支持、什么情况不支持？

  • 文生，图生（不含首尾帧）：可选3~10s
  • 有视频输入（video_list不为空）且 使用视频编辑功能（类型=base）时：不可指定时长，跟视频对齐
  • 其他情况（不传视频+传图片+主体进行生视频，或者 传视频+视频类型=feature时），可选3-10s

2、怎么进行视频延长？

  • 可以通过"视频参考"来实现，传入一段视频，通过prompt驱动模型"生成下一个镜头"或者"生成上一个镜头"

3、生成视频宽高比（aspect_ratio）什么情况支持、什么情况不支持？

  • 不支持：指令变换（视频编辑），图生视频（包括首尾帧）
  • 支持：文生视频，图片/主体参考，视频参考-其他，视频参考-生成下一个/上一个镜头