跳轉到主要內容
POST
/
v1
/
tasks
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v2-master",
    "action": "generate",
    "prompt": "一条锦鲤在清澈的池塘中游动，水面波光粼粼",
    "aspect_ratio": "16:9",
    "duration": 5,
    "extra": {
      "mode": "pro"
    }
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "kling-v2-master",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}
非同步處理模式 — 提交請求後回傳任務 ID，透過 查詢任務狀態 介面取得生成結果。影片連結有效期 24 小時。 
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "kling-v2-master",
    "action": "generate",
    "prompt": "一条锦鲤在清澈的池塘中游动，水面波光粼粼",
    "aspect_ratio": "16:9",
    "duration": 5,
    "extra": {
      "mode": "pro"
    }
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "kling-v2-master",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

​
可用模型

模型 ID說明
kling-v3可靈 V3，支援 3-15 秒、多鏡頭、原生音訊
kling-v2-master可靈 V2 Master
kling-v1-6可靈 V1.6，支援鏡頭控制
kling-v1可靈 V1

​
統一參數

​
model
string
必填
模型 ID
​
action
string
預設值:"generate"
操作類型
​
prompt
string
必填
影片描述文字，最多 2500 字元
​
aspect_ratio
string
預設值:"16:9"
寬高比：16:9、9:16、1:1圖生影片時忽略此參數，寬高比由輸入圖片決定
​
duration
integer
預設值:"5"
影片時長（秒）：5、10
​
negative_prompt
string
不希望出現的內容，最多 2500 字元。僅 V1 / V1.6 支援
​
image_urls
string[]
參考圖片 URL（首幀），用於圖生影片。JPEG/PNG/WebP，≤ 10MB
​
last_frame
string
尾幀圖片 URL，需配合 image_urls 使用
​
callback_url
string
Webhook 回呼位址
​
extra
object
透傳給可靈的額外參數，詳見各模型 Tab

​
模型特定參數

duration 範圍： 3-15 秒
​
extra.mode
string
預設值:"std"
生成模式：std（720P）或 pro（1080P）
​
extra.enable_audio
boolean
預設值:"true"
原生音訊生成，預設開啟
多鏡頭模式：支援 2-6 個鏡頭分段生成，使用 shot_N_prompt + shot_N_duration 替代 prompt + duration：
"extra": {
  "shot_1_prompt": "特写：一杯咖啡在桌上冒着热气",
  "shot_1_duration": 5,
  "shot_2_prompt": "镜头拉远，展示整个咖啡馆的场景",
  "shot_2_duration": 5
}
各鏡頭 duration 總和須在 3-15 秒範圍內。

​
生成模式

模式參數說明
文生影片prompt純文字生成
圖生影片prompt + image_urls(1張)首幀圖 + 文字描述
首尾幀image_urls(1張) + last_frame起止畫面過渡
圖生影片時 aspect_ratio 由輸入圖片決定，無需指定。

​
回應

​
task_id
string
任務 ID
​
model
string
使用的模型 ID
​
action
string
操作類型
​
status
string
任務狀態：queued
​
created_at
integer
建立時間（Unix 毫秒時間戳）
​
progress
integer
進度，初始為 0