Skip to main content

​
概述

doubao-seedance-2-5-260628（2.5 新版）、doubao-seedance-2-0-260128（標準版）、doubao-seedance-2-0-fast-260128（極速版）與 doubao-seedance-2-0-mini-260615（輕量版）是字節跳動最新一代影片生成模型家族——四模型並行，通過 API易 接入火山引擎中國國內版官方資源（非 BytePlus 海外版），自帶上游內容安全機制，合規性更好。支援文生影片、首尾幀/首幀圖生影片、多模態參考生影片等輸入模式，並能自動生成與畫面同步的人聲、音效與背景音樂。 2.5 是能力最強的一檔：時長上限從 15 秒提到 30 秒、參考圖上限從 9 張提到 30 張、音訊可單獨作為參考素材、新增 mov 輸出與影片編輯/延長的顯式任務型別。它也更貴——單價約為 2.0 標準版的 1.5 倍（720p/5s 約 $1.37 對 $0.91），與官方兩代的價差一致。2.0 系繼續保留且不下線：常規 15 秒以內的出片用標準版更省，且同樣支援 1080p；mini 是批量出片的價效比之選（單價約為標準版一半、生成更快，最高 720p），fast 居中。 2.5 與 2.0 系同走 SeeDance2 分組（0.18x）——一把令牌通吃四個模型，見下方「分組介紹」。
🎬 核心亮點：2.5 支援 4–30 秒、2.0 系支援 4–15 秒（均可用 -1 智慧時長）；480p/720p/1080p 三檔解析度（1080p 僅 2.5 與 2.0 標準版）；6 種寬高比 + adaptive 自適應；預設輸出帶同步音訊；多語言提示詞。適合短影片量產、電商素材、動效設計、虛擬人內容等生產場景。
🔥 限時特價 · 截至 2026 年 10 月 7 日 23:59 (UTC+8)：新增 SD2Mini（0.10x）與 SD2Fast（0.15x）兩個單模型專屬分組，mini 降價 44.4％、fast 降價 16.7％，換一把令牌即可享受，程式碼無需改動。詳見下方「限時特價分組」與「分組介紹」兩節。
呼叫 2.5 的令牌需勾選 SeeDance2 分組（倍率 0.18x），與 2.0 系完全相同。用預設分組或其他影片分組的令牌調 doubao-seedance-2-5-260628 會報「該模型無可用渠道」。一把勾了 SeeDance2 的令牌就能調全部四個模型，2.5 與 2.0 系共用同一個分組、同一個倍率，程式碼裡只換 model 欄位即可。

影片生成 API 參考

POST /seedance/api/v3/contents/generations/tasks，非同步任務式呼叫，線上除錯 + 完整輪詢/下載程式碼。

API 使用手冊

令牌建立、Base URL、計費模式等通用呼叫規範。

視覺化介面測試

在 iCover 視覺化測試工具裡直接除錯本介面，無需寫程式碼。

非同步任務查詢 / 下載

在 API易後臺檢視已提交的影片任務、下載影片連結（API 之外的查詢入口）。

​
讓 AI Agent 幫你接入

在用 Codex / Claude Code / Cursor 開發的話，把下面這段提示詞複製給它。它會先抓本頁的純文本版（任意文件頁地址後加 .md），再按你專案的技術棧寫程式碼——非同步輪詢、影片直鏈 24 小時過期要立即轉存、gzip 頭的坑、引數紅線這幾個高頻問題已經寫死在要求裡。

讓程式設計 Agent 接入或排查 Seedance 2.5 / 2.0 的影片生成。複製後直接貼上給 Codex、Claude Code、Cursor 等。

​
為什麼選 API易 的 Seedance？

先說定位：該模型官方沒有折扣，平臺也非盈利型定價，上架以保障供給、方便客戶為主。選 API易 的核心價值不在”更便宜”，而在接入與使用體驗：

官方資源 · 國內版直連

火山引擎中國國內版官方資源（非 BytePlus 海外版），自帶上游內容安全機制，引數、響應、計費口徑與官方完全一致。

虛擬人臉白名單權限

通道自帶上游虛擬人臉白名單權限，AI 生成人臉、虛擬人畫素材可直接用於圖生影片，無需自行向官方申請白名單（真人人臉仍受上游內容安全機制限制）。

素材庫免費包含

人物一致性所需的私域素材庫（虛擬人像入庫 + 真人認證）在 API易 免費使用——官方側這項能力對非框架簽約客戶需十萬元量級的年費單獨採購，我們把它包含在介面價格裡。

保供定價 · 基本持平官網

官方無折扣、平臺也不靠它盈利：單價對齊火山引擎官網（站內扣費約上浮 10%），疊加 充值加贈活動 後基本持平官網，充值大客戶個別檔位甚至更低。

不限併發 · 不排隊

實測 15 個任務同時提交全部立即進入 running，無排隊等待（2026-06-06 (UTC+8) 實測），適合批次生產場景直接放量。

零門檻接入 · 免實名認證

無需火山引擎賬號、免官網實名認證、無消費門檻（免 200 元開通費與企業認證流程），國內機房、家寬網路、海外節點均可直連 api.apiyi.com，一把令牌即用。

影片模型生態齊全

站內同時提供 VEO 3.1、Wan2.7 等影片通道，可按場景混搭選型。

專業服務 · 企業陪跑

團隊深耕影片生成場景，具備豐富的選型、調優與整合經驗，可為企業客戶提供從 PoC 到生產上線的完整技術支援。

​
核心特性

三檔解析度 · 全比例同價

480p / 720p / 1080p（1080p 僅 2.5 與 2.0 標準版，fast 與 mini 最高 720p）。同檔位下 16:9、9:16、1:1 等所有比例像素面積相同、價格相同，橫豎屏切換零成本。

默認同步音訊

generate_audio 預設開啟，自動生成與畫面匹配的人聲、音效、背景音樂；對話內容放在雙引號內可顯著最佳化配音效果。

最長 30 秒可控時長

2.5 支援 4–30 整數秒，2.0 系支援 4–15 秒；設為 -1 由模型智慧選擇時長（按實際產出計費）。2.5 的 duration 預設值就是 -1，不顯式傳會自動選時長。幀率固定 24fps。

多語言提示詞

中文（≤500 字）、英文（≤1000 詞），額外支援日語、西班牙語、葡萄牙語、印尼語。

首尾幀 / 首幀生影片

傳 2 張圖嚴格控制首尾畫面，或 1 張圖作首幀；配合 return_last_frame 可把尾幀接力為下一段首幀，量產連續長影片。

多模態參考生影片

2.5 支援 30 圖 + 10 影片 + 10 音訊（音訊可單獨使用），2.0 係為 9 圖 + 3 影片 + 3 音訊（音訊需搭配圖或影片）。可生成全新 / 編輯 / 延長影片，保持角色與風格一致性。

非同步任務式呼叫

提交即返回 task_id，輪詢查詢，成功後從 content.video_url 下載 mp4（URL 24 小時有效）。

seed 可復現

支援 seed 固定隨機性（相同請求生成類似結果），watermark 預設關閉，輸出無水印。

​
模型定價

一句話理解定價 —— 按 token 精確計費，分檔對齊火山引擎官網。 四個模型價格不同：輕量版 mini < 極速版 fast < 標準版 < 2.5（與官網同方向，mini 單價約為標準版一半、2.5 約為標準版 1.5 倍，並非同一價格水平）。該系列官方沒有折扣，本通道以保供為定位，名義價預設略高於官網；疊加 充值加贈（一般送 10%、充值大客戶最高 20%）後基本與官網持平，充值大客戶實付僅上浮約 5%，個別檔位（如 1080p 大客戶價）甚至更低。按面積×時長結算，±5% 的偏差屬正常現象，歡迎隨時測試、對賬與溝通核對。另外，人物一致性所需的**素材庫在 API易 免費包含**（官方側對非框架簽約客戶需十萬元量級的年費單獨採購），這部分價值不計入上述單價對比。
按 token 計費：token 數 ≈ (輸入影片時長 + 輸出影片時長)(秒) × 輸出寬 × 輸出高 × 24 / 1024（純文生 / 圖生時輸入影片時長記為 0；公式經實測精確驗證，偏差少於 0.1%）。同分辨率檔位下所有寬高比像素面積相同，因此價格只取決於解析度檔位、輸出時長，以及是否含輸入影片。

​
官方價格錨點（16:9 / 輸出 5 秒，元/個）

① 輸入不含影片（純文生 / 圖生 / 參考圖）： ② 輸入包含影片（多模態參考含 video_url；輸入影片 2～15 秒，最低價 ≈ 輸入 2～4 秒、最高價 ≈ 輸入 15 秒）：
含輸入影片時，計費時長 = 輸入影片時長 + 輸出影片時長，因此整體比純文生 / 圖生更貴；另有最低 token 用量限制，過短輸入按最低用量計費。準確用量以返回的 usage.completion_tokens 為準。
站內實測對照表（2026-06 與 2026-07 實測，16:9 / 含預設音訊 / 無輸入影片；¥ 按 1:7 固定匯率折算，僅供參考）：
三個模型價格不同，切勿等同。 相同解析度/時長下的 token 單價：輕量版 mini < 極速版 fast < 標準版（如 720p/5s：mini ≈ ¥3.16、fast ≈ ¥5.08、標準 ≈ ¥6.35），與官網價格梯度方向一致。批量出片選 mini 最省錢也最快（2026-07 實測單價與站內名義定價嚴格一致，偏差 0.00%）；1080p 僅標準版支援。
注：「費用（¥）」為站內名義扣費；「一般折扣 ÷1.1」「充值大客戶 ÷1.2」分別為疊加 10% / 20% 充值加贈 後的實付等效價——可見充值後基本貼近官網參考價，1080p 大客戶價甚至低於官網。準確用量以返回的 usage.completion_tokens 為準。

​
Seedance 2.5 定價（SeeDance2 分組 0.18x）

2.5 與 2.0 系同走 SeeDance2 分組、同一個 0.18x 倍率，兩代的價差完全來自模型本身的單價——720p/5 秒 2.5 是 $1.3721、2.0 標準版是 $0.9074，約 1.5 倍。這個價差與官方兩代的定價差一致（官方 2.5 的 token 單價本就比 2.0 高約 52%），不是站內額外加價。要不要為此升級，看你是否真的需要 30 秒時長、30 張參考圖、mov 輸出或影片編輯/延長——用不上這些，2.0 標準版更省，且同樣支援 1080p。 ① 輸入不含影片（純文生 / 圖生 / 參考圖）： ② 輸入包含影片（多模態參考帶 video_url、影片編輯、影片延長）：走單獨一檔更低的 token 單價。 單價更低不等於總價更低：含輸入影片時 計費 token =（輸入影片時長 + 輸出時長）× 面積，token 數本身就多了。上面這條 86,867 tokens 若按①的單價要 $1.0945，走②只要 $0.6567。 兩檔 token 單價： 表中 token 數與兩檔單價均取自實際扣費日誌（2026-08-31 複核），非按倍率估算。疊加 充值加贈 後，充值大客戶的實付價與官網參考價基本持平。
兩個最容易多花錢的地方：
  1. duration 預設值是 -1（2.0 系是 5）。不顯式傳時長，2.5 會自己在 4–30 秒裡挑——實測一條沒傳 duration 的請求出了 10 秒影片，費用正好是 5 秒的兩倍。對成本敏感一定要顯式傳 duration。
  2. 30 秒是 5 秒的 6 倍價（720p 下 ¥57.23 對 ¥9.60）。時長與費用嚴格線性，先用 5 秒驗證提示詞，確認效果再上長片。
上表與前面 2.0 系那張表同為 SeeDance2 分組的 0.18x，可以直接橫向對比。fast 與 mini 另有限時特價分組，價格更低，見下一節。
計費說明：
  • 實際扣費以控制台模型價格和呼叫日誌為準
  • 提交任務時預扣費，任務完成後多退少補；餘額瞬時值會小幅波動，對賬請以呼叫日誌為準——日誌裡一條影片對應兩條扣費記錄，見下方「計費如何看日誌」
  • 預扣金額只按時長算、與解析度無關：2.0 系 $0.09/秒、2.5 $0.135/秒。所以 1080p 完成後通常要補釦、480p 通常會退回，屬正常現象
  • 請求被拒絕（HTTP 400 引數錯誤等）不扣費（實測驗證）
  • 時長與費用線性相關：15 秒影片 ≈ 5 秒影片的 3 倍

​
限時特價分組（mini / fast 專屬，截至 10/7）

2026 年 8 月 8 日起新增兩個限時特價分組：SD2Mini（0.10x 倍率）與 SD2Fast（0.15x 倍率）。相比常規 SeeDance2 分組的 0.18x，mini 降價 44.4％、fast 降價 16.7％。模型能力、引數、端點與呼叫方式完全不變，只需換一把令牌，程式碼不用改。優惠截至 2026 年 9 月 7 日 23:59 (UTC+8)。
同規格價格對照（由上表實測值按 新倍率 ÷ 0.18 等比折算；¥ 按 1:7 固定匯率折算，僅供參考）： 同一模型、同一規格，走特價分組 mini 省 44.4％、fast 省 16.7％；上面的降幅是純粹的分組倍率下調，與 充值加贈 互不衝突，可以疊加計算。計費方式不變，仍按 tokens 實際用量結算，±5% 偏差屬正常現象。
優惠到期不會斷供：2026 年 10 月 7 日 23:59 (UTC+8) 之後，SD2Mini / SD2Fast 兩個分組不會下線，只是倍率恢復為 0.18x（與常規 SeeDance2 分組一致）。屆時令牌可繼續使用，程式碼無需改動。有批量出片計劃的建議排在優惠視窗內。

​
計費如何看日誌（預扣費 + 多退少補）

開啟控制台日誌頁 api.apiyi.com/log，搜尋模型名 doubao-seedance-2-5 或 doubao-seedance-2-0 即可看到每筆消耗。一條影片對應兩條扣費記錄：
  1. 預扣費：提交任務時按預估金額先行扣除（日誌標「非流式」，顯示令牌與分組），如下圖的 $0.449998
  2. 實際補釦 / 退回：任務完成後按實際生成的 tokens 多退少補（日誌標「流式」、帶補全 tokens 數），如下圖的 $5.611858——1080p 一般需要補釦
API易日誌頁中 Seedance 2.0 一條影片的兩條扣費記錄：預扣費與實際補釦

一條 15 秒 1080p 影片的兩條扣費日誌：預扣費 + 實際補釦

補釦那條日誌不展示令牌、也不展示所在分組，屬正常現象；兩條金額相加才是這條影片的總成本。
時間欄位怎麼讀：
  1. 第一條（預扣費）日誌的「時間」就是這條影片的提交時間；它的「首位元組」是提交任務、返回任務 ID 的耗時（如 首位元組:3秒）——不是影片生成耗時
  2. 第二條多退少補記錄顯示 流式、首位元組:<1秒，這只是結算記錄自身的標記，不代表任何異常，無需在意
  3. 影片真正的生成耗時，看頂部導航「非同步任務」頁（api.apiyi.com/task）的「耗時」列
日誌頁時間與首位元組欄位解讀：第一條為提交時間與提交耗時

日誌第一條的時間 = 提交時間，「首位元組:3秒」是提交任務的耗時；這條 fast 例子結算為退回（負數），總成本 0.360000 − 0.022750 = 0.337250 美元

非同步任務頁展示每條影片任務的提交時間與生成耗時

「非同步任務」頁的「耗時」列才是影片生成時間，如 158s、303s

以第一張截圖那條 15 秒 1080p 影片為例，總成本 = 0.449998 + 5.611858 = $6.061856。對應的任務引數可在 api.apiyi.com/task 頂部「非同步任務」裡查到，與扣費完全對得上：
補全 732,108 tokens ≈ 15 × 1248 × 1664 × 24 / 1024（1080p 的 3:4 輸出 1248×1664），與計費公式吻合。
這條 15 秒 1080p 影片合計約 ¥42.4（名義扣費，1:7 固定匯率折算），疊加 充值加贈 後實付約 ¥35～39，官方同規格參考價約 ¥37.2——官方定價本身就不便宜，成本由模型 + 解析度 + 時長共同決定（換 fast / 720p / 5 秒則便宜得多）。本模型為微利保供，充值大客戶有更多折扣。
內測期說明：Seedance 2.5 / 2.0 目前處於內測供給階段，若實際扣費與上表偏差較大，歡迎聯絡客服溝通核對。平臺會隨官方政策（如官方後續推出更低價的版本）與 APIYI 供給能力動態調整價格，也歡迎有實力的渠道方洽談合作。該模型以保障供給、服務客戶為主，並非盈利型定價。

​
分組介紹

Seedance 2.5 與 2.0 系都走專屬分組，有兩個強制條件：① 令牌計費模式必須選「按量優先」或「按量計費」（按次計費無法路由）；② 令牌必須勾選對應分組——使用預設分組或其他影片分組的令牌會報「該模型無可用渠道」。 目前共三個分組。2.5 與 2.0 系同走 SeeDance2，另有兩個限時特價分組，每個只對一個模型開放：
一把 SeeDance2 令牌通吃四個模型：2.5 與 2.0 系三個模型都在這個分組裡，程式碼裡只換 model 欄位即可。兩個特價分組是「單模型專用通道」：SD2Mini 裡只有 mini、SD2Fast 裡只有 fast，拿它們去調另一個模型同樣會報「該模型無可用渠道」。到期後不會斷供：10 月 7 日 23:59 (UTC+8) 之後兩個特價分組不下線，倍率恢復 0.18x，令牌與程式碼都不需要改。
0.18x 倍率怎麼來的？ 系統內建的 Seedance 模型單價與火山引擎官網一致，但官網價是人民幣口徑，而站內餘額按美元計價（1:7 固定匯率）。若倍率為 1x，相當於按官網數字的 7 倍人民幣扣費，因此專門調低分組倍率來折算匯率——0.18 就是這麼來的，不是打折，也不是加價。該系列官方沒有折扣，本通道是保供定價。名義扣費預設略高於官網參考價，疊加 充值加贈 後基本抹平：充值大客戶實付僅上浮約 5%，個別檔位（如 1080p）甚至低於官網。2.5 也是同一個 0.18x。 兩代的價差來自模型本身的單價（官方對 2.5 的定價本就高於 2.0），不是靠分組倍率區分——所以 2.5 與 2.0 系走的是同一套折算口徑。請務必知悉：系統始終按 tokens 實際用量計費，token 折算本身存在小幅浮動折損（±5% 偏差屬正常），官網價也只是一個參考錨點，並非逐單對齊的承諾。當前定價為合理的保供口徑，請疊加充值加贈活動整體核算。扣費出現異常歡迎隨時聯絡客服對賬溝通；但「為什麼會比官網略高」不在爭辯範圍——介意請慎用。換個角度看，併發充足、不排隊正是這條通道的核心價值。此外，素材庫（虛擬人像入庫 / 真人認證）在本通道免費包含——官方側需十萬元量級的年費單獨採購，這也是這條通道的實際價值之一。

​
令牌怎麼配

不追特價：建一把令牌、勾 SeeDance2 分組即可，四個模型全能調，下表可以跳過。 想吃優惠期的特價：mini 與 fast 另有單模型專屬分組，按下表拆令牌： 所有令牌的計費模式都必須是「按量優先」或「按量計費」。只用 mini 的客戶建 A 一把即可，不必都建；只用 2.5 的客戶建 C 一把即可。
為什麼建議單獨開一把特價令牌：
  • 不會錯過截止時間——賬單按令牌分開，優惠期用了多少、省了多少一目瞭然，10 月 7 日臨近時也更容易判斷要不要提前排產
  • 切換零成本——到期後只需把呼叫方的 Key 換回令牌 C，不用改程式碼、不用調分組
  • 生產業務本就推薦專用令牌——便於按業務線控量與設額度告警，出現異常消耗時也容易定位
Seedance 2.5 已上線（2026-08-28）：模型名 doubao-seedance-2-5-260628，與 2.0 系同走 SeeDance2 分組（0.18x）。端點、鑑權、呼叫方式與 2.0 完全一致——只換 model 欄位即可，程式碼不用改。相比 2.0 系：時長上限 15 秒 → 30 秒、參考圖 9 張 → 30 張、參考影片/音訊 3 個 → 10 個、音訊可單獨作參考、新增 mov 輸出與 omni_reference_task_type 顯式任務型別；單價約為 2.0 標準版的 1.5 倍。差異全表見下方「技術規格」。

​
技術規格

​
端點一覽

域名選擇：api.apiyi.com 為主域名，也可使用 vip.apiyi.com 等平臺提供的其他閘道域名。注意路徑字首是 /seedance/api/v3，不要漏掉 /api，也不要走 /v1/videos。

​
解析度與寬高比詳解

解析度檔位定義的是像素面積而非短邊，各比例實際輸出畫素值（官方口徑，已實測核對）：
2.5 的 480p 16:9 是 854×480（實測），與 2.0 的 864×496 不同——按面積算 2.5 略小，同規格 token 數也略低。其餘已實測的檔位兩代一致：480p 1:1 = 640×640、720p 16:9 = 1280×720、720p 21:9 = 1470×630、1080p 16:9 = 1920×1080。四個模型都不支援 4k，傳 "resolution": "4k" 會同步返回 400（不扣費）。

​
adaptive 適配規則

  1. 文生影片：根據提示詞內容智慧選擇最合適的寬高比
  2. 首尾幀 / 首幀：根據首幀圖片比例自動選擇最接近的寬高比（圖片比例不一致時居中裁剪）
  3. 多模態參考生影片：按提示詞意圖判斷；否則以傳入的第一個媒體檔案為準（影片優先於圖片）
  4. 影片編輯 / 影片延長（2.5）：輸出寬高比跟隨被編輯 / 被延長的那個輸入影片
  5. 實際使用的寬高比可在查詢任務響應的 ratio 欄位中獲取
ratio 僅支援上表 7 個列舉值，傳 "2:1" 等非法比例會直接返回 InvalidParameter 錯誤（實測驗證）；duration 超出範圍（2.5 是 4–30，2.0 系是 4–15）同樣報錯。這兩類錯誤均不扣費。2.5 還有三類任務強制 ratio: adaptive：首幀 / 首尾幀生影片、影片編輯、影片延長。這三類任務傳具體寬高比會在提交時直接返回 InvalidParameter.TaskTypeConstraint（實測是同步 400，不是等任務跑完才失敗）。

​
最佳實踐

1

按需求選模型

先看要不要 2.5 的獨有能力：30 秒時長、30 張參考圖、單獨音訊參考、mov 輸出、顯式的影片編輯/延長任務型別——需要其中任意一項就選 doubao-seedance-2-5-260628（單價約為標準版 1.5 倍，分組與 2.0 系相同）。用不上就留在 2.0 系：批量出片、成本敏感選輕量版 doubao-seedance-2-0-mini-260615（單價約標準版一半、生成最快，最高 720p）；要 1080p 或最高畫質選標準版；兩者折中選 fast。
2

帶圖帶影片先入素材庫拿素材 ID

帶素材呼叫時，建立任務介面的耗時主要花在素材上行上——內聯 Base64 或大圖 URL 會讓提交階段從秒級拖到幾十秒甚至讀超時。先把素材入庫拿 asset:// 素材 ID 再引用，請求體只剩幾十位元組，提交即刻返回任務 ID，合規校驗也提前到入庫那一步。詳見 素材優先實踐。
3

用 adaptive 比例減少裁剪

圖生影片場景保持預設 adaptive，模型按首幀圖片自動適配，避免居中裁剪損失畫面；明確投放渠道時再固定 9:16（豎屏）或 16:9（橫屏）。
4

控制時長就是控制成本

費用與時長嚴格線性。先用 5 秒小批次驗證 prompt，確認效果後再上長片（2.5 最長 30 秒，價格是 5 秒的 6 倍）。用 2.5 時務必顯式傳 duration——它的預設值是 -1，不傳就由模型自選時長，實測會選到 10 秒，費用直接翻倍。
5

不需要聲音時顯式關閉音訊

generate_audio 預設開啟。後期要自行配音的場景傳 false，輸出純影片畫面更乾淨。
6

對話放雙引號內最佳化配音

需要角色說話時，把臺詞放在雙引號內，如：男人說：「你記住，以後不可以用手指指月亮。」模型會自動生成對應人聲。
7

HTTP 客戶端加 Accept-Encoding: identity

閘道響應頭會標 content-encoding: gzip 但 body 實際未壓縮，Python requests 等自動解壓的客戶端會報 ContentDecodingError。請求頭加 Accept-Encoding: identity 即可規避（curl 不受影響）。
8

輪詢 15–30 秒一次，成功後立即下載

任務通常 2–5 分鐘完成。content.video_url 是 24 小時有效的簽名直鏈，成功後立即轉存到自己的儲存。
9

用 return_last_frame 量產連續長影片

設 return_last_frame: true 拿到無水印尾幀 png，作為下一段任務的首幀，即可拼接多段連續影片。

​
錯誤碼與重試

建議客戶端：
  • 建立/查詢請求超時 30–60 秒即可（非同步介面本身很快，耗時在任務側）
  • 輪詢間隔 15–30 秒，整體等待預算 15 分鐘起步（1080p / 15 秒任務更長）
  • 對 5xx 與超時做 指數退避重試（建議 2 次）
  • 記錄任務 id 與響應頭 x-request-id 方便排查

​
常見問題

慢的是提交，不是生成。素材要先從你的機器上行到 API易，再由我們轉發到火山引擎並完成解碼校驗，這一整段走完才會返回任務 ID——所以內聯 Base64 或大體積圖片 URL 時，這一步會從秒級拖到幾十秒，客戶端讀超時設 60 秒都可能不夠。生成本身通常 2–5 分鐘，是原廠的正常速度，與提交階段無關。根治辦法是先把素材入庫拿 asset:// 素材 ID 再引用，請求體從數 MB 降到幾十位元組。耗時拆解、遷移步驟、以及超時之後怎麼判斷任務是否已建立，見 素材優先實踐。
按需要的能力選，不必預設上 2.5——2.5 的單價約為 2.0 標準版的 1.5 倍（720p/5s：$1.3525 對 $0.9074），這與官方兩代的定價差一致。該上 2.5 的四種情況：需要超過 15 秒的長片（2.5 最長 30 秒）；需要超過 9 張參考圖（2.5 最多 30 張）；需要 mov 輸出；需要影片編輯 / 影片延長，或想讓引數錯誤在提交時就報出來（omni_reference_task_type）。另外 2.5 允許音訊單獨作為參考素材，2.0 必須搭配圖或影片。留在 2.0 系更划算：15 秒以內的常規出片，標準版同樣支援 1080p，畫質定位也是旗艦檔；批量出片且成本敏感就用 mini，單價約標準版一半、生成也最快。2.0 系不會下線。端點、鑑權、請求結構兩代完全一致，分組也相同，切換隻改 model 一個欄位。
支援 1080p（實測 1920×1080 正常出片），不支援 4k——傳 "resolution": "4k" 會同步返回 400（不扣費）。一個容易忽略的差別：2.5 的 1080p 輸出用 H.265（hvc1）編碼，480p 與 720p 是 H.264（avc1）。H.265 體積更小，但老播放器、部分瀏覽器和一些剪輯軟體的相容性不如 H.264，做 1080p 分發前先確認下游鏈路能解。
兩者都屬於「全模態參考生影片」，靠 content 裡的參考影片 + 提示詞意圖觸發，建議同時顯式傳 omni_reference_task_type 把報錯前置：
  • 影片編輯：omni_reference_task_type: "edit"，至少一個 role: "reference_video"，ratio 必須 adaptive、duration 必須 -1，待編輯影片時長在 4–30 秒內。提示詞要帶編輯意圖詞：增加 / 加上 / 刪除 / 去掉 / 修改 / 替換 / 改成。輸出的寬高比和時長跟隨輸入影片（時長可能是非整數秒，實測出過 16.709 秒）。
  • 影片延長：omni_reference_task_type: "extend"，同樣需要參考影片、ratio 必須 adaptive。提示詞要帶延長意圖詞：向前 / 向後延長、延續、續寫。
提示詞裡用 @影片1、@影像1 按傳入順序指代素材。引數不合法時介面提交即返回 400（InvalidParameter.TaskTypeConstraint），不用等任務跑完。
傳 "output_format": "mov" 會輸出 QuickTime 容器（H.264 + yuv444p 色度取樣 + PCM 音訊），色彩與亮度還原度更高，適合調色、摳像、合成等後期加工，官方也推薦在影片編輯 / 延長場景用 mov 作為輸入和輸出。預設值是 mp4，相容性最好。注意 mov 用的是專業編碼，部分播放器不相容（VLC、mpv、ffplay、macOS 的 IINA 可以播）。做網頁或移動端直接分發就用預設的 mp4。
這是 Seedance 系列最常見的報錯，九成是令牌分組勾錯了。報錯原文會點名當前分組，例如：
按模型對號入座，在令牌設定裡勾上對應分組：一把勾了 SeeDance2 的令牌就能調全部四個模型。另外計費模式必須是「按量優先」或「按量計費」，按次計費的令牌無法路由。
閘道響應頭標了 content-encoding: gzip 但 body 實際編碼與之不符。症狀可能是 ContentDecodingError，也可能是響應體被截斷成非法 JSON（如開頭丟失 {"，只剩 id":"cgt-xxx"}），甚至間歇性 400。在請求頭加 "Accept-Encoding": "identity" 即可解決；curl 與瀏覽器 fetch 不受影響。
generate_audio 預設為 true（實測驗證），模型會自動生成與畫面匹配的人聲、音效和背景音樂。不需要時在請求體顯式傳 "generate_audio": false。
成功後影片地址在查詢任務響應的 content.video_url（不在頂層），是約 24 小時有效的簽名直鏈，過期後無法訪問。請在任務成功後立即下載轉存；task_id 本身儲存 7 天。
狀態機為 queued → running → succeeded / failed / expired。注意成功狀態是 succeeded，不是 completed——從其他影片 API 遷移時容易寫錯判斷條件。
不可以。Seedance 2.5 與 2.0 系均不支援直接上傳含真人人臉的參考圖/影片（上游內容安全機制攔截）。替代方案：使用 Seedance 模型近 30 天內生成的含人臉產物做二次創作、使用平臺預置虛擬人像（asset:// 素材 ID）、或使用已授權真人素材。
不收。虛擬人像入庫、真人認證等私域素材庫能力，在 API易 隨 Seedance 介面免費使用，不另收年費——官方側這項能力對非框架簽約客戶需要十萬元量級的年費單獨採購（官網也提供購買入口）。我們重視長期使用者，這部分成本已包含在介面價格裡；面向正常呼叫 SD2 介面的客戶，正常業務量內不額外計費。用法見 素材庫。
引數錯誤被拒（HTTP 400）不扣費（實測驗證）。計費機制為提交時預扣費、完成後多退少補，所以餘額瞬時值會小幅波動，最終以呼叫日誌為準。
token ≈ 時長(秒) × 寬 × 高 × 24 / 1024，公式經實測精確驗證。同分辨率檔位下所有寬高比像素面積相同（如 720p 的 16:9 與 9:16 同為 108,900 tokens / 5 秒），橫豎屏方形價格完全一樣。
價格與速度：輕量版 mini < 極速版 fast < 標準版（720p/5s 站內名義價約 ¥3.16 / ¥5.08 / ¥6.35）。批次生產、成本敏感選 mini——單價約為標準版一半，生成也最快（2026-07 實測 5 秒 720p 約 1.5–2.5 分鐘）；對畫質細節要求最高時選標準版；兩者之間折中選 fast。mini 與 fast 最高都只支援 720p，請求 1080p 會返回 400 引數錯誤（不扣費）。只是需要 1080p 的話，2.0 標準版就支援，不必為此升級。要 30 秒長片、超過 9 張參考圖、mov 輸出或影片編輯/延長，才需要上 2.5（單價約為標準版 1.5 倍，分組與 2.0 系相同）。
模型自主選擇合適時長（2.5 在 4–30 秒內，2.0 系在 4–15 秒內），按實際產出時長計費。實際時長可在查詢任務響應的 duration 欄位獲取。特別注意 2.5 的 duration 預設值就是 -1（2.0 系預設是 5 秒）——不顯式傳時長就等於開了智慧時長，實測一條沒傳 duration 的 2.5 請求出了 10 秒影片，費用正好是 5 秒的兩倍。對成本敏感請顯式傳 duration。
不支援。frames 與 camera_fixed 引數是 Seedance 1.x 的能力，Seedance 2.5 與 2.0 系列均不支援，請用整數 duration 控制時長。
不可以。首尾幀（2 圖，role 必填 first_frame/last_frame）、首幀（1 圖）、多模態參考生影片（圖片 role 均為 reference_image）是三種互斥場景。需要「首尾幀 + 參考」效果時，可在多模態參考模式下用提示詞指定某張圖作首幀。參考素材數量上限按模型區分：2.5 是 30 圖 + 10 影片 + 10 音訊，且音訊可以單獨用；2.0 系是 9 圖 + 3 影片 + 3 音訊，且音訊必須搭配圖或影片（至少 1 圖或 1 影片）。
SeeDance2 分組併發充足、不排隊（實測 15 任務齊發全部立即執行）。如有更大規模的批次需求，可聯絡商務確認配額。
中文建議不超過 500 字、英文不超過 1000 詞，過長會導致模型忽略細節。支援中、英、日、西、葡、印尼語。建議描述「主體 + 動作 + 鏡頭運動 + 光線/風格」。

​
相關文件

Seedance 是 2026 年影片生成第一梯隊模型中少數預設輸出同步音訊的選擇，配合全比例同價與 2.5 的 30 秒時長上限，適合作為短影片/電商素材量產的主力通道。需要對比選型時，站內 Sora 2、VEO 3.1、Wan2.7 均可用同一把令牌（追加分組）直接試。