跳轉到主要內容
POST
/
v1
/
tasks
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.5-t2v",
    "action": "generate",
    "prompt": "春天的樱花树下,花瓣随风飘落",
    "aspect_ratio": "16:9",
    "duration": 5
  }'
{
  "task_id": "task-wave1775285160b950328499",
  "model": "wan2.5-t2v",
  "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": "wan2.5-t2v",
    "action": "generate",
    "prompt": "春天的樱花树下,花瓣随风飘落",
    "aspect_ratio": "16:9",
    "duration": 5
  }'
{
  "task_id": "task-wave1775285160b950328499",
  "model": "wan2.5-t2v",
  "action": "generate",
  "status": "queued",
  "created_at": 1775285160040,
  "progress": 0
}

可用模型

模型 ID說明
wan2.5-t2v萬象 2.5 文生影片
wan2.5-i2v萬象 2.5 圖生影片
wan2.2-i2v-flash萬象 2.2 圖生影片快速版
wan2.2-i2v-plus萬象 2.2 圖生影片增強版

統一參數

model
string
必填
模型 ID
action
string
預設值:"generate"
操作類型
prompt
string
必填
影片描述文字
aspect_ratio
string
預設值:"16:9"
寬高比,後台自動對應為最佳解析度
duration
integer
預設值:"5"
影片時長(秒)
resolution
string
解析度:480p720p1080p
seed
integer
隨機種子,範圍 0-2147483647
watermark
boolean
預設值:"false"
是否新增浮水印
image_urls
string[]
參考圖片 URL(圖生影片模型使用)
first_frame
string
首幀圖片 URL
last_frame
string
尾幀圖片 URL
negative_prompt
string
不希望出現的內容,最多 500 字元
callback_url
string
Webhook 回呼位址
extra
object
透傳參數

模型特定參數

模型 ID:wan2.5-t2v
extra.prompt_extend
boolean
預設值:"true"
是否啟用提示詞最佳化擴展
extra.audio
boolean
預設值:"false"
是否生成音訊

生成模式

模式模型參數
文生影片wan2.5-t2vprompt
圖生影片wan2.5-i2v / wan2.2-i2v-*prompt + image_urls
首尾幀wan2.5-i2vfirst_frame + last_frame

回應

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