Seedance 2.5 API bytedance/seedance-2.5

接入前必讀

以下參數依據 MaxAPI 公開配置；所選路由可能另有輸入或權限要求。

請求模型 ID

bytedance/seedance-2.5

輸出類型

影片

Base URL

https://api.maxapi.dev

生成方式

非同步任務＋輪詢

品質參數

720p / 1080p / 480p

解析度與尺寸

720p / 1080p / 480p

影片長度

4 / 5 / 6 / 7 / 8 / 9 / 10 / 11 / 12 / 13 / 14 / 15 / 16 / 17 / 18 / 19 / 20 / 21 / 22 / 23 / 24 / 25 / 26 / 27 / 28 / 29 / 30 s

先選生成模式，再準備參考素材。圖片、影片與音訊各有不同用途，請依此模型 API 分頁的欄位與限制傳入。任務提交成功，不代表影片已生成完成。

模型特點與選型

資料核對 · 2026-10-29

此模型的資料來源: ByteDance · Seedance 2.5 · BytePlus · Seedance 2.x capability comparison

何時值得選擇它

當鏡頭需要起始、明確中段動作與結尾，而不只是極短動態測試時，可比較它。本站此入口目前列出 480p、720p、1080p 與 4–30 秒，交付規劃應以這份配置為準。

限制與注意事項

較新的版本號不代表此入口支援 4K、草稿模式、影片延長或官方所有編輯控制。長片段需從頭到尾檢查連續性，更多參考素材也不等於更好。

供應商能力描述的是模型本身，不等於 MaxAPI 已開通全部功能。本站接入以此入口列出的參數、輸入類型和路由為準；供應商的速度、品質定位不是服務保證。

MaxAPI 實際如何處理請求

路由與價格

公開路由：official-cheap、official。圖片／影片 JSON 請求可指定 route_mode；Gemini 原生請求使用 X-MaxAPI-Route-Mode。路由代表接入與計費選擇，不是另一個公開模型 ID。

1 積分 = 1 美元。此處為目錄基礎價格，並非帳戶即時報價；適用帳戶倍率。Seedance 依供應商回報的輸出 token 計費：token ≈（輸出秒數 + 參考影片秒數）× 寬 × 高 × 24 / 1024，720p 16:9 約每秒 21,600。只有請求包含至少一段參考影片時才適用「含參考影片」單價；參考圖、首尾幀與音訊按無參考影片計價。含參考影片時，供應商至少按「輸出秒數 + ⌈輸出秒數 × ⅔⌉」計費（影片輸入的最低用量）。提交時先預扣估算金額（含參考影片時另計最多 15 秒參考影片，Seedance 2.5 為 30 秒），完成後依回報的 token 結算並退回多扣部分；失敗任務不收費。

第一次呼叫

建立 MaxAPI API Key，並在服務端設定 MAXAPI_KEY，勿放入瀏覽器程式碼。Key 已設定的路由列表優先，即使請求另有指定；列表為空時才採用請求路由，都未指定則使用模型預設。API 呼叫可能產生費用。

• POST /api/v3/contents/generations/tasks (Volcengine Ark format)
• GET /api/v3/contents/generations/tasks/{id}

# The create call returns {"id":"task_..."}. Poll GET /api/v3/contents/generations/tasks/{id}.
curl -X POST "https://api.maxapi.dev/api/v3/contents/generations/tasks" \
  -H "Authorization: Bearer $MAXAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.5",
    "content": [{"type":"text","text":"a calm ocean wave at sunrise, slow camera pan"}],
    "ratio": "21:9",
    "duration": 4,
    "resolution": "720p",
    "generate_audio": true
  }'

第一次呼叫的驗收清單

請求合約核對 · 2026-10-29

依公開目錄與網關程式核對；範例只說明資料結構，不是付費模型實測、延遲測量，也不保證每條路由目前可用。

{
  "id": "example-task-id"
}

# Set TASK_ID to the saved response.id; this queries, it does not create a task.
curl --fail-with-body "https://api.maxapi.dev/api/v3/contents/generations/tasks/${TASK_ID:?Set TASK_ID from response.id}" \
  -H "Authorization: Bearer $MAXAPI_KEY"

先看現象，再判斷錯誤原因