跳轉到主要內容
POST
/
v1
/
tasks
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "hailuo-2.3",
    "action": "generate",
    "prompt": "一只白猫慵懒地躺在阳光下的窗台上",
    "duration": 6,
    "resolution": "1080p"
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "hailuo-2.3",
  "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": "hailuo-2.3",
    "action": "generate",
    "prompt": "一只白猫慵懒地躺在阳光下的窗台上",
    "duration": 6,
    "resolution": "1080p"
  }'

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

​
可用模型

模型 ID預設解析度支援時長說明
hailuo-2.3768P6s / 10s海螺 2.3，支援 4K、角色參考
hailuo-2.3-fast768P6s / 10s海螺 2.3 快速版
hailuo-02768P6s / 10s海螺 02，支援首尾幀
T2V-01-Director768P6s導演模式，支援鏡頭語法控制
I2V-01-Director720P6s圖生影片導演模式
S2V-01720P6s角色參考模式，保持角色一致性

​
統一參數

​
model
string
必填
模型 ID
​
action
string
預設值:"generate"
操作類型
​
prompt
string
必填
影片描述文字
​
duration
integer
預設值:"6"
影片時長（秒）：6、10
​
resolution
string
預設值:"768p"
輸出解析度，可選值取決於模型，見各模型 Tab
​
image_urls
string[]
首幀圖片 URL，用於圖生影片
​
last_frame
string
尾幀圖片 URL，需配合 image_urls。僅 hailuo-02 支援
​
callback_url
string
Webhook 回呼位址
​
extra
object
透傳給海螺的額外參數，詳見各模型 Tab

​
模型特定參數

resolution 可選值： 768p、1080p
​
extra.prompt_optimizer
boolean
預設值:"true"
是否啟用提示詞最佳化
​
extra.fast_pretreatment
boolean
快速預處理模式
​
extra.subject_reference
array
角色參考，保持角色一致性
"extra": {
  "subject_reference": [{
    "type": "character",
    "image": ["https://example.com/character.jpg"]
  }]
}

​
生成模式

模式參數支援模型
文生影片prompt全部
圖生影片prompt + image_urls(1張)全部
首尾幀image_urls(1張) + last_framehailuo-02
角色參考prompt + extra.subject_referencehailuo-2.3 系列

​
回應

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