> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Seedance 2.0 影片生成

> 字節跳動 Seedance 2.0 官方資源接入：標準版 / 極速版 fast / 輕量版 mini 三模型並行，文生影片、首尾幀、多模態參考生影片，同檔位全比例同價，預設帶同步音訊，高併發不排隊。

## 概述

**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。

<Note>
  **🎬 核心亮點**：4–15 秒可控時長（支援 `-1` 智慧時長）、480p/720p/1080p 三檔解析度（1080p 僅標準版）、6 種寬高比 + adaptive 自適應、**預設輸出帶同步音訊**、多語言提示詞（中英日西葡印尼）。適合**短影片量產、電商素材、動效設計、虛擬人內容**等生產場景。
</Note>

<CardGroup cols={2}>
  <Card title="影片生成 API 參考" icon="video" href="/zh-Hant/api-capabilities/seedance2/video-generation">
    `POST /seedance/api/v3/contents/generations/tasks`，非同步任務式呼叫，線上除錯 + 完整輪詢/下載程式碼。
  </Card>

  <Card title="API 使用手冊" icon="book-open" href="/zh-Hant/api-manual">
    令牌建立、Base URL、計費模式等通用呼叫規範。
  </Card>

  <Card title="視覺化介面測試" icon="flask-conical" href="https://icover.ai/zh/seedance-official">
    在 iCover 視覺化測試工具裡直接除錯本介面，無需寫程式碼。
  </Card>

  <Card title="非同步任務查詢 / 下載" icon="list-checks" href="https://api.apiyi.com/task">
    在 API易後臺檢視已提交的影片任務、下載影片連結（API 之外的查詢入口）。
  </Card>
</CardGroup>

## 為什麼選 API易 的 Seedance 2.0？

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

<CardGroup cols={2}>
  <Card title="官方資源 · 國內版直連" icon="shield-check">
    火山引擎中國國內版官方資源（非 BytePlus 海外版），自帶上游內容安全機制，引數、響應、計費口徑與官方完全一致。
  </Card>

  <Card title="不限併發 · 不排隊" icon="infinity">
    實測 15 個任務同時提交全部立即進入 `running`，無排隊等待（2026-06-06 (UTC+8) 實測），適合批次生產場景直接放量。
  </Card>

  <Card title="保供定價 · 基本持平官網" icon="percent">
    官方無折扣、平臺也不靠它盈利：單價對齊火山引擎官網（站內扣費約上浮 10%），疊加 [充值加贈活動](/zh-Hant/faq/recharge-promotions) 後**基本持平官網**，充值大客戶個別檔位甚至更低。
  </Card>

  <Card title="零門檻接入 · 免實名認證" icon="globe">
    **無需火山引擎賬號、免官網實名認證、無消費門檻**（免 200 元開通費與企業認證流程），國內機房、家寬網路、海外節點均可直連 `api.apiyi.com`，一把令牌即用。
  </Card>

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

  <Card title="影片模型生態齊全" icon="layers">
    站內同時提供 [VEO 3.1](/zh-Hant/api-capabilities/veo-3-1-official/overview)、[Sora 2](/zh-Hant/api-capabilities/sora-2/overview)、[Wan2.7](/zh-Hant/api-capabilities/wan/overview) 等影片通道，可按場景混搭選型。
  </Card>

  <Card title="專業服務 · 企業陪跑" icon="handshake">
    團隊深耕影片生成場景，具備豐富的選型、調優與整合經驗，可為企業客戶提供從 PoC 到生產上線的完整技術支援。
  </Card>
</CardGroup>

## 核心特性

<CardGroup cols={2}>
  <Card title="三檔解析度 · 全比例同價" icon="monitor">
    480p / 720p / 1080p（1080p 僅標準版）。同檔位下 16:9、9:16、1:1 等所有比例**像素面積相同、價格相同**，橫豎屏切換零成本。
  </Card>

  <Card title="默認同步音訊" icon="volume-2">
    `generate_audio` 預設開啟，自動生成與畫面匹配的人聲、音效、背景音樂；對話內容放在雙引號內可顯著最佳化配音效果。
  </Card>

  <Card title="4–15 秒可控時長" icon="timer">
    `duration` 支援 4–15 整數秒，或設為 `-1` 由模型智慧選擇時長（按實際產出計費）。幀率固定 24fps。
  </Card>

  <Card title="多語言提示詞" icon="languages">
    中文（≤500 字）、英文（≤1000 詞），額外支援日語、西班牙語、葡萄牙語、印尼語。
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="首尾幀 / 首幀生影片" icon="image">
    傳 2 張圖嚴格控制首尾畫面，或 1 張圖作首幀；配合 `return_last_frame` 可把尾幀接力為下一段首幀，量產連續長影片。
  </Card>

  <Card title="多模態參考生影片" icon="images">
    0～9 參考圖 + 0～3 參考影片 + 0～3 參考音訊自由組合（至少 1 圖或 1 影片，三種圖生場景互斥），可生成全新 / 編輯 / 延長影片，保持角色與風格一致性。
  </Card>

  <Card title="非同步任務式呼叫" icon="clock">
    提交即返回 `task_id`，輪詢查詢，成功後從 `content.video_url` 下載 mp4（URL 24 小時有效）。
  </Card>

  <Card title="seed 可復現" icon="dices">
    支援 `seed` 固定隨機性（相同請求生成類似結果），`watermark` 預設關閉，輸出無水印。
  </Card>
</CardGroup>

## 模型定價

<Info>
  **一句話理解定價 —— 按 token 精確計費，分檔對齊火山引擎官網。** 三個模型**價格不同**：輕量版 `mini` \< 極速版 `fast` \< 標準版（與官網同方向，mini 單價約為標準版一半，**三者並非同一價格水平**）。站內一般折扣價約為官網的 **1.1 倍**，疊加 [充值加贈](/zh-Hant/faq/recharge-promotions)（一般送 10%、充值大客戶最高 20%）後**基本與官網持平**，個別檔位（如 1080p 大客戶價）甚至更低。按面積×時長結算，**±5% 的偏差屬正常現象**，歡迎隨時測試、對賬與溝通核對。
</Info>

按 token 計費：`token 數 ≈ (輸入影片時長 + 輸出影片時長)(秒) × 輸出寬 × 輸出高 × 24 / 1024`（純文生 / 圖生時輸入影片時長記為 0；公式經實測精確驗證，偏差少於 0.1%）。同分辨率檔位下所有寬高比像素面積相同，因此**價格只取決於解析度檔位、輸出時長，以及是否含輸入影片**。

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

**① 輸入不含影片**（純文生 / 圖生 / 參考圖）：

| 解析度   | 標準版 `doubao-seedance-2.0` | 極速版 `fast` | 輕量版 `mini` |
| ----- | ------------------------- | ---------- | ---------- |
| 480p  | ¥2.31                     | ¥1.86      | ¥1.16      |
| 720p  | ¥4.97                     | ¥4.00      | ¥2.50      |
| 1080p | ¥12.39                    | 不支援        | 不支援        |

**② 輸入包含影片**（多模態參考含 `video_url`；輸入影片 2～15 秒，最低價 ≈ 輸入 2～4 秒、最高價 ≈ 輸入 15 秒）：

| 解析度   | 標準版 `doubao-seedance-2.0` | 極速版 `fast` | 輕量版 `mini` |
| ----- | ------------------------- | ---------- | ---------- |
| 480p  | ¥2.53～5.62                | ¥1.99～4.42 | ¥1.28～2.84 |
| 720p  | ¥5.44～12.10               | ¥4.28～9.50 | ¥2.74～6.10 |
| 1080p | ¥13.56～30.13              | 不支援        | 不支援        |

<Note>
  含輸入影片時，計費時長 = **輸入影片時長 + 輸出影片時長**，因此整體比純文生 / 圖生更貴；另有最低 token 用量限制，過短輸入按最低用量計費。準確用量以返回的 `usage.completion_tokens` 為準。
</Note>

**站內實測對照表**（2026-06 與 2026-07 實測，16:9 / 含預設音訊 / 無輸入影片；¥ 按 1:7 固定匯率折算，僅供參考）：

| 模型                                | 解析度   | 時長  | APIYI 花費 | 費用（¥）  | 一般折扣 ÷1.1（¥） | 充值大客戶 ÷1.2（¥） | 官方參考價（¥） |
| --------------------------------- | ----- | --- | -------- | ------ | ------------ | ------------- | -------- |
| `doubao-seedance-2-0-fast-260128` | 720p  | 5s  | \$0.7253 | ¥5.08  | ¥4.62        | ¥4.23         | ¥4.00    |
| `doubao-seedance-2-0-fast-260128` | 480p  | 5s  | \$0.3373 | ¥2.36  | ¥2.15        | ¥1.97         | ¥1.86    |
| `doubao-seedance-2-0-260128`      | 720p  | 5s  | \$0.9074 | ¥6.35  | ¥5.77        | ¥5.29         | ¥4.97    |
| `doubao-seedance-2-0-260128`      | 480p  | 5s  | \$0.4193 | ¥2.94  | ¥2.67        | ¥2.45         | ¥2.31    |
| `doubao-seedance-2-0-260128`      | 1080p | 5s  | \$2.0288 | ¥14.20 | ¥12.91       | ¥11.84        | ¥12.39   |
| `doubao-seedance-2-0-fast-260128` | 720p  | 4s  | \$0.5814 | ¥4.07  | ¥3.70        | ¥3.39         | ¥3.20    |
| `doubao-seedance-2-0-fast-260128` | 720p  | 8s  | \$1.1568 | ¥8.10  | ¥7.36        | ¥6.75         | ¥6.40    |
| `doubao-seedance-2-0-mini-260615` | 720p  | 5s  | \$0.4508 | ¥3.16  | ¥2.87        | ¥2.63         | ¥2.50    |
| `doubao-seedance-2-0-mini-260615` | 480p  | 4s  | \$0.1681 | ¥1.18  | ¥1.07        | ¥0.98         | ¥0.93    |
| `doubao-seedance-2-0-mini-260615` | 720p  | 15s | \$1.3451 | ¥9.42  | ¥8.56        | ¥7.85         | ¥7.47    |

<Warning>
  **三個模型價格不同，切勿等同。** 相同解析度/時長下的 token 單價：輕量版 `mini` \< 極速版 `fast` \< 標準版（如 720p/5s：mini ≈ ¥3.16、fast ≈ ¥5.08、標準 ≈ ¥6.35），與官網價格梯度方向一致。批量出片選 mini **最省錢也最快**（2026-07 實測單價與站內名義定價嚴格一致，偏差 0.00%）；1080p 僅標準版支援。
</Warning>

注：「費用（¥）」為站內名義扣費；「一般折扣 ÷1.1」「充值大客戶 ÷1.2」分別為疊加 10% / 20% [充值加贈](/zh-Hant/faq/recharge-promotions) 後的實付等效價——可見**充值後基本貼近官網參考價，1080p 大客戶價甚至低於官網**。準確用量以返回的 `usage.completion_tokens` 為準。

<Info>
  **計費說明**：

  * 實際扣費以控制台模型價格和呼叫日誌為準
  * **提交任務時預扣費，任務完成後多退少補**；餘額瞬時值會小幅波動，對賬請以呼叫日誌為準——日誌裡一條影片對應**兩條**扣費記錄，見下方「計費如何看日誌」
  * 請求被拒絕（HTTP 400 引數錯誤等）**不扣費**（實測驗證）
  * 時長與費用線性相關：15 秒影片 ≈ 5 秒影片的 3 倍
</Info>

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

開啟控制台日誌頁 `api.apiyi.com/log`，搜尋模型名 `doubao-seedance-2-0` 即可看到每筆消耗。**一條影片對應兩條扣費記錄**：

1. **預扣費**：提交任務時按預估金額先行扣除（日誌標「非流式」，顯示令牌與分組），如下圖的 \$0.449998
2. **實際補釦 / 退回**：任務完成後按實際生成的 tokens **多退少補**（日誌標「流式」、帶補全 tokens 數），如下圖的 \$5.611858——**1080p 一般需要補釦**

<Frame caption="一條 15 秒 1080p 影片的兩條扣費日誌：預扣費 + 實際補釦">
  <img src="https://mintcdn.com/apiyillc/ae60mWKk0AtXJTS1/images/seedance2-billing-log-two-entries.png?fit=max&auto=format&n=ae60mWKk0AtXJTS1&q=85&s=9e6583b5467c886a02da82513eb6a154" alt="API易日誌頁中 Seedance 2.0 一條影片的兩條扣費記錄：預扣費與實際補釦" width="2000" height="624" data-path="images/seedance2-billing-log-two-entries.png" />
</Frame>

<Note>
  補釦那條日誌**不展示令牌、也不展示所在分組**，屬正常現象；兩條金額相加才是這條影片的總成本。
</Note>

**時間欄位怎麼讀**：

1. 第一條（預扣費）日誌的「時間」就是這條影片的**提交時間**；它的「首位元組」是提交任務、返回任務 ID 的耗時（如 `首位元組:3秒`）——**不是**影片生成耗時
2. 第二條多退少補記錄顯示 `流式`、`首位元組:<1秒`，這只是結算記錄自身的標記，**不代表任何異常**，無需在意
3. 影片真正的**生成耗時**，看頂部導航「非同步任務」頁（`api.apiyi.com/task`）的「耗時」列

<Frame caption="日誌第一條的時間 = 提交時間，「首位元組:3秒」是提交任務的耗時；這條 fast 例子結算為退回（負數），總成本 0.360000 − 0.022750 = 0.337250 美元">
  <img src="https://mintcdn.com/apiyillc/ae60mWKk0AtXJTS1/images/seedance2-billing-log-time-fields.png?fit=max&auto=format&n=ae60mWKk0AtXJTS1&q=85&s=ec4fd88847492864468cc91ffb643ca9" alt="日誌頁時間與首位元組欄位解讀：第一條為提交時間與提交耗時" width="1248" height="332" data-path="images/seedance2-billing-log-time-fields.png" />
</Frame>

<Frame caption="「非同步任務」頁的「耗時」列才是影片生成時間，如 158s、303s">
  <img src="https://mintcdn.com/apiyillc/ae60mWKk0AtXJTS1/images/seedance2-task-page-elapsed-time.png?fit=max&auto=format&n=ae60mWKk0AtXJTS1&q=85&s=9c1b2073b12afebcf1182246a6685a71" alt="非同步任務頁展示每條影片任務的提交時間與生成耗時" width="1506" height="532" data-path="images/seedance2-task-page-elapsed-time.png" />
</Frame>

以第一張截圖那條 15 秒 1080p 影片為例，總成本 = 0.449998 + 5.611858 = **\$6.061856**。對應的任務引數可在 `api.apiyi.com/task` 頂部「非同步任務」裡查到，與扣費完全對得上：

```json theme={null}
{
  "id": "cgt-20260703185641-9nbbg",
  "model": "doubao-seedance-2-0-260128",
  "status": "succeeded",
  "duration": 15,
  "resolution": "1080p",
  "ratio": "3:4",
  "framespersecond": 24,
  "generate_audio": true
}
```

補全 732,108 tokens ≈ 15 × 1248 × 1664 × 24 / 1024（1080p 的 3:4 輸出 1248×1664），與計費公式吻合。

<Note>
  這條 15 秒 1080p 影片合計約 **¥42.4**（名義扣費，1:7 固定匯率折算），疊加 [充值加贈](/zh-Hant/faq/recharge-promotions) 後實付約 ¥35～39，官方同規格參考價約 ¥37.2——**官方定價本身就不便宜**，成本由**模型 + 解析度 + 時長**共同決定（換 fast / 720p / 5 秒則便宜得多）。本模型為微利保供，充值大客戶有更多折扣。
</Note>

<Note>
  **內測期說明**：Seedance 2.0 目前處於內測供給階段，若實際扣費與上表偏差較大，歡迎聯絡客服溝通核對。平臺會隨官方政策（如官方後續推出更低價的版本）與 APIYI 供給能力動態調整價格，也歡迎有實力的渠道方洽談合作。該模型以**保障供給、服務客戶**為主，並非盈利型定價。
</Note>

## 分組介紹

Seedance 2.0 走 **`SeeDance2` 專屬分組**（0.18x 倍率，人民幣計價口徑），有兩個**強制條件**：① 令牌計費模式必須選「**按量優先**」或「按量計費」（按次計費無法路由）；② 令牌必須勾選 **`SeeDance2` 分組**——使用預設分組或其他影片分組的令牌會報「**該模型無可用渠道**」。

| 分組          | 倍率    | 適用場景                           |
| ----------- | ----- | ------------------------------ |
| `SeeDance2` | 0.18x | Seedance 2.0 全系列唯一可用分組，併發充足不排隊 |

<Note>
  **0.18x 倍率怎麼來的？** 系統內建的 Seedance 2.0 模型單價與火山引擎官網一致，但官網價是**人民幣**口徑，而站內餘額按**美元**計價（1:7 固定匯率）。若倍率為 1x，相當於按官網數字的 7 倍人民幣扣費，因此專門調低分組倍率來折算匯率：**0.18 × 7 = 1.26**，即站內名義扣費約為官網人民幣價的 1.26 倍。再疊加 [充值加贈](/zh-Hant/faq/recharge-promotions) 後，一般使用者實付約比官網高 10% 左右，充值大客戶基本持平、個別檔位（如 1080p）甚至低於官網。

  **請務必知悉**：系統始終按 **tokens 實際用量**計費，token 折算本身存在小幅浮動折損（±5% 偏差屬正常），官網價也只是一個**參考錨點**，並非逐單對齊的承諾。當前定價為合理的保供口徑，請**疊加充值加贈活動整體核算**。扣費出現異常歡迎隨時聯絡客服對賬溝通；但「為什麼會比官網略高」不在爭辯範圍——介意請慎用。換個角度看，**併發充足、不排隊**正是這條通道的核心價值。
</Note>

兩種推薦配置方式，按業務隔離需要選：

| 配置            | 適用場景         | 配法                                           |
| ------------- | ------------ | -------------------------------------------- |
| **A. 一把令牌通用** | 個人開發、混合呼叫多模型 | 在現有令牌的分組列表中**追加勾選** `SeeDance2`，計費模式保持「按量優先」 |
| **B. 專用令牌**   | 生產業務、需要獨立賬單  | 新建令牌只勾選 `SeeDance2` 分組，便於控量與額度告警             |

<Tip>
  生產業務推薦 **B 專用令牌**：賬單清晰、便於按業務線控量，出現異常消耗時也容易定位。
</Tip>

## 技術規格

| 維度           | 引數                                                                                                                |
| ------------ | ----------------------------------------------------------------------------------------------------------------- |
| **模型名**      | `doubao-seedance-2-0-260128`（標準版）/ `doubao-seedance-2-0-fast-260128`（極速版）/ `doubao-seedance-2-0-mini-260615`（輕量版） |
| **解析度**      | 480p / 720p / 1080p（1080p 僅標準版，fast 與 mini 最高 720p）                                                               |
| **寬高比**      | `16:9` `4:3` `1:1` `3:4` `9:16` `21:9` `adaptive`（預設 adaptive）                                                    |
| **時長**       | 4–15 整數秒，或 `-1` 智慧時長（預設 5 秒）                                                                                      |
| **幀率**       | 固定 24fps（不支援 `frames` 引數）                                                                                         |
| **音訊**       | `generate_audio` 預設 `true`，單聲道                                                                                    |
| **輸入圖片**     | jpeg/png/webp/bmp/tiff/gif/heic/heif；寬高比 (0.4, 2.5)；邊長 (300, 6000)px；單張少於 30MB                                    |
| **輸入影片/音訊**  | 僅 Seedance 2.0 支援；音訊 wav/mp3、單段 2–15s、最多 3 段、需與圖片或影片一起傳                                                           |
| **生成耗時（實測）** | 5 秒 720p 約 2–5 分鐘；1080p 約 3 分鐘；15 秒約 4.5 分鐘；mini 更快（5 秒 720p 約 1.5–2.5 分鐘，15 秒約 3 分鐘）                             |
| **響應欄位**     | `content.video_url`（mp4 直鏈，**24 小時過期**）、`usage.completion_tokens`                                                 |
| **任務儲存**     | task\_id 7 天內可查詢                                                                                                  |

## 端點一覽

| 端點                                                     | 用途              | Content-Type       |
| ------------------------------------------------------ | --------------- | ------------------ |
| `POST /seedance/api/v3/contents/generations/tasks`     | 建立影片生成任務        | `application/json` |
| `GET /seedance/api/v3/contents/generations/tasks/{id}` | 查詢任務狀態 / 獲取影片地址 | —                  |

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

## 解析度與寬高比詳解

解析度檔位定義的是**像素面積**而非短邊，各比例實際輸出畫素值（官方口徑，已實測核對）：

| 寬高比        | 480p          | 720p     | 1080p（僅標準版） |
| ---------- | ------------- | -------- | ----------- |
| `16:9`     | 864×496       | 1280×720 | 1920×1080   |
| `4:3`      | 752×560       | 1112×834 | 1664×1248   |
| `1:1`      | 640×640       | 960×960  | 1440×1440   |
| `3:4`      | 560×752       | 834×1112 | 1248×1664   |
| `9:16`     | 496×864       | 720×1280 | 1080×1920   |
| `21:9`     | 992×432       | 1470×630 | 2206×946    |
| `adaptive` | 模型按輸入自動選擇上述之一 | 同左       | 同左          |

### adaptive 適配規則

1. **文生影片**：根據提示詞內容智慧選擇最合適的寬高比
2. **首尾幀 / 首幀**：根據首幀圖片比例自動選擇最接近的寬高比（圖片比例不一致時居中裁剪）
3. **多模態參考生影片**：按提示詞意圖判斷；否則以傳入的第一個媒體檔案為準（影片優先於圖片）
4. 實際使用的寬高比可在查詢任務響應的 `ratio` 欄位中獲取

<Warning>
  `ratio` 僅支援上表 7 個列舉值，傳 `"2:1"` 等非法比例會直接返回 `InvalidParameter` 錯誤（實測驗證）；`duration` 超出 4–15 範圍同樣報錯。這兩類錯誤**均不扣費**。
</Warning>

## 最佳實踐

<Steps>
  <Step title="按需求選模型">
    要 1080p 或最高畫質選標準版 `doubao-seedance-2-0-260128`；批量出片、成本敏感選輕量版 `doubao-seedance-2-0-mini-260615`（**單價約標準版一半、生成最快**，最高 720p）；畫質與成本折中選 `fast`。
  </Step>

  <Step title="用 adaptive 比例減少裁剪">
    圖生影片場景保持預設 `adaptive`，模型按首幀圖片自動適配，避免居中裁剪損失畫面；明確投放渠道時再固定 `9:16`（豎屏）或 `16:9`（橫屏）。
  </Step>

  <Step title="控制時長就是控制成本">
    費用與時長線性相關。先用 5 秒小批次驗證 prompt，確認效果後再上 10–15 秒；不確定節奏時用 `duration: -1` 讓模型自主決定。
  </Step>

  <Step title="不需要聲音時顯式關閉音訊">
    `generate_audio` 預設開啟。後期要自行配音的場景傳 `false`，輸出純影片畫面更乾淨。
  </Step>

  <Step title="對話放雙引號內最佳化配音">
    需要角色說話時，把臺詞放在雙引號內，如：男人說：「你記住，以後不可以用手指指月亮。」模型會自動生成對應人聲。
  </Step>

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

  <Step title="輪詢 15–30 秒一次，成功後立即下載">
    任務通常 2–5 分鐘完成。`content.video_url` 是 24 小時有效的簽名直鏈，成功後立即轉存到自己的儲存。
  </Step>

  <Step title="用 return_last_frame 量產連續長影片">
    設 `return_last_frame: true` 拿到無水印尾幀 png，作為下一段任務的首幀，即可拼接多段連續影片。
  </Step>
</Steps>

## 錯誤碼與重試

| 狀態碼          | 含義                                                       | 處理建議                           |
| ------------ | -------------------------------------------------------- | ------------------------------ |
| `400`        | `InvalidParameter`：解析度/比例/時長等引數非法（如 fast 或 mini + 1080p） | 錯誤資訊會指明具體引數名，按本頁參數列修正；不扣費      |
| `401`        | 令牌無效                                                     | 檢查 Bearer Token                |
| `403`        | 內容稽核攔截（真人面孔、違規內容）                                        | 更換素材或調整提示詞                     |
| `429`        | 限流 / 餘額不足                                                | 指數退避重試；檢查餘額                    |
| `5xx`        | 閘道 / 後端錯誤                                                | 重試 1–2 次                       |
| 任務 `failed`  | 生成失敗                                                     | 檢視任務響應中的 error 欄位，必要時換 seed 重試 |
| 任務 `expired` | 超過 `execution_expires_after`（預設 48 小時）未完成                | 重新提交                           |

<Info>
  **建議客戶端**：

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

## 常見問題

<AccordionGroup>
  <Accordion title="報「該模型無可用渠道」怎麼辦？">
    這是 Seedance 2.0 最常見的報錯：令牌沒有勾選 `SeeDance2` 分組。預設分組或其他影片分組的令牌無法路由到該模型，請在令牌設定中勾選 `SeeDance2` 分組，且計費模式選「按量優先」。
  </Accordion>

  <Accordion title="Python requests 報 gzip 解碼錯誤 / 返回的 JSON 缺頭不完整？">
    閘道響應頭標了 `content-encoding: gzip` 但 body 實際編碼與之不符。症狀可能是 `ContentDecodingError`，也可能是響應體被截斷成非法 JSON（如開頭丟失 `{"`，只剩 `id":"cgt-xxx"}`），甚至間歇性 400。在請求頭加 `"Accept-Encoding": "identity"` 即可解決；curl 與瀏覽器 fetch 不受影響。
  </Accordion>

  <Accordion title="為什麼生成的影片自帶聲音？怎麼關掉？">
    `generate_audio` 預設為 `true`（實測驗證），模型會自動生成與畫面匹配的人聲、音效和背景音樂。不需要時在請求體顯式傳 `"generate_audio": false`。
  </Accordion>

  <Accordion title="影片地址在哪？為什麼過幾天就打不開了？">
    成功後影片地址在查詢任務響應的 `content.video_url`（**不在頂層**），是約 24 小時有效的簽名直鏈，過期後無法訪問。請在任務成功後立即下載轉存；task\_id 本身儲存 7 天。
  </Accordion>

  <Accordion title="任務成功的狀態值是什麼？">
    狀態機為 `queued → running → succeeded / failed / expired`。注意成功狀態是 **`succeeded`**，不是 `completed`——從其他影片 API 遷移時容易寫錯判斷條件。
  </Accordion>

  <Accordion title="可以上傳真人照片做圖生影片嗎？">
    不可以。Seedance 2.0 不支援直接上傳含真人人臉的參考圖/影片（上游內容安全機制攔截）。替代方案：使用 Seedance 模型近 30 天內生成的含人臉產物做二次創作、使用平臺預置虛擬人像（`asset://` 素材 ID）、或使用已授權真人素材。
  </Accordion>

  <Accordion title="生成失敗或請求被拒會扣費嗎？">
    引數錯誤被拒（HTTP 400）**不扣費**（實測驗證）。計費機制為提交時預扣費、完成後多退少補，所以餘額瞬時值會小幅波動，最終以呼叫日誌為準。
  </Accordion>

  <Accordion title="token 用量怎麼估算？豎屏會更貴嗎？">
    `token ≈ 時長(秒) × 寬 × 高 × 24 / 1024`，公式經實測精確驗證。同分辨率檔位下所有寬高比像素面積相同（如 720p 的 16:9 與 9:16 同為 108,900 tokens / 5 秒），**橫豎屏方形價格完全一樣**。
  </Accordion>

  <Accordion title="標準版、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 引數錯誤（不扣費）。
  </Accordion>

  <Accordion title="duration 設為 -1 是什麼效果？">
    模型在 4–15 秒內自主選擇合適時長（實測生成了 10 秒影片），按實際產出時長計費。實際時長可在查詢任務響應的 `duration` 欄位獲取。對成本敏感時建議固定時長。
  </Accordion>

  <Accordion title="支援 frames 引數生成小數秒影片嗎？">
    不支援。`frames` 與 `camera_fixed` 引數是 Seedance 1.x 的能力，**Seedance 2.0 系列暫不支援**，請用整數 `duration` 控制時長。
  </Accordion>

  <Accordion title="首尾幀、首幀、參考圖可以混用嗎？">
    不可以。首尾幀（2 圖，role 必填 `first_frame`/`last_frame`）、首幀（1 圖）、多模態參考生影片（0～9 圖 + 0～3 影片 + 0～3 音訊，至少 1 圖或 1 影片，圖片 role 均為 `reference_image`）是三種**互斥**場景。需要"首尾幀 + 參考"效果時，可在多模態參考模式下用提示詞指定某張圖作首幀。
  </Accordion>

  <Accordion title="併發有限制嗎？會排隊嗎？">
    SeeDance2 分組併發充足、不排隊（實測 15 任務齊發全部立即執行）。如有更大規模的批次需求，可聯絡商務確認配額。
  </Accordion>

  <Accordion title="提示詞有什麼限制？">
    中文建議不超過 500 字、英文不超過 1000 詞，過長會導致模型忽略細節。支援中、英、日、西、葡、印尼語。建議描述「主體 + 動作 + 鏡頭運動 + 光線/風格」。
  </Accordion>
</AccordionGroup>

## 相關文件

* [影片生成 API 參考與線上除錯](/zh-Hant/api-capabilities/seedance2/video-generation) - `POST /seedance/api/v3/contents/generations/tasks`
* [Sora 2 影片生成](/zh-Hant/api-capabilities/sora-2/overview) - OpenAI 官轉影片通道
* [VEO 3.1 影片生成](/zh-Hant/api-capabilities/veo-3-1-official/overview) - Google 官方影片通道
* [充值加贈活動](/zh-Hant/faq/recharge-promotions) - 疊加後基本持平官網
* [API 使用手冊](/zh-Hant/api-manual) - 通用呼叫規範

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