Kling 3.0 Pro 文生视频

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kwaivgi/kling-v3.0-pro/text-to-video",
  "input": {
    "duration": 3,
    "multi_shots": false,
    "prompt": "A quiet forest under soft morning light, with natural detail.",
    "sound": true
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-example",
    "status": "running",
    "created_time": "2026-09-10T08:00:00"
  }
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

Request timeout

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

{
  "detail": "<string>"
}

使用 Kling 3.0 Pro 编排视频序列，通过分镜提示词、镜头时长和可选声音塑造场景。

​

模型

• kwaivgi/kling-v3.0-pro/text-to-video - 根据文本提示词生成视频场景。

​

功能

• 根据文本提示词生成视频场景。
• 用 multi_prompt 描述各个镜头，并启用 multi_shots。

​

时长选项

• 3-15 秒 - duration 设为整数。必填。
• 使用 multi_prompt 时，各镜头时长之和必须等于请求的 duration。

​

高级参数

model 和可选的 callback_url 放在请求根级。所有工作流程参数（包括输出选项）都放在 input 中。 使用下面列出的 input 字段。时长以 JSON 整数发送，开关以 JSON 布尔值发送。

• 每个 multi_prompt 镜头都需要非空的 prompt 和 1 到 12 秒的整数 duration。
• 各镜头时长之和必须等于请求的 duration。使用 multi_prompt 时设置 multi_shots: true 和 sound: true。

​

提示词

• prompt：multi_shots 为 false 时必填。描述场景和期望的动作。长度：1-2,500 个字符。
• 每个提示词都需使用非空文本。

​

多镜头提示词

• multi_prompt：multi_shots 为 true 时必填。提供非空数组，每一项都是对象。
• multi_prompt[].prompt：必填。最大长度：2,500 个字符。
• multi_prompt[].duration：必填。时长（秒），1 到 12 的整数。
• 每个镜头的时长以秒为单位。

​

多镜头生成

• multi_shots：可选。启用多镜头生成。使用 true 或 false。默认值：false。

​

声音

• sound：可选。设为 true 生成音频，设为 false 生成无声的单镜头。多镜头必须为 true。默认值：true。

​

宽高比

• aspect_ratio：可选。可选值：1:1、16:9、9:16。默认值：1:1。