概述
doubao-seedance-2-0-260128（標準版）、doubao-seedance-2-0-fast-260128（極速版）與 doubao-seedance-2-0-mini-260615（輕量版）是字節跳動最新一代影片生成模型家族——三模型並行，通過 API易 接入火山引擎中國國內版官方資源（非 BytePlus 海外版），自帶上游內容安全機制，合規性更好。支援文生影片、首尾幀/首幀圖生影片、0～9 張參考圖 + 0～3 參考影片 / 0～3 參考音訊等多模態輸入，並能自動生成與畫面同步的人聲、音效與背景音樂。其中 mini 是 2026 年 6 月新增的高性價比之選：單價約為標準版一半、生成更快，最高支援 720p。🎬 核心亮點：4–15 秒可控時長（支援
-1 智慧時長）、480p/720p/1080p 三檔解析度（1080p 僅標準版）、6 種寬高比 + adaptive 自適應、預設輸出帶同步音訊、多語言提示詞（中英日西葡印尼）。適合短影片量產、電商素材、動效設計、虛擬人內容等生產場景。影片生成 API 參考
POST /seedance/api/v3/contents/generations/tasks，非同步任務式呼叫，線上除錯 + 完整輪詢/下載程式碼。API 使用手冊
令牌建立、Base URL、計費模式等通用呼叫規範。
視覺化介面測試
在 iCover 視覺化測試工具裡直接除錯本介面，無需寫程式碼。
非同步任務查詢 / 下載
在 API易後臺檢視已提交的影片任務、下載影片連結（API 之外的查詢入口）。
為什麼選 API易 的 Seedance 2.0？
先說定位：該模型官方沒有折扣，平臺也非盈利型定價，上架以保障供給、方便客戶為主。選 API易 的核心價值不在”更便宜”，而在接入與使用體驗：官方資源 · 國內版直連
火山引擎中國國內版官方資源（非 BytePlus 海外版），自帶上游內容安全機制，引數、響應、計費口徑與官方完全一致。
不限併發 · 不排隊
實測 15 個任務同時提交全部立即進入
running，無排隊等待（2026-06-06 (UTC+8) 實測），適合批次生產場景直接放量。保供定價 · 基本持平官網
官方無折扣、平臺也不靠它盈利：單價對齊火山引擎官網（站內扣費約上浮 10%），疊加 充值加贈活動 後基本持平官網，充值大客戶個別檔位甚至更低。
零門檻接入 · 免實名認證
無需火山引擎賬號、免官網實名認證、無消費門檻（免 200 元開通費與企業認證流程），國內機房、家寬網路、海外節點均可直連
api.apiyi.com，一把令牌即用。虛擬人臉白名單權限
通道自帶上游虛擬人臉白名單權限，AI 生成人臉、虛擬人畫素材可直接用於圖生影片，無需自行向官方申請白名單（真人人臉仍受上游內容安全機制限制）。
專業服務 · 企業陪跑
團隊深耕影片生成場景，具備豐富的選型、調優與整合經驗，可為企業客戶提供從 PoC 到生產上線的完整技術支援。
核心特性
三檔解析度 · 全比例同價
480p / 720p / 1080p（1080p 僅標準版）。同檔位下 16:9、9:16、1:1 等所有比例像素面積相同、價格相同，橫豎屏切換零成本。
默認同步音訊
generate_audio 預設開啟，自動生成與畫面匹配的人聲、音效、背景音樂；對話內容放在雙引號內可顯著最佳化配音效果。4–15 秒可控時長
duration 支援 4–15 整數秒，或設為 -1 由模型智慧選擇時長（按實際產出計費）。幀率固定 24fps。多語言提示詞
中文（≤500 字）、英文（≤1000 詞），額外支援日語、西班牙語、葡萄牙語、印尼語。
首尾幀 / 首幀生影片
傳 2 張圖嚴格控制首尾畫面，或 1 張圖作首幀；配合
return_last_frame 可把尾幀接力為下一段首幀，量產連續長影片。多模態參考生影片
0～9 參考圖 + 0～3 參考影片 + 0～3 參考音訊自由組合（至少 1 圖或 1 影片，三種圖生場景互斥），可生成全新 / 編輯 / 延長影片，保持角色與風格一致性。
非同步任務式呼叫
提交即返回
task_id，輪詢查詢，成功後從 content.video_url 下載 mp4（URL 24 小時有效）。seed 可復現
支援
seed 固定隨機性（相同請求生成類似結果），watermark 預設關閉，輸出無水印。模型定價
一句話理解定價 —— 按 token 精確計費，分檔對齊火山引擎官網。 三個模型價格不同：輕量版
mini < 極速版 fast < 標準版（與官網同方向，mini 單價約為標準版一半，三者並非同一價格水平）。站內一般折扣價約為官網的 1.1 倍，疊加 充值加贈（一般送 10%、充值大客戶最高 20%）後基本與官網持平，個別檔位（如 1080p 大客戶價）甚至更低。按面積×時長結算，±5% 的偏差屬正常現象，歡迎隨時測試、對賬與溝通核對。token 數 ≈ (輸入影片時長 + 輸出影片時長)(秒) × 輸出寬 × 輸出高 × 24 / 1024（純文生 / 圖生時輸入影片時長記為 0；公式經實測精確驗證，偏差少於 0.1%）。同分辨率檔位下所有寬高比像素面積相同，因此價格只取決於解析度檔位、輸出時長，以及是否含輸入影片。
官方價格錨點（16:9 / 輸出 5 秒，元/個）
① 輸入不含影片（純文生 / 圖生 / 參考圖）：
② 輸入包含影片（多模態參考含
video_url；輸入影片 2～15 秒，最低價 ≈ 輸入 2～4 秒、最高價 ≈ 輸入 15 秒）：
含輸入影片時，計費時長 = 輸入影片時長 + 輸出影片時長，因此整體比純文生 / 圖生更貴；另有最低 token 用量限制，過短輸入按最低用量計費。準確用量以返回的
usage.completion_tokens 為準。
注：「費用（¥）」為站內名義扣費；「一般折扣 ÷1.1」「充值大客戶 ÷1.2」分別為疊加 10% / 20% 充值加贈 後的實付等效價——可見充值後基本貼近官網參考價，1080p 大客戶價甚至低於官網。準確用量以返回的
usage.completion_tokens 為準。
計費說明：
- 實際扣費以控制台模型價格和呼叫日誌為準
- 提交任務時預扣費，任務完成後多退少補；餘額瞬時值會小幅波動，對賬請以呼叫日誌為準——日誌裡一條影片對應兩條扣費記錄，見下方「計費如何看日誌」
- 請求被拒絕（HTTP 400 引數錯誤等）不扣費（實測驗證）
- 時長與費用線性相關：15 秒影片 ≈ 5 秒影片的 3 倍
計費如何看日誌（預扣費 + 多退少補）
開啟控制台日誌頁api.apiyi.com/log，搜尋模型名 doubao-seedance-2-0 即可看到每筆消耗。一條影片對應兩條扣費記錄：
- 預扣費：提交任務時按預估金額先行扣除（日誌標「非流式」，顯示令牌與分組），如下圖的 $0.449998
- 實際補釦 / 退回：任務完成後按實際生成的 tokens 多退少補（日誌標「流式」、帶補全 tokens 數），如下圖的 $5.611858——1080p 一般需要補釦
一條 15 秒 1080p 影片的兩條扣費日誌：預扣費 + 實際補釦
補釦那條日誌不展示令牌、也不展示所在分組，屬正常現象；兩條金額相加才是這條影片的總成本。
- 第一條（預扣費）日誌的「時間」就是這條影片的提交時間；它的「首位元組」是提交任務、返回任務 ID 的耗時（如
首位元組:3秒）——不是影片生成耗時 - 第二條多退少補記錄顯示
流式、首位元組:<1秒，這只是結算記錄自身的標記，不代表任何異常，無需在意 - 影片真正的生成耗時，看頂部導航「非同步任務」頁（
api.apiyi.com/task）的「耗時」列
日誌第一條的時間 = 提交時間，「首位元組:3秒」是提交任務的耗時；這條 fast 例子結算為退回（負數），總成本 0.360000 − 0.022750 = 0.337250 美元
「非同步任務」頁的「耗時」列才是影片生成時間，如 158s、303s
api.apiyi.com/task 頂部「非同步任務」裡查到，與扣費完全對得上：
這條 15 秒 1080p 影片合計約 ¥42.4（名義扣費，1:7 固定匯率折算），疊加 充值加贈 後實付約 ¥35～39，官方同規格參考價約 ¥37.2——官方定價本身就不便宜，成本由模型 + 解析度 + 時長共同決定（換 fast / 720p / 5 秒則便宜得多）。本模型為微利保供，充值大客戶有更多折扣。
內測期說明：Seedance 2.0 目前處於內測供給階段，若實際扣費與上表偏差較大，歡迎聯絡客服溝通核對。平臺會隨官方政策（如官方後續推出更低價的版本）與 APIYI 供給能力動態調整價格，也歡迎有實力的渠道方洽談合作。該模型以保障供給、服務客戶為主，並非盈利型定價。
分組介紹
Seedance 2.0 走SeeDance2 專屬分組（0.18x 倍率，人民幣計價口徑），有兩個強制條件：① 令牌計費模式必須選「按量優先」或「按量計費」（按次計費無法路由）；② 令牌必須勾選 SeeDance2 分組——使用預設分組或其他影片分組的令牌會報「該模型無可用渠道」。
0.18x 倍率怎麼來的？ 系統內建的 Seedance 2.0 模型單價與火山引擎官網一致，但官網價是人民幣口徑，而站內餘額按美元計價（1:7 固定匯率）。若倍率為 1x，相當於按官網數字的 7 倍人民幣扣費，因此專門調低分組倍率來折算匯率：0.18 × 7 = 1.26，即站內名義扣費約為官網人民幣價的 1.26 倍。再疊加 充值加贈 後，一般使用者實付約比官網高 10% 左右，充值大客戶基本持平、個別檔位（如 1080p）甚至低於官網。請務必知悉：系統始終按 tokens 實際用量計費，token 折算本身存在小幅浮動折損（±5% 偏差屬正常），官網價也只是一個參考錨點，並非逐單對齊的承諾。當前定價為合理的保供口徑，請疊加充值加贈活動整體核算。扣費出現異常歡迎隨時聯絡客服對賬溝通；但「為什麼會比官網略高」不在爭辯範圍——介意請慎用。換個角度看，併發充足、不排隊正是這條通道的核心價值。
技術規格
端點一覽
解析度與寬高比詳解
解析度檔位定義的是像素面積而非短邊，各比例實際輸出畫素值（官方口徑，已實測核對）：adaptive 適配規則
- 文生影片：根據提示詞內容智慧選擇最合適的寬高比
- 首尾幀 / 首幀：根據首幀圖片比例自動選擇最接近的寬高比（圖片比例不一致時居中裁剪）
- 多模態參考生影片：按提示詞意圖判斷；否則以傳入的第一個媒體檔案為準（影片優先於圖片）
- 實際使用的寬高比可在查詢任務響應的
ratio欄位中獲取
最佳實踐
1
按需求選模型
要 1080p 或最高畫質選標準版
doubao-seedance-2-0-260128；批量出片、成本敏感選輕量版 doubao-seedance-2-0-mini-260615（單價約標準版一半、生成最快，最高 720p）；畫質與成本折中選 fast。2
用 adaptive 比例減少裁剪
圖生影片場景保持預設
adaptive，模型按首幀圖片自動適配，避免居中裁剪損失畫面；明確投放渠道時再固定 9:16（豎屏）或 16:9（橫屏）。3
控制時長就是控制成本
費用與時長線性相關。先用 5 秒小批次驗證 prompt，確認效果後再上 10–15 秒；不確定節奏時用
duration: -1 讓模型自主決定。4
不需要聲音時顯式關閉音訊
generate_audio 預設開啟。後期要自行配音的場景傳 false，輸出純影片畫面更乾淨。5
對話放雙引號內最佳化配音
需要角色說話時，把臺詞放在雙引號內，如：男人說：「你記住，以後不可以用手指指月亮。」模型會自動生成對應人聲。
6
HTTP 客戶端加 Accept-Encoding: identity
閘道響應頭會標
content-encoding: gzip 但 body 實際未壓縮，Python requests 等自動解壓的客戶端會報 ContentDecodingError。請求頭加 Accept-Encoding: identity 即可規避（curl 不受影響）。7
輪詢 15–30 秒一次，成功後立即下載
任務通常 2–5 分鐘完成。
content.video_url 是 24 小時有效的簽名直鏈，成功後立即轉存到自己的儲存。8
用 return_last_frame 量產連續長影片
設
return_last_frame: true 拿到無水印尾幀 png，作為下一段任務的首幀，即可拼接多段連續影片。錯誤碼與重試
建議客戶端：
- 建立/查詢請求超時 30–60 秒即可（非同步介面本身很快，耗時在任務側）
- 輪詢間隔 15–30 秒，整體等待預算 15 分鐘起步（1080p / 15 秒任務更長）
- 對 5xx 與超時做 指數退避重試（建議 2 次）
- 記錄任務
id與響應頭x-request-id方便排查
常見問題
報「該模型無可用渠道」怎麼辦？
報「該模型無可用渠道」怎麼辦？
這是 Seedance 2.0 最常見的報錯：令牌沒有勾選
SeeDance2 分組。預設分組或其他影片分組的令牌無法路由到該模型，請在令牌設定中勾選 SeeDance2 分組，且計費模式選「按量優先」。Python requests 報 gzip 解碼錯誤 / 返回的 JSON 缺頭不完整？
Python requests 報 gzip 解碼錯誤 / 返回的 JSON 缺頭不完整？
閘道響應頭標了
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.0 不支援直接上傳含真人人臉的參考圖/影片（上游內容安全機制攔截）。替代方案：使用 Seedance 模型近 30 天內生成的含人臉產物做二次創作、使用平臺預置虛擬人像（
asset:// 素材 ID）、或使用已授權真人素材。生成失敗或請求被拒會扣費嗎？
生成失敗或請求被拒會扣費嗎？
引數錯誤被拒（HTTP 400）不扣費（實測驗證）。計費機制為提交時預扣費、完成後多退少補，所以餘額瞬時值會小幅波動，最終以呼叫日誌為準。
token 用量怎麼估算？豎屏會更貴嗎？
token 用量怎麼估算？豎屏會更貴嗎？
token ≈ 時長(秒) × 寬 × 高 × 24 / 1024，公式經實測精確驗證。同分辨率檔位下所有寬高比像素面積相同（如 720p 的 16:9 與 9:16 同為 108,900 tokens / 5 秒），橫豎屏方形價格完全一樣。標準版、fast、mini 三個模型怎麼選？
標準版、fast、mini 三個模型怎麼選？
價格與速度：輕量版
mini < 極速版 fast < 標準版（720p/5s 站內名義價約 ¥3.16 / ¥5.08 / ¥6.35）。批次生產、成本敏感選 mini——單價約為標準版一半，生成也最快（2026-07 實測 5 秒 720p 約 1.5–2.5 分鐘）；需要 1080p 或對畫質細節要求最高時選標準版；兩者之間折中選 fast。mini 與 fast 最高都只支援 720p，請求 1080p 會返回 400 引數錯誤（不扣費）。duration 設為 -1 是什麼效果？
duration 設為 -1 是什麼效果？
模型在 4–15 秒內自主選擇合適時長（實測生成了 10 秒影片），按實際產出時長計費。實際時長可在查詢任務響應的
duration 欄位獲取。對成本敏感時建議固定時長。支援 frames 引數生成小數秒影片嗎？
支援 frames 引數生成小數秒影片嗎？
不支援。
frames 與 camera_fixed 引數是 Seedance 1.x 的能力，Seedance 2.0 系列暫不支援，請用整數 duration 控制時長。首尾幀、首幀、參考圖可以混用嗎？
首尾幀、首幀、參考圖可以混用嗎？
不可以。首尾幀（2 圖，role 必填
first_frame/last_frame）、首幀（1 圖）、多模態參考生影片（0～9 圖 + 0～3 影片 + 0～3 音訊，至少 1 圖或 1 影片，圖片 role 均為 reference_image）是三種互斥場景。需要”首尾幀 + 參考”效果時，可在多模態參考模式下用提示詞指定某張圖作首幀。併發有限制嗎？會排隊嗎？
併發有限制嗎？會排隊嗎？
SeeDance2 分組併發充足、不排隊（實測 15 任務齊發全部立即執行）。如有更大規模的批次需求，可聯絡商務確認配額。
提示詞有什麼限制？
提示詞有什麼限制？
中文建議不超過 500 字、英文不超過 1000 詞，過長會導致模型忽略細節。支援中、英、日、西、葡、印尼語。建議描述「主體 + 動作 + 鏡頭運動 + 光線/風格」。
相關文件
- 影片生成 API 參考與線上除錯 -
POST /seedance/api/v3/contents/generations/tasks - Sora 2 影片生成 - OpenAI 官轉影片通道
- VEO 3.1 影片生成 - Google 官方影片通道
- 充值加贈活動 - 疊加後基本持平官網
- API 使用手冊 - 通用呼叫規範
Seedance 2.0 是 2026 年影片生成第一梯隊模型中少數預設輸出同步音訊的選擇，配合全比例同價與 15 秒時長上限，適合作為短影片/電商素材量產的主力通道。需要對比選型時，站內 Sora 2、VEO 3.1、Wan2.7 均可用同一把令牌（追加分組）直接試。