> ## 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="/api-capabilities/seedance2/video-generation">
    `POST /seedance/api/v3/contents/generations/tasks`，异步任务式调用，在线调试 + 完整轮询/下载代码。
  </Card>

  <Card title="API 使用手册" icon="book-open" href="/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%），叠加 [充值加赠活动](/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](/api-capabilities/veo-3-1-official/overview)、[Sora 2](/api-capabilities/sora-2/overview)、[Wan2.7](/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 倍**，叠加 [充值加赠](/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% [充值加赠](/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 固定汇率折算），叠加 [充值加赠](/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 倍。再叠加 [充值加赠](/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 参考与在线调试](/api-capabilities/seedance2/video-generation) - `POST /seedance/api/v3/contents/generations/tasks`
* [Sora 2 视频生成](/api-capabilities/sora-2/overview) - OpenAI 官转视频通道
* [VEO 3.1 视频生成](/api-capabilities/veo-3-1-official/overview) - Google 官方视频通道
* [充值加赠活动](/faq/recharge-promotions) - 叠加后基本持平官网
* [API 使用手册](/api-manual) - 通用调用规范

<Info>
  Seedance 2.0 是 2026 年视频生成第一梯队模型中**少数默认输出同步音频**的选择，配合全比例同价与 15 秒时长上限，适合作为短视频/电商素材量产的主力通道。需要对比选型时，站内 Sora 2、VEO 3.1、Wan2.7 均可用同一把令牌（追加分组）直接试。
</Info>
