跳轉到主要內容
POST
/
v1
/
tasks
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq3",
    "action": "generate",
    "prompt": "城市夜景延时摄影，霓虹灯光流转",
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "1080p"
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "viduq3",
  "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": "viduq3",
    "action": "generate",
    "prompt": "城市夜景延时摄影，霓虹灯光流转",
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "1080p"
  }'

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

​
可用模型

模型 ID說明
viduq3Vidu Q3，原生音訊、16 秒、1080p
viduq3-proVidu Q3 Pro，最高畫質
viduq3-turboVidu Q3 Turbo，速度優先
viduq3-mixVidu Q3 Mix，多參考圖多實體一致性
viduq2Vidu Q2
viduq1Vidu Q1

​
統一參數

​
model
string
必填
模型 ID
​
action
string
預設值:"generate"
操作類型
​
prompt
string
必填
影片描述文字
​
aspect_ratio
string
預設值:"16:9"
寬高比：16:9、9:16、1:1
​
duration
integer
預設值:"5"
影片時長（秒）
​
resolution
string
預設值:"1080p"
解析度：720p、1080p
​
seed
integer
隨機種子，0 為隨機
​
watermark
boolean
是否新增浮水印。支援自訂浮水印圖片和位置（透過 extra）
​
image_urls
string[]
參考圖片 URL 陣列，數量決定生成模式：
  • 1 張 → 圖生影片
  • 2 張 → 首尾幀模式
  • 3+ 張 → 參考圖引導（自動使用 viduq2）
​
callback_url
string
Webhook 回呼位址
​
extra
object
透傳參數

​
模型特定參數

​
extra.movement_amplitude
string
預設值:"auto"
運動幅度：auto、small、medium、large
​
extra.bgm
boolean
預設值:"false"
是否新增背景音樂
​
extra.wm_url
string
自訂浮水印圖片 URL（需 watermark: true）
​
extra.wm_position
integer
浮水印位置：1（左上）、2（右上）、3（左下）、4（右下）

​
生成模式

模式參數說明
文生影片prompt純文字生成
圖生影片prompt + image_urls(1張)單圖參考
首尾幀image_urls(2張)起止畫面過渡
參考圖引導image_urls(3+張)多圖參考（自動切換為 viduq2）

​
回應

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