Kling 3.0 - Vidgo API

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kling-3.0/standard",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "prompt": "A chef carefully plating a gourmet dish in a modern kitchen, steam rising from the food under warm lighting",
    "multi_shots": false,
    "duration": 5,
    "sound": true,
    "aspect_ratio": "16:9"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1757165031-uyujaw3d",
    "status": "not_started",
    "created_time": "2025-11-12T10:30:00"
  }
}

POST

api

generate

submit

curl --request POST \
  --url https://api.vidgo.ai/api/generate/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "kling-3.0/standard",
  "callback_url": "https://your-domain.com/callback",
  "input": {
    "prompt": "A chef carefully plating a gourmet dish in a modern kitchen, steam rising from the food under warm lighting",
    "multi_shots": false,
    "duration": 5,
    "sound": true,
    "aspect_ratio": "16:9"
  }
}
'

{
  "code": 200,
  "data": {
    "task_id": "task-unified-1757165031-uyujaw3d",
    "status": "not_started",
    "created_time": "2025-11-12T10:30:00"
  }
}

提交后会返回 task_id。如果提供了 callback_url，当任务状态变为 finished 或 failed 时，系统会向 callback_url 发送 POST 请求。
无论是否提供 callback_url，都可以通过统一的查询任务状态接口获取结果。

模型

kling-3.0/standard - 高清分辨率（约 720p/1K）
kling-3.0/pro - 全高清分辨率（1080p/2K），输出更清晰、细节更丰富

功能

原生音频：由 input.sound 控制。设为 true 启用音效，设为 false 关闭。multi_shots 为 true 时，sound 必须为 true
灵活时长：3 到 15 秒
宽高比：1:1（方形）、16:9（横屏）和 9:16（竖屏）
模式：文生视频和图生视频（首帧和尾帧）
多镜头：多镜头叙事，可为每个镜头单独设置提示词和时长
元素引用：定义可复用的元素（通过图像或视频），并在提示词中用 @element_name 语法引用。使用元素引用时 image_urls 为必填

工作流程 ID

现有 ID 仍可继续使用。新接入可以选择专用的工作流程：

授权

Authorization

string

header

必填

所有 API 接口都需要 Bearer Token 认证

获取 API Key：

进入仪表盘 → API 密钥（API Key 管理页面）获取 API Key

在请求头中添加：

Authorization: Bearer VIDGO_API_KEY

请求体

application/json

model

string

必填

示例:

"kling-3.0/standard"

callback_url

string<uri>

接收结果通知的 Webhook 回调 URL

示例:

"https://your-domain.com/callback"

input

object

生成参数

Show child attributes

响应

200 - application/json

任务提交成功

code

integer

必填

HTTP 状态码

示例:

200

data

object

必填

Show child attributes

​模型

​功能

​工作流程 ID

授权

请求体

响应

模型

功能

工作流程 ID