Skip to main content
POST
创建视频任务

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
model_name
enum<string>

模型名称

可用选项:
kling-v3-omni
示例:

"kling-v3-omni"

prompt
string

文本提示词,支持正向和负向描述。使用 <<<element_1>>>、<<<image_1>>>、<<<video_1>>> 引用元素/图片/视频。multi_shot 为 false 时必填。

Maximum string length: 2500
示例:

"一只猫优雅地走过阳光洒满的花园"

mode
enum<string>
默认值:pro

视频生成模式。std:标准模式(性价比高)。pro:专业模式(画质更好)。

可用选项:
std,
pro
示例:

"pro"

aspect_ratio
enum<string>

生成视频的画面比例(宽:高)。未使用首帧参考或视频编辑时必填。

可用选项:
16:9,
9:16,
1:1
示例:

"16:9"

duration
enum<string>
默认值:5

视频时长(秒),3–15 秒。

可用选项:
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
示例:

"5"

multi_shot
boolean
默认值:false

是否生成多镜头视频。为 true 时 prompt 参数无效,需使用 multi_prompt。

shot_type
enum<string>

分镜方式。multi_shot 为 true 时必填。

可用选项:
customize
multi_prompt
object[]

各分镜信息(1–6 个分镜)。multi_shot 为 true 且 shot_type 为 customize 时必填。

image_list
object[]

参考图片列表,支持首帧/尾帧、场景、风格参考。格式 .jpg/.jpeg/.png,≤10MB,最小 300px,宽高比 1:2.5–2.5:1。

element_list
object[]

参考元素列表,基于可灵元素库中的元素 ID。

video_list
object[]

参考视频列表。仅支持 MP4/MOV,≥3 秒,720px–2160px,24–60fps,≤200MB。

sound
enum<string>
默认值:off

是否在生成视频时同步生成音效。有参考视频时只能为 off。

可用选项:
on,
off
watermark_info
object

水印配置

callback_url
string

任务状态变更的回调通知 URL

external_task_id
string

自定义任务 ID,同一账号下需唯一。

响应

任务创建成功

id
string

任务 ID

示例:

"860260753860210752"

task_id
string

任务 ID

示例:

"860260753860210752"

object
string
示例:

"video"

model
string
示例:

"kling-v3-omni"

status
string

任务状态

progress
integer

进度百分比

示例:

0

created_at
integer

Unix 时间戳

示例:

1773130665