跳转到主要内容
POST
/
kling
/
v1
/
videos
/
omni-video
创建视频任务
curl --request POST \
  --url https://www.anyfast.ai/kling/v1/videos/omni-video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model_name": "kling-v3-omni",
  "prompt": "一只猫优雅地走过阳光洒满的花园",
  "mode": "pro",
  "aspect_ratio": "16:9",
  "duration": "5",
  "multi_shot": false,
  "shot_type": "customize",
  "multi_prompt": [
    {
      "index": 123,
      "prompt": "<string>",
      "duration": "<string>"
    }
  ],
  "image_list": [
    {
      "image_url": "<string>",
      "type": "first_frame"
    }
  ],
  "element_list": [
    {
      "element_id": 123
    }
  ],
  "video_list": [
    {
      "video_url": "<string>",
      "refer_type": "base",
      "keep_original_sound": "yes"
    }
  ],
  "sound": "off",
  "watermark_info": {
    "enabled": true
  },
  "callback_url": "<string>",
  "external_task_id": "<string>"
}
'
{
  "id": "860260753860210752",
  "task_id": "860260753860210752",
  "object": "video",
  "model": "kling-v3-omni",
  "status": "<string>",
  "progress": 0,
  "created_at": 1773130665
}

授权

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