Skip to main content
POST
创建视频任务

Authorizations

Authorization
string
header
required

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

Body

application/json
model_name
enum<string>

模型名称

Available options:
kling-v3-omni
Example:

"kling-v3-omni"

prompt
string

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

Maximum string length: 2500
Example:

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

mode
enum<string>
default:pro

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

Available options:
std,
pro
Example:

"pro"

aspect_ratio
enum<string>

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

Available options:
16:9,
9:16,
1:1
Example:

"16:9"

duration
enum<string>
default:5

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

Available options:
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15
Example:

"5"

multi_shot
boolean
default:false

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

shot_type
enum<string>

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

Available options:
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>
default:off

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

Available options:
on,
off
watermark_info
object

水印配置

callback_url
string

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

external_task_id
string

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

Response

任务创建成功

id
string

任务 ID

Example:

"860260753860210752"

task_id
string

任务 ID

Example:

"860260753860210752"

object
string
Example:

"video"

model
string
Example:

"kling-v3-omni"

status
string

任务状态

progress
integer

进度百分比

Example:

0

created_at
integer

Unix 时间戳

Example:

1773130665