Documentation

Omni 生视频

Last updated: Nov 4, 2026

POST
/v3/aigc/kl/videos/omni-video

kling-v3-omni 全能生视频,支持文本、参考图、首尾帧、主体、参考视频 / 视频编辑组合。提示词中用 <<<element_1>>>、<<<image_1>>>、<<<video_1>>> 引用素材。

使用 TE 北京地域 API Key 鉴权。模型能力、调用约定见 Kling 接口概览。

Authorization

BearerAuth
headerAuthorizationBearer <token>

TE 北京地域 API Key,填写后自动添加 Bearer 前缀。

Request Body

application/json
  1. body
model_name?string

kling-v3-omni

prompt?string

≤ 2500 字符;multi_shot 为 false 时必填

multi_shot?boolean

是否多镜头,默认 false;true 时 prompt 无效

shot_type?string

分镜方式,multi_shot 为 true 时必填

multi_prompt?array<>

分镜 [{index, prompt, duration}],1~6 个,单个 ≤ 512 字符,时长之和等于总时长

image_list?array<>

参考图 [{image_url, type}];type 为 first_frame / end_frame 作首尾帧,不支持仅尾帧;有参考视频时 ≤ 4 张,否则 ≤ 7 张

element_list?array<>

主体 [{element_id}];首帧 / 首尾帧时 ≤ 3 个;有参考视频时图片 + 主体 ≤ 4 且不支持视频角色主体,否则 ≤ 7

video_list?array<>

参考视频 [{video_url, refer_type, keep_original_sound}];refer_type:feature 特征参考 / base 待编辑(默认);MP4/MOV,≥ 3s,宽高 720~2160px,最多 1 段,≤ 200MB;有视频时 sound 只能为 off

sound?string

on / off(默认);仅 V2.6 及后续模型

mode?string

std(标准)、pro(高品质)、4k(同 pro,输出 4K),默认 pro

aspect_ratio?string

16:9、9:16、1:1;未使用首帧参考或视频编辑时必填

duration?string

3~15,默认 5;视频编辑时与输入视频等长

watermark_info?

{"enabled": true} 同时生成含水印结果;不支持自定义水印

Response Body

成功;具体状态及结果见响应字段。

application/json
  1. response
taskId?string

任务 ID

requestId?string

请求 ID,用于排查

code?string

错误码,异常时返回

message?string

错误信息,异常时返回

Example Request
curl -X POST 'https://vod.bj.baidubce.com/v3/aigc/kl/videos/omni-video' \  -H 'Content-Type: application/json' \  -d '{  "model_name": "kling-v3-omni",  "prompt": "男人在<<<element_1>>>向前奔跑,说,今天天气不错",  "sound": "on",  "element_list": [    {      "element_id": 171    }  ],  "watermark_info": {    "enabled": true  },  "mode": "std",  "aspect_ratio": "1:1",  "duration": "3"}'
Example Response200
{  "taskId": "tsk-xxxxxxxxxxxxxxxx",  "requestId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"}