跳轉到主要內容
POST
/
v1
/
tasks
curl -X POST https://qingbo.dev/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "action": "generate",
    "prompt": "一只柴犬穿宇航服在月球上行走，电影感光影",
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "1080p",
    "watermark": false,
    "extra": {
      "generate_audio": true
    }
  }'

{
  "task_id": "task-wave1775285160b950328499",
  "model": "seedance-2.0",
  "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": "seedance-2.0",
    "action": "generate",
    "prompt": "一只柴犬穿宇航服在月球上行走，电影感光影",
    "aspect_ratio": "16:9",
    "duration": 5,
    "resolution": "1080p",
    "watermark": false,
    "extra": {
      "generate_audio": true
    }
  }'

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

​
可用模型

模型 ID說明
seedance-2.0Seedance 2.0，支援原生音訊、首尾幀、多模態參考、最高 2K
seedance-2.0-fastSeedance 2.0 快速版
seedance-1.5-proSeedance 1.5 專業版
seedance-1.0-pro-fastSeedance 1.0 快速版
seedance-1.0-pro-qualitySeedance 1.0 高畫質版

​
統一參數

​
model
string
必填
模型 ID
​
action
string
預設值:"generate"
操作類型
​
prompt
string
必填
影片描述文字，支援中英文。2.0 支援在 prompt 中用 @image1、@video1、@audio1 引用參考素材
​
aspect_ratio
string
預設值:"16:9"
寬高比：16:9、9:16、4:3、3:4、21:9、1:1
​
duration
integer
預設值:"5"
影片時長（秒），可選範圍取決於模型，見各模型 Tab
​
resolution
string
輸出解析度，可選值取決於模型，見各模型 Tab
​
image_urls
string[]
參考圖片 URL 陣列，數量限制取決於模型版本
​
first_frame
string
首幀圖片 URL
​
last_frame
string
尾幀圖片 URL（需配合 first_frame）
​
seed
integer
預設值:"-1"
隨機種子，範圍 [-1, 2^32-1]。-1 為隨機。相同種子 + 相同請求可獲得相似結果
​
watermark
boolean
預設值:"false"
是否新增浮水印
​
callback_url
string
Webhook 回呼位址
​
extra
object
透傳給上游的額外參數，詳見各模型 Tab

​
模型特定參數

duration 範圍： 4-15 秒resolution 可選值： 480p、720p、1080p、2Ksize 額外支援： adaptive（自適應，匹配輸入素材寬高比）輸入限制： 圖片最多 9 張（≤ 30MB）、影片最多 3 個（≤ 50MB，總時長 ≤ 15s）、音訊最多 3 個（MP3/WAV，≤ 15MB，總時長 ≤ 15s）
​
extra.generate_audio
boolean
預設值:"false"
原生音訊影片聯合生成，支援對白口型同步（8+ 語言）
​
extra.return_last_frame
boolean
預設值:"false"
回傳末幀圖片 URL，便於影片片段銜接續拍
​
extra.tools
array
模型工具，支援聯網搜尋
"extra": { "tools": [{"type": "web_search"}] }
​
extra.service_tier
string
服務等級，控制延遲與成本的平衡
2.0 使用首尾幀模式（first_frame + last_frame）時，不能同時傳 video_urls 和 audio_urls。

​
生成模式

模式參數支援版本
文生影片prompt全部
圖生影片prompt + image_urls(1張) 或 first_frame全部
首尾幀first_frame + last_frame1.0-quality / 1.5 / 2.0
多模態參考image_urls + video_urls + audio_urls僅 2.0

​
回應

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