Seedance 2.0 API 接入指南
先看結論 · Seedance 2.0 在 MaxAPI 影片生成 API 使用 bytedance/seedance-2.0。提交後保存任務 ID,並輪詢取得最終結果;受理不等於完成。可用素材、時長與解析度需依此模型項目和所選路由確認。
接入規則核對 ·
依 MaxAPI 公開目錄、網關實作與本地回歸案例核對。共用網關核驗不代表已逐個模型進行端到端測試。這是接入參考,不是上游即時可用性或效能報告。
接入前必讀
以下參數依據 MaxAPI 公開配置;所選路由可能另有輸入或權限要求。
- 請求模型 ID
bytedance/seedance-2.0- 輸出類型
- 影片
- Base URL
https://api.maxapi.dev- 生成方式
- 非同步任務+輪詢
- 品質參數
4k / 1080p / 720p / 480p- 解析度與尺寸
- 4k / 1080p / 720p / 480p
- 影片長度
- 目前列出的 Seedance 2.0 模型為 4–15 秒。
先選生成模式,再準備參考素材。圖片、影片與音訊各有不同用途,請依此模型 API 分頁的欄位與限制傳入。任務提交成功,不代表影片已生成完成。
模型特點與選型
以參考素材指導音畫生成
ByteDance 將 Seedance 2.0 描述為音畫聯合生成模型,可利用文字、圖片、音訊、影片參考,重點是控制表演、光影和運鏡。本站標準入口也列出 Fast 與 Mini 沒有的 1080p、4K 檔位。
資料核對 ·
此模型的資料來源: ByteDance · Seedance 2.0 · BytePlus · Seedance 2.x capability comparison
何時值得選擇它
鏡頭對參考素材、動作和構圖有明確要求,或需要本站列出的 1080p、4K 時可比較它;真正需要最長 30 秒的較長敘事時,再另行比較 2.5。
限制與注意事項
音畫聯合生成不代表任何素材組合都有效。請按本站 API 分頁的模式配置參考,並檢查整段時序、音訊和物體連續性。
供應商能力描述的是模型本身,不等於 MaxAPI 已開通全部功能。本站接入以此入口列出的參數、輸入類型和路由為準;供應商的速度、品質定位不是服務保證。
MaxAPI 實際如何處理請求
究竟使用哪條路由?
路由優先順序為:API Key 已配置的 route_modes 列表 → 請求明確指定的路由 → 模型預設路由。Key 列表非空時,優先於請求中的 route_mode。測試特定路由前,先確認 Key 配置;只修改請求參數,不一定會切換實際使用的路由。
使用者 RPM 由旗下 Key 共同使用
使用者設定的有效 RPM 上限,由旗下 API Key 共同使用。Key 可以設得更嚴格,但 Key 上限高於使用者時,仍不能突破使用者限制。例如使用者 200 RPM,不代表每個 Key 都各有 200 RPM。全站 RPM 與並發控制仍另外生效,增加 Key 不是繞過限制的方法。
路由與價格
公開路由:official-cheap、official。圖片/影片 JSON 請求可指定 route_mode;Gemini 原生請求使用 X-MaxAPI-Route-Mode。路由代表接入與計費選擇,不是另一個公開模型 ID。
| 路由 | 公開基礎價格 | 計費單位 |
|---|---|---|
official | $7 | 480p / 720p · 無參考影片 · 每百萬 Token |
official | $4.3 | 480p / 720p · 含參考影片 · 每百萬 Token |
official | $7.7 | 1080p · 無參考影片 · 每百萬 Token |
official | $4.7 | 1080p · 含參考影片 · 每百萬 Token |
official | $4 | 4K · 無參考影片 · 每百萬 Token |
official | $2.4 | 4K · 含參考影片 · 每百萬 Token |
official-cheap | $6.3 | 480p / 720p · 無參考影片 · 每百萬 Token |
official-cheap | $3.87 | 480p / 720p · 含參考影片 · 每百萬 Token |
official-cheap | $6.93 | 1080p · 無參考影片 · 每百萬 Token |
official-cheap | $4.23 | 1080p · 含參考影片 · 每百萬 Token |
official-cheap | $3.6 | 4K · 無參考影片 · 每百萬 Token |
official-cheap | $2.16 | 4K · 含參考影片 · 每百萬 Token |
1 積分 = 1 美元。此處為目錄基礎價格,並非帳戶即時報價;適用帳戶倍率。Seedance 依供應商回報的輸出 token 計費:token ≈(輸出秒數 + 參考影片秒數)× 寬 × 高 × 24 / 1024,720p 16:9 約每秒 21,600,4K 約每秒 194,400。只有請求包含至少一段參考影片時才適用「含參考影片」單價;參考圖、首尾幀與音訊按無參考影片計價。含參考影片時,供應商至少按「輸出秒數 + ⌈輸出秒數 × ⅔⌉」計費(影片輸入的最低用量)。提交時先預扣估算金額(含參考影片時另計最多 15 秒參考影片,Seedance 2.5 為 30 秒),完成後依回報的 token 結算並退回多扣部分;失敗任務不收費。
查看即時價格第一次呼叫
建立 MaxAPI API Key,並在服務端設定 MAXAPI_KEY,勿放入瀏覽器程式碼。Key 已設定的路由列表優先,即使請求另有指定;列表為空時才採用請求路由,都未指定則使用模型預設。API 呼叫可能產生費用。
POST /v1/videos/generationsGET /v1/videos/generations/{task_id}
curl -X POST "https://api.maxapi.dev/v1/videos/generations" \
-H "Authorization: Bearer $MAXAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "bytedance/seedance-2.0",
"prompt": "a calm ocean wave at sunrise, slow camera pan",
"ratio": "16:9",
"duration": 5,
"mode": "text_to_video",
"resolution": "1080p"
}'第一次呼叫的驗收清單
請求合約核對 ·
依公開目錄與網關程式核對;範例只說明資料結構,不是付費模型實測、延遲測量,也不保證每條路由目前可用。
先確認請求欄位
model / mode- 首次範例使用 bytedance/seedance-2.0 和 mode=text_to_video;不要混用 Seedance 2.5 的 Ark 格式或已退役的 Beta ID。
duration / resolution / ratio- 範例要求 5 秒。目錄解析度:4k、1080p、720p、480p。比較消耗時,應固定時長、解析度與是否附參考影片。
HTTP 202 / id / poll_url- 提交成功回傳的是任務收據,不是影片。關閉客戶端前保存 id 與 poll_url;JSON 識別欄位為 id,不是 task_id。
再確認實際結果
status / video- 使用同帳戶認證輪詢。queued/running 尚未完成;succeeded 時讀取頂層 video URL。failed/canceled 時檢查 message,不要假設已有可用檔案。
estimated_charge_credits- 收據是預估費用,不是最終帳單。以最終用量與帳務記錄核對;任務完成與成功下載影片也應分開確認。
{
"id": "example-task-id",
"object": "video.generation.task",
"status": "queued",
"model": "bytedance/seedance-2.0",
"poll_url": "/v1/videos/generations/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/v1/videos/generations/${TASK_ID:?Set TASK_ID from response.id}" \
-H "Authorization: Bearer $MAXAPI_KEY"先看現象,再判斷錯誤原因
429rate_limit_exceeded / capacity_exhausted
- 如何判斷
- 429 可能來自使用者/Key RPM、全站容量,或生成容量不足。結合 Retry-After 與回傳的 X-RateLimit-*/X-Global-* 標頭判斷;單一狀態碼不能代表唯一原因。
- 下一步處理
- 有 Retry-After 時依其等待,按原因降低發送速率或同時處理數,使用有限次退避重試。全站容量不等於單一帳戶可獨占的額度。
應用場景與工作方式
下方場景與提示詞是本站建議的評估方向,不是供應商評分或實測成果。

AI 生成的概念配圖,並非此模型的實測成果或效果評測。下方提示詞供起步參考,不代表能重現配圖。
創作實踐・共通製作建議
先寫清楚一個鏡頭,而不是堆疊特效
使用 Seedance 2.0 時,先確定一個主體、一個場景和一種運鏡意圖,再補充動作。例如商品揭幕可以從材質細節緩慢拉遠,生活情境則可以固定鏡頭,讓人物完成一個自然動作。不要讓短片段同時負擔多個場景切換、視角與複雜事件;清楚的單鏡頭需求更方便判斷成果,也更容易接到後續剪輯。
配圖只展示可能的視覺方向,不是影片模型的生成成果。選定方向後,將需求寫成時間順序:起始畫面呈現什麼、中間改變什麼、結尾要留下什麼資訊。驗收時應看完整片段的動作連貫、物體形狀與構圖,不只檢查封面;素材模式與欄位也必須依此模型文件設定,不要套用其他模型的參數。

可以直接改寫的提示詞範例
好的提示詞是一份小型創作需求:主體是什麼、要做什麼、哪些不能改。將範例換成自己的素材與用途;尺寸、路由和品質仍應在 API 參數指定,不要只寫在文字裡。
01 / 單鏡頭揭示參考商品
以提供的商品圖為視覺參考。由材質近景開始,八秒內平滑拉遠,呈現深色棚拍展示台上的完整商品。保留比例與標籤設計,商品保持靜止,只移動鏡頭;最後停在完整清楚的商品構圖,不切鏡、不新增文字。生成後檢查 · 確認拉遠過程細節都連貫,不只驗收最後一幀。

從分鏡到可用片段
先寫驗收標準
選出具代表性的輸入,說明結果達到什麼程度才算可用。除了理想範例,也加入困難案例;比較期間固定請求參數,避免同時改變太多條件。
分開處理執行與呈現
保存請求識別碼與原始回應,再轉換成介面需要的格式。明確處理錯誤和不完整结果,介面逾時不應在背景悄悄觸發重複任務。
衡量可用成果,不只看呼叫成功
記錄模型、路由、輸入特徵、實際用量與審核結果。估算交付一份可用成果的成本時,也應計入人工修正與重複嘗試,而不只看單次 API 價格。

從測試到正式接入
測試實際準備使用的路由
首次比較時固定模型、路由與參數。除了常用素材,也測試大檔與特殊輸入。模型公開能力不代表每個上游渠道都能接受所有邊界情況。
區分限流與生成錯誤
遇到 429 時降低請求速率或並發,退避後再試;輸入無效應先修正素材。排查時保存請求與任務 ID,勿把 API Key 或敏感參考素材寫入公開日誌。
追蹤可用結果與實際消耗
以帳戶用量與帳務記錄確認最終結果與消耗。HTTP 成功回應可能只是任務受理,並非最終輸出。正式發布前,請檢查生成文字、視覺細節與參考素材使用權。
已核驗的接入案例
依 MaxAPI 公開目錄、網關實作與本地回歸案例核對。共用網關核驗不代表已逐個模型進行端到端測試。這是接入參考,不是上游即時可用性或效能報告。
多個 Key 共用使用者上限
本地回歸・通過- 驗證條件
- 使用同帳戶的兩個 Key,在記憶體測試限流器中設定較小的使用者額度。
- 實際驗證結果
- 兩個 Key 的請求消耗相同使用者額度,超出後被限流;Key 額度較大不能覆蓋使用者上限,較小的 Key 額度仍有效。
常見問題
什麼情況應選擇此模型?
鏡頭對參考素材、動作和構圖有明確要求,或需要本站列出的 1080p、4K 時可比較它;真正需要最長 30 秒的較長敘事時,再另行比較 2.5。
此模型入口有哪些特別需要注意的限制?
音畫聯合生成不代表任何素材組合都有效。請按本站 API 分頁的模式配置參考,並檢查整段時序、音訊和物體連續性。
為什麼改了 route_mode,路由卻沒變?
路由優先順序為:API Key 已配置的 route_modes 列表 → 請求明確指定的路由 → 模型預設路由。Key 列表非空時,優先於請求中的 route_mode。測試特定路由前,先確認 Key 配置;只修改請求參數,不一定會切換實際使用的路由。
每個 API Key 都有完整的使用者 RPM 額度嗎?
使用者設定的有效 RPM 上限,由旗下 API Key 共同使用。Key 可以設得更嚴格,但 Key 上限高於使用者時,仍不能突破使用者限制。例如使用者 200 RPM,不代表每個 Key 都各有 200 RPM。全站 RPM 與並發控制仍另外生效,增加 Key 不是繞過限制的方法。
這些本地回歸案例能證明線上模型效能嗎?
本地測試使用模擬請求、回應與測試儲存,不呼叫付費模型渠道。它們驗證請求處理,不驗證模型畫質、線上成功率、延遲,也不代表參考圖上限已端到端測通。頁面其他位置的概念配圖,不是這些測試的輸出。
Seedance 2.0 應填哪個模型 ID?
使用 bytedance/seedance-2.0。請依範例的端點格式傳入;Gemini 原生網址使用短模型名稱。
頁面價格適用所有帳戶和路由嗎?
1 積分 = 1 美元。此處為目錄基礎價格,並非帳戶即時報價;適用帳戶倍率。Seedance 依供應商回報的輸出 token 計費:token ≈(輸出秒數 + 參考影片秒數)× 寬 × 高 × 24 / 1024,720p 16:9 約每秒 21,600,4K 約每秒 194,400。只有請求包含至少一段參考影片時才適用「含參考影片」單價;參考圖、首尾幀與音訊按無參考影片計價。含參考影片時,供應商至少按「輸出秒數 + ⌈輸出秒數 × ⅔⌉」計費(影片輸入的最低用量)。提交時先預扣估算金額(含參考影片時另計最多 15 秒參考影片,Seedance 2.5 為 30 秒),完成後依回報的 token 結算並退回多扣部分;失敗任務不收費。
失敗請求會扣積分嗎?
MaxAPI 公開規則為失敗請求不計費。處理期間可能暫時預留餘額,請以任務最終結果與帳務記錄核對,不要將暫時餘額變動當作最終消耗。
為什麼我的 API Key 不能使用某條路由?
路由是否可用,取決於模型、帳戶權限與 API Key 允許的路由。公開列出價格不代表已取得權限;修改 route_mode 前請先確認帳戶和金鑰配置。
處理結果前應確認什麼?
先選生成模式,再準備參考素材。圖片、影片與音訊各有不同用途,請依此模型 API 分頁的欄位與限制傳入。任務提交成功,不代表影片已生成完成。
失敗或逾時後要立即重試嗎?
先分辨是限流、輸入錯誤,還是任務仍在執行。已有任務 ID 時,先查狀態再決定是否重新生成。僅對可重試錯誤使用有次數限制的退避重試。