> ## 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 / 2.5 视频生成
> 字节跳动 Seedance 官方资源接入：新版 2.5 与 2.0 标准版 / 极速版 fast / 轻量版 mini 四模型并行，文生视频、首尾帧、多模态参考、视频编辑与延长，同档位全比例同价，默认带同步音频。2.5 支持 30 秒直出、30 张参考图与 mov 输出，与 2.0 系同走 SeeDance2 分组计费。
## 概述
**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` 字段即可。
`POST /seedance/api/v3/contents/generations/tasks`，异步任务式调用，在线调试 + 完整轮询/下载代码。
令牌创建、Base URL、计费模式等通用调用规范。
在 iCover 可视化测试工具里直接调试本接口，无需写代码。
在 API易后台查看已提交的视频任务、下载视频链接（API 之外的查询入口）。
## 让 AI Agent 帮你接入
在用 Codex / Claude Code / Cursor 开发的话，把下面这段提示词复制给它。它会先抓本页的纯文本版（任意文档页地址后加 `.md`），再按你项目的技术栈写代码——异步轮询、**视频直链 24 小时过期要立即转存**、gzip 头的坑、参数红线这几个高频问题已经写死在要求里。
帮我在当前项目里接入 / 排查 Seedance 2.5 / 2.0 的视频生成（文生视频 / 首尾帧 / 多模态参考 / 视频编辑 / 视频延长）。
先读文档再动手：抓 [https://docs.apiyi.com/api-capabilities/seedance2/overview.md](https://docs.apiyi.com/api-capabilities/seedance2/overview.md) 拿到本页纯文本版；接口细节看 video-generation 页，素材库和参考图规则看 asset-library / asset-reference 三页，同样加 `.md` 后缀。
接入要求：
1. 走异步三步，不要写成同步等待。提交 `POST /seedance/api/v3/contents/generations/tasks` 拿任务 ID → 轮询 `GET /seedance/api/v3/contents/generations/tasks/{id}` → 成功后下载视频。三个容易写错的点：**路径前缀是 `/seedance/api/v3`，别漏掉 `/api`，也不要用 `/v1/videos`、`/v1/video/generations`、`/v2/videos/generations` 这类通用视频端点**（原因见「端点一览」）；任务 ID 在响应的顶层 **`id`** 字段（不叫 `task_id`）；**成功状态是 `succeeded` 不是 `completed`**，状态机是 `queued` → `running` → `succeeded` / `failed` / `expired`。轮询节奏：提交后先等 20 到 30 秒再查第一次，之后每 10 到 20 秒查一次，整体等待预算给 15 分钟。
2. 视频落地：地址在 **`content.video_url`**（嵌在 `content` 里，不在顶层）。这是一条 **24 小时过期**的签名直链，拿到后**立即在服务端下载转存到自己的 OSS / CDN**，不要把它存进数据库当长期地址。下载这条直链时**不要带 `Authorization` 头**。任务 ID 本身 7 天内可查。
3. **必须加 `Accept-Encoding: identity` 请求头**（如果你用 Python requests）。网关会标 `content-encoding: gzip` 但响应体其实没压缩，不加这个头会随机遇到 `ContentDecodingError`、JSON 被截断（比如少掉开头的 `{"`）、或者莫名其妙的 400。curl 和浏览器 fetch 不受影响，只有 requests 这类会自动解压的客户端会中招。
4. 关键参数：先选模型——`doubao-seedance-2-5-260628`（2.5，推荐）或 `doubao-seedance-2-0-260128` / `-fast-260128` / `-mini-260615`。`resolution` 是**小写**的 `480p` / `720p` / `1080p`，默认 `720p`，**`1080p` 只有 2.5 和 2.0 标准版支持**，fast 和 mini 传 1080p 会 400；**四个模型都不支持 `4k`**。`ratio` 七选一（`16:9` `4:3` `1:1` `3:4` `9:16` `21:9` `adaptive`），默认 `adaptive`，传枚举外的值（比如 `2:1`）会 400。`duration`：**2.5 是 4 到 30 的整数、缺省值是 `-1`**（不传就由模型自己定时长，实测会选到 10 秒以上，费用随之变化，**对成本敏感就显式传**）；2.0 系是 4 到 15、缺省 5。**`generate_audio` 默认是 `true`**，要静音必须显式传 `false`。另外 `frames` / `camera_fixed` 是 Seedance 1.x 的参数，本系列不支持，别传。
5. 参考图与素材：图片通过 `content[]` 里的 `{"type":"image_url", ...}` 传，值可以是公网 URL、Base64 data URI，或者素材库 ID（`asset://...`）。模式互斥：首尾帧（2 张图，`role` 必填 `first_frame` / `last_frame`）、首帧（1 张图）、多模态参考（**2.5 最多 30 图 + 10 视频 + 10 音频，且音频可以单独用**；2.0 系是 9 图 + 3 视频 + 3 音频，音频必须搭配图或视频）。单图小于 30MB、边长 300 到 6000px、宽高比 0.4 到 2.5。**含真人面孔的图会被上游审核拒掉**——这类素材要先登记进素材库、再用 `asset://` 引用，且提示词里要用「图片1」「图片2」按顺序指代，**不要把素材 ID 写进提示词**。
6. **只有 2.5 才有的两条硬约束，写错会直接 400**：首帧 / 首尾帧、视频编辑、视频延长这三类任务的 `ratio` **必须是 `adaptive`**，不能指定具体宽高比；视频编辑任务的 `duration` **必须是 `-1`**，且待编辑视频时长要在 4 到 30 秒内。做编辑或延长时建议显式传 `omni_reference_task_type`（`edit` / `extend` / `auto`），这样参数不合法会在提交时同步报 `InvalidParameter.TaskTypeConstraint`，而不是等几分钟后任务失败。2.5 还支持 `output_format`（`mp4` 默认 / `mov`），mov 是专业后期用的高色彩精度格式，部分播放器不兼容。
7. 计费与错误：按 token 计费，量级由 **分辨率面积 × 时长**决定，同分辨率下所有比例同价。**日志里一条视频会出现两条扣费记录**（提交时预扣、完成后多退少补），这是正常的，总花费是两条之和，不要当成重复扣费。400 参数错误不计费；`PUBLIC_` 前缀的错误是上游内容审核拦截，同样不计费，调整素材或提示词后可重试。报「该模型无可用渠道」是令牌分组不对——**2.5 与 2.0 系都走 `SeeDance2` 分组**（mini / fast 另有特价的 `SD2Mini` / `SD2Fast`），且计费模式为按量优先或按量计费。生成失败（含审核拦截）**不要拿同一条提示词反复重试**。
8. Key 从环境变量 `APIYI_API_KEY` 读，不要硬编码进代码、也不要提交进 git。
9. 改完真跑一次文生视频 + 一次首帧图生视频，把生成的视频和这两次调用的花费贴给我。注意整个流程要几分钟，如果你在受限的执行环境里跑，记得把命令超时放到 600 秒以上或者放后台。
| 要求 | 挡掉的坑 |
| - | - |
| 成功状态是 `succeeded` | 从别的视频模型迁过来最容易写成 `completed`，结果永远轮询不到成功 |
| 任务 ID 是顶层 `id` | 不叫 `task_id`；视频地址也嵌在 `content.video_url` 而不是顶层 |
| 加 `Accept-Encoding: identity` | 网关 gzip 头与实际不符，Python requests 会随机报解码错误或截断 JSON |
| 立即下载转存 | 直链 24 小时过期，且下载时带 `Authorization` 反而会失败 |
| 两条扣费记录是正常的 | 提交预扣 + 完成结算，不是重复计费，总额是两条之和 |
| 真人面孔走素材库 | 直接传真人照片会被上游审核拒绝，要先登记再用 `asset://` 引用 |
| 2.5 的 `duration` 缺省是 `-1` | 不显式传时长，模型会自己选（实测选到 10 秒），费用跟着翻倍 |
| 2.5 三类任务 `ratio` 必须 `adaptive` | 首尾帧 / 编辑 / 延长指定具体宽高比会直接 400 |
## 为什么选 API易 的 Seedance？
先说定位：该模型**官方没有折扣，平台也非盈利型定价**，上架以**保障供给、方便客户**为主。选 API易 的核心价值不在"更便宜"，而在接入与使用体验：
火山引擎中国国内版官方资源（非 BytePlus 海外版），自带上游内容安全机制，参数、响应、计费口径与官方完全一致。
通道自带上游**虚拟人脸白名单**权限，AI 生成人脸、虚拟人像素材可直接用于图生视频，无需自行向官方申请白名单（真人人脸仍受上游内容安全机制限制）。
人物一致性所需的[私域素材库](/api-capabilities/seedance2/asset-library)（虚拟人像入库 + 真人认证）在 API易 **免费使用**——官方侧这项能力对非框架签约客户需十万元量级的年费单独采购，我们把它包含在接口价格里。
官方无折扣、平台也不靠它盈利：单价对齐火山引擎官网（站内扣费约上浮 10%），叠加 [充值加赠活动](/faq/recharge-promotions) 后**基本持平官网**，充值大客户个别档位甚至更低。
实测 15 个任务同时提交全部立即进入 `running`，无排队等待（2026-06-06 (UTC+8) 实测），适合批量生产场景直接放量。
**无需火山引擎账号、免官网实名认证、无消费门槛**（免 200 元开通费与企业认证流程），国内机房、家宽网络、海外节点均可直连 `api.apiyi.com`，一把令牌即用。
站内同时提供 [VEO 3.1](/api-capabilities/veo-3-1-official/overview)、[Wan2.7](/api-capabilities/wan/overview) 等视频通道，可按场景混搭选型。
团队深耕视频生成场景，具备丰富的选型、调优与集成经验，可为企业客户提供从 PoC 到生产上线的完整技术支持。
## 核心特性
480p / 720p / 1080p（**1080p 仅 2.5 与 2.0 标准版**，fast 与 mini 最高 720p）。同档位下 16:9、9:16、1:1 等所有比例**像素面积相同、价格相同**，横竖屏切换零成本。
`generate_audio` 默认开启，自动生成与画面匹配的人声、音效、背景音乐；对话内容放在双引号内可显著优化配音效果。
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` 固定随机性（相同请求生成类似结果），`watermark` 默认关闭，输出无水印。
## 模型定价
**一句话理解定价 —— 按 token 精确计费，分档对齐火山引擎官网。** 四个模型**价格不同**：轻量版 `mini` \< 极速版 `fast` \< 标准版 \< **2.5**（与官网同方向，mini 单价约为标准版一半、2.5 约为标准版 1.5 倍，**并非同一价格水平**）。该系列**官方没有折扣**，本通道是**纯官转 + 保供**定位，不以盈利为目的。定价按「充值大客户送 20%」的标准定：名义扣费为官网价的 1.26 倍（0.18 倍率 × 1:7 固定汇率），叠加 20% [充值加赠](/faq/recharge-promotions) 后**约为官网价的 1.05 倍**，这 5% 的溢价主要用于覆盖开具专票的 6% 税务成本；一般用户叠加 10% 加赠后约为官网价的 1.15 倍。按面积×时长结算，**±5% 的偏差属正常现象**，欢迎随时测试、对账与沟通核对。
单价之外，本通道的价值在两处：**开白名单可生成真人人像**（官方默认拦截），以及人物一致性所需的\*\*[素材库](/api-capabilities/seedance2/asset-library)在 API易 免费包含\*\*（官方侧对非框架签约客户需十万元量级的年费单独采购）。这两项都不计入上述单价对比。
按 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 | 不支持 | 不支持 |
**表 ② 里的价格仍然是「输出 5 秒」的价格**，区间只随输入视频的长度（2～15 秒）变化——¥30.13 对应「输出 5 秒 + 输入 15 秒」，**不是**输出 15 秒。含输入视频时，计费时长 = **输入视频时长 + 输出视频时长**，两边都按输出分辨率折算成帧数计费；另有最低 token 用量限制，过短输入按最低用量计费。准确用量以返回的 `usage.completion_tokens` 为准。
**算例**（标准版 1080p，输出 12 秒 + 参考视频 12 秒）：1080p 每帧 1920 × 1080 ÷ 1024 = 2025 tokens，输出 24 × 12 + 1 = 289 帧、输入折算 288 帧，共 577 × 2025 = 1,168,425 tokens。官方含视频输入档约 ¥0.031/千 tokens → 官方价约 **¥36.2**；站内名义扣费 \$6.52（¥45.6），充值大客户叠加 20% 加赠后约 ¥38.0。这一单与表 ② 任何一格都不对应，因为输出不是 5 秒。
**站内实测对照表**（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 |
**站内实测（输入包含视频）**（2026-09-12 实测，标准版 1080p / 9:16 / 无音频 / 参考视频 12 秒；¥ 按 1:7 固定汇率折算）：
| 模型 | 分辨率 | 输出时长 | 输入视频 | tokens | APIYI 花费 | 费用（¥） | 一般折扣 ÷1.1（¥） | 充值大客户 ÷1.2（¥） | 官方参考价（¥） |
| - | - | - | - | - | - | - | - | - | - |
| `doubao-seedance-2-0-260128` | 1080p | 12s | 12s | 1,168,425 | \$6.5198 | ¥45.64 | ¥41.49 | ¥38.03 | ≈ ¥36.2 |
含输入视频走**单独一档更低的 token 单价**（这条 1080p 实测为 \$5.58 / 百万 tokens，不含视频的 1080p 为 \$8.28），但输入视频的每一秒都按输出分辨率折算成 tokens 一并计费，所以总价通常反而更高。**想省钱先剪短参考视频**，再考虑降分辨率。
**三个模型价格不同，切勿等同。** 相同分辨率/时长下的 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% [充值加赠](/faq/recharge-promotions) 后的实付等效价——可见**充值大客户实付约为官网参考价的 1.05 倍，一般用户约 1.15 倍**。准确用量以返回的 `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。
**① 输入不含视频**（纯文生 / 图生 / 参考图）：
| 分辨率 | 时长 | tokens | APIYI 花费 | 费用（¥） | 一般折扣 ÷1.1（¥） | 充值大客户 ÷1.2（¥） |
| - | - | - | - | - | - | - |
| 480p | 4s | 38,830 | \$0.4893 | ¥3.42 | ¥3.11 | ¥2.85 |
| 480p | 5s | 48,437 | \$0.6103 | ¥4.27 | ¥3.88 | ¥3.56 |
| 720p | 5s | 108,900 | \$1.3721 | ¥9.60 | ¥8.73 | ¥8.00 |
| 720p | 10s | 216,900 | \$2.7329 | ¥19.13 | ¥17.39 | ¥15.94 |
| 720p | 30s | 648,900 | \$8.1761 | ¥57.23 | ¥52.03 | ¥47.69 |
| 1080p | 5s | 245,025 | \$3.0873 | ¥21.61 | ¥19.65 | ¥18.01 |
**② 输入包含视频**（多模态参考带 `video_url`、视频编辑、视频延长）：走**单独一档更低的 token 单价**。
| 分辨率 | 输出时长 | 输入视频 | tokens | APIYI 花费 | 费用（¥） |
| - | - | - | - | - | - |
| 480p | 4s | 约 5 秒 | 86,867 | \$0.6567 | ¥4.60 |
单价更低不等于总价更低：含输入视频时 **计费 token =（输入视频时长 + 输出时长）× 面积**，token 数本身就多了。上面这条 86,867 tokens 若按①的单价要 \$1.0945，走②只要 \$0.6567。
**两档 token 单价**：
| 档位 | \$ / 百万 tokens |
| - | - |
| ① 输入不含视频（480p / 720p / 1080p 同价） | **\$12.60** |
| ② 输入包含视频 | **\$7.56** |
表中 token 数与两档单价均取自实际扣费日志（2026-08-31 复核），非按倍率估算。叠加 [充值加赠](/faq/recharge-promotions) 后，充值大客户的实付价与官网参考价基本持平。
**三个最容易多花钱的地方**：
1. **`duration` 缺省值是 `-1`**（2.0 系是 5）。不显式传时长，2.5 会自己在 4–30 秒里挑——实测一条没传 duration 的请求出了 10 秒视频，费用正好是 5 秒的两倍。**对成本敏感一定要显式传 `duration`。**
2. **30 秒是 5 秒的 6 倍价**（720p 下 ¥57.23 对 ¥9.60）。时长与费用严格线性，先用 5 秒验证提示词，确认效果再上长片。
3. **参考视频的时长也计费**。带 `video_url` 时，输入视频每一秒都按输出分辨率折算成 tokens，与输出时长一起结算——2.0 / 2.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 固定汇率折算，仅供参考）：
| 模型 | 分辨率 / 时长 | 常规分组 `SeeDance2`（0.18x） | 特价分组 | 特价扣费 | 降幅 |
| - | - | - | - | - | - |
| `mini` | 720p / 5s | \$0.4508（¥3.16） | `SD2Mini` | **\$0.2504（¥1.75）** | −44.4％ |
| `mini` | 480p / 4s | \$0.1681（¥1.18） | `SD2Mini` | **\$0.0934（¥0.65）** | −44.4％ |
| `mini` | 720p / 15s | \$1.3451（¥9.42） | `SD2Mini` | **\$0.7473（¥5.23）** | −44.4％ |
| `fast` | 720p / 5s | \$0.7253（¥5.08） | `SD2Fast` | **\$0.6044（¥4.23）** | −16.7％ |
| `fast` | 480p / 5s | \$0.3373（¥2.36） | `SD2Fast` | **\$0.2811（¥1.97）** | −16.7％ |
| `fast` | 720p / 4s | \$0.5814（¥4.07） | `SD2Fast` | **\$0.4845（¥3.39）** | −16.7％ |
| `fast` | 720p / 8s | \$1.1568（¥8.10） | `SD2Fast` | **\$0.9640（¥6.75）** | −16.7％ |
同一模型、同一规格，走特价分组 **mini 省 44.4％、fast 省 16.7％**；上面的降幅是纯粹的分组倍率下调，与 [充值加赠](/faq/recharge-promotions) 互不冲突，可以叠加计算。计费方式不变，仍按 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 一般需要补扣**
补扣那条日志**不展示令牌、也不展示所在分组**，属正常现象；两条金额相加才是这条视频的总成本。
**时间字段怎么读**：
1. 第一条（预扣费）日志的「时间」就是这条视频的**提交时间**；它的「首字节」是提交任务、返回任务 ID 的耗时（如 `首字节:3秒`）——**不是**视频生成耗时
2. 第二条多退少补记录显示 `流式`、`首字节:<1秒`，这只是结算记录自身的标记，**不代表任何异常**，无需在意
3. 视频真正的**生成耗时**，看顶部导航「异步任务」页（`api.apiyi.com/task`）的「耗时」列
以第一张截图那条 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），与计费公式吻合。
这条 15 秒 1080p 视频合计约 **¥42.4**（名义扣费，1:7 固定汇率折算），叠加 [充值加赠](/faq/recharge-promotions) 后实付约 ¥35～39，官方同规格参考价约 ¥37.2——**官方定价本身就不便宜**，成本由**模型 + 分辨率 + 时长**共同决定（换 fast / 720p / 5 秒则便宜得多）。本模型为微利保供，充值大客户有更多折扣。
**内测期说明**：Seedance 2.5 / 2.0 目前处于内测供给阶段，若实际扣费与上表偏差较大，欢迎联系客服沟通核对。平台会随官方政策（如官方后续推出更低价的版本）与 APIYI 供给能力动态调整价格，也欢迎有实力的渠道方洽谈合作。该模型以**保障供给、服务客户**为主，并非盈利型定价。
### 按任务 ID 查一条视频花了多少：用任务接口
程序化对账时，**不要拿日志 API 去逐单配对**：一条视频的两条日志里都没有 `task_id`，结算那条连 `request_id` 都是空的（走文档路径 `/seedance/api/v3/...` 时如此）。正确做法是用**任务接口**按 `task_id` 直接查，认证与[日志查询 API](/api-capabilities/log-query) 同一把系统令牌：
```bash theme={null}
curl --compressed -s "https://api.apiyi.com/api/task/self?p=1&page_size=1&task_id=cgt-20260915152401-grlz4" \
-H "Authorization: $APIYI_SYS_TOKEN" | jq '.data.items[0] | {task_id, status, quota, submit_time, finish_time, model_name}'
```
返回的 **`quota` 就是这条视频的总消费**（预扣 + 补扣之和，÷ 500,000 = 美元），与日志两条相加、与「异步任务」页详情里的 `quota` 是同一个数。按 `status` 判断：
| `status` | `quota` 的含义 | 这条视频的真实消费 |
| - | - | - |
| `completed` | 最终结算总额 | = `quota` |
| `submitted` / `in_progress` | 只是提交时的预扣额 | 以完成后为准 |
| `failed` | **仍显示预扣额**（并未被清零） | **0**：预扣已全额退回，日志里对应一条 `type=11` 的负数退款行 |
注意两套词表不同：视频查询接口 `/seedance/api/v3/.../tasks/{id}` 的成功状态是 `succeeded`，任务接口 `/api/task/self` 的成功状态是 `completed`。
**任务接口的分页参数与日志 API 相反**：这里是下划线 `page_size`、页码 `p` 从 **1** 开始；日志 API 是驼峰 `pageSize`、`p` 从 0 开始。写错不报错，只会拿到默认分页。已验证可用的过滤参数：`task_id`、`model_name`、`start_timestamp` / `end_timestamp`（Unix 秒）。
如果一定要在日志 API 里人工核对：结算行的「时间」等于任务的 `finish_time`（相差不超过 1 秒）、`completion_tokens` 等于任务返回的 `usage.completion_tokens`、`other.final_quota` 等于任务的 `quota`、`other.original_quota` 是预扣额。同一秒批量提交多条任务时预扣行会撞在一起，所以这只适合人工核对，不适合程序配对。完整说明见 [如何按 task\_id 查一条视频的真实消费](/faq/seedance-task-cost-lookup)。
## 分组介绍
Seedance 2.5 与 2.0 系都走**专属分组**，有两个**强制条件**：① 令牌计费模式必须选「**按量优先**」或「按量计费」（按次计费无法路由）；② 令牌必须勾选**对应分组**——使用默认分组或其他视频分组的令牌会报「**该模型无可用渠道**」。
目前共三个分组。**2.5 与 2.0 系同走 `SeeDance2`**，另有两个限时特价分组，每个只对一个模型开放：
| 分组 | 倍率 | 可用模型 | 说明 |
| - | - | - | - |
| `SeeDance2` | 0.18x | **四个模型全部**（2.5 / 标准版 / fast / mini） | 2.5 与标准版的唯一入口；特价到期后的兜底分组，并发充足不排队 |
| `SD2Mini` | **0.10x** | 仅 `doubao-seedance-2-0-mini-260615` | 🔥 限时特价，较原倍率降 **44.4％**，截至 2026-10-07 23:59 (UTC+8) |
| `SD2Fast` | **0.15x** | 仅 `doubao-seedance-2-0-fast-260128` | 🔥 限时特价，较原倍率降 **16.7％**，截至 2026-10-07 23:59 (UTC+8) |
**一把 `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 就是这么来的，不是打折，也不是加价**。
该系列**官方没有折扣**，本通道是保供定价。名义扣费默认略高于官网参考价，叠加 [充值加赠](/faq/recharge-promotions) 后基本抹平：**充值大客户实付仅上浮约 5%**，个别档位（如 1080p）甚至低于官网。
**2.5 也是同一个 0.18x。** 两代的价差来自模型本身的单价（官方对 2.5 的定价本就高于 2.0），不是靠分组倍率区分——所以 2.5 与 2.0 系走的是同一套折算口径。
**请务必知悉**：系统始终按 **tokens 实际用量**计费，token 折算本身存在小幅浮动折损（±5% 偏差属正常），官网价也只是一个**参考锚点**，并非逐单对齐的承诺。当前定价为合理的保供口径，请**叠加充值加赠活动整体核算**。扣费出现异常欢迎随时联系客服对账沟通；但「为什么会比官网略高」不在争辩范围——介意请慎用。换个角度看，**并发充足、不排队**正是这条通道的核心价值。
此外，**[素材库](/api-capabilities/seedance2/asset-library)（虚拟人像入库 / 真人认证）在本通道免费包含**——官方侧需十万元量级的年费单独采购，这也是这条通道的实际价值之一。
### 令牌怎么配
**不追特价**：建一把令牌、勾 `SeeDance2` 分组即可，**四个模型全能调**，下表可以跳过。
**想吃优惠期的特价**：`mini` 与 `fast` 另有单模型专属分组，按下表拆令牌：
| 令牌 | 主分组 | 跑什么 |
| - | - | - |
| **A（新建 · 特价）** | `SD2Mini` | 只跑 `doubao-seedance-2-0-mini-260615`，享 0.10x |
| **B（新建 · 特价）** | `SD2Fast` | 只跑 `doubao-seedance-2-0-fast-260128`，享 0.15x |
| **C（原有 · 主力）** | `SeeDance2` | 跑 2.5 与 2.0 标准版；10 月 7 日之后 2.0 系全部回到这一把 |
所有令牌的计费模式都必须是「按量优先」或「按量计费」。只用 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 倍。差异全表见下方「技术规格」。
## 技术规格
| 维度 | Seedance 2.5 | Seedance 2.0 系（标准版 / fast / mini） |
| - | - | - |
| **模型名** | `doubao-seedance-2-5-260628` | `doubao-seedance-2-0-260128` / `-fast-260128` / `-mini-260615` |
| **分辨率** | 480p / 720p / **1080p**（无 4k） | 480p / 720p / 1080p（1080p 仅标准版，fast 与 mini 最高 720p） |
| **视频编码** | 1080p 输出 **H.265（hvc1）**，480p / 720p 为 H.264（avc1） | H.264（avc1） |
| **宽高比** | 同右；**首尾帧 / 编辑 / 延长任务强制 `adaptive`** | `16:9` `4:3` `1:1` `3:4` `9:16` `21:9` `adaptive`（默认 adaptive） |
| **时长** | **4–30** 整数秒，或 `-1` 智能时长（**缺省即 `-1`**） | 4–15 整数秒，或 `-1` 智能时长（默认 5 秒） |
| **帧率** | 固定 24fps（不支持 `frames` 参数） | 同左 |
| **输出格式** | `output_format`：`mp4`（默认）/ **`mov`**（H.264 + yuv444p + PCM，专业后期用） | 仅 mp4 |
| **音频** | `generate_audio` 默认 `true`，单声道 | 同左 |
| **参考素材上限** | **30 张图 + 10 个视频 + 10 段音频**；**音频可单独作为唯一参考** | 9 张图 + 3 个视频 + 3 段音频；音频需与图片或视频一起传 |
| **任务类型参数** | `omni_reference_task_type`：`auto` / `edit`（视频编辑）/ `extend`（视频延长） | 不支持 |
| **输入图片** | jpeg/png/webp/bmp/tiff/gif/heic/heif；宽高比 (0.4, 2.5)；边长 (300, 6000)px；单张少于 30MB | 同左 |
| **生成耗时（实测）** | 480p/4s 约 1.5–5 分钟；720p/5s 约 2.5 分钟；**720p/30s 约 5.5 分钟**；1080p/5s 约 2.5 分钟 | 5 秒 720p 约 2–5 分钟；1080p 约 3 分钟；15 秒约 4.5 分钟；mini 更快（5 秒 720p 约 1.5–2.5 分钟） |
| **响应字段** | `content.video_url`（直链，**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}` | 查询任务状态 / 获取视频地址 | — |
**域名选择**：`api.apiyi.com` 为主域名，也可使用 `b.apiyi.com` 等平台提供的其他网关域名。注意路径前缀是 `/seedance/api/v3`，**不要漏掉 `/api`**。
**不要用通用视频端点提交 Seedance 任务**：`/v1/videos`、`/v1/video/generations`、`/v2/videos/generations` 这几条网关通用端点目前对 Seedance 的 `resolution` 参数透传不完整——实测 **2.5 请求 480p 会按 720p 出片、2.0 系请求 1080p 会按 720p 出片**，而计费按实际出片的 tokens 结算，前者会多付 2.25 倍。问题已定位、修复中（2026-09-14）；修复前请一律走本页的 `/seedance/api/v3/...` 端点，分辨率在这条路径上是正常的。若你已在通用端点上遇到分辨率不符的扣费，联系客服按请求分辨率退差额。
## 分辨率与宽高比详解
分辨率档位定义的是**像素面积**而非短边，各比例实际输出像素值（官方口径，已实测核对）：
| 宽高比 | 480p | 720p | 1080p（仅 2.5 / 标准版） |
| - | - | - | - |
| `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` | 模型按输入自动选择上述之一 | 同左 | 同左 |
**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，不是等任务跑完才失败）。
## 最佳实践
**先看要不要 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`。
带素材调用时，创建任务接口的耗时主要花在**素材上行**上——内联 Base64 或大图 URL 会让提交阶段从秒级拖到几十秒甚至读超时。先把素材入库拿 `asset://` 素材 ID 再引用，请求体只剩几十字节，提交即刻返回任务 ID，合规校验也提前到入库那一步。详见 [素材优先实践](/api-capabilities/seedance2/asset-first-workflow)。
图生视频场景保持默认 `adaptive`，模型按首帧图片自动适配，避免居中裁剪损失画面；明确投放渠道时再固定 `9:16`（竖屏）或 `16:9`（横屏）。
费用与时长严格线性。先用 5 秒小批量验证 prompt，确认效果后再上长片（2.5 最长 30 秒，价格是 5 秒的 6 倍）。**用 2.5 时务必显式传 `duration`**——它的缺省值是 `-1`，不传就由模型自选时长，实测会选到 10 秒，费用直接翻倍。
`generate_audio` 默认开启。后期要自行配音的场景传 `false`，输出纯视频画面更干净。
需要角色说话时，把台词放在双引号内，如：男人说：「你记住，以后不可以用手指指月亮。」模型会自动生成对应人声。
网关响应头会标 `content-encoding: gzip` 但 body 实际未压缩，Python requests 等自动解压的客户端会报 `ContentDecodingError`。请求头加 `Accept-Encoding: identity` 即可规避（curl 不受影响）。
任务通常 2–5 分钟完成。`content.video_url` 是 24 小时有效的签名直链，成功后立即转存到自己的存储。
设 `return_last_frame: true` 拿到无水印尾帧 png，作为下一段任务的首帧，即可拼接多段连续视频。
## 错误码与重试
| 状态码 | 含义 | 处理建议 |
| - | - | - |
| `400` | `InvalidParameter`：分辨率/比例/时长等参数非法（如 fast 或 mini + 1080p、任意模型 + 4k、2.5 + `duration: 31`） | 错误信息会指明具体参数名，按本页参数表修正；不扣费 |
| `400` | `InvalidParameter.TaskTypeConstraint`（**仅 2.5**）：参数与任务类型冲突 | 首尾帧 / 编辑 / 延长任务的 `ratio` 改为 `adaptive`；编辑任务的 `duration` 改为 `-1`；不扣费 |
| 任务 `failed` + `InvalidParameter.TaskTypeMismatch` | **仅 2.5**：显式声明的 `omni_reference_task_type` 与模型按提示词判定的任务类型不符 | 按目标任务类型调整提示词关键词（编辑用「增加/删除/替换」，延长用「向后延长/续写」），或改用 `auto` |
| `401` | 令牌无效 | 检查 Bearer Token |
| `403` | 内容审核拦截（真人面孔、违规内容） | 更换素材或调整提示词 |
| `429` | 限流 / 余额不足 | 指数退避重试；检查余额 |
| `5xx` | 网关 / 后端错误 | 重试 1–2 次 |
| 任务 `failed` | 生成失败 | 查看任务响应中的 error 字段，必要时换 seed 重试 |
| 任务 `expired` | 超过 `execution_expires_after`（默认 48 小时）未完成 | 重新提交 |
**建议客户端**：
* 创建/查询请求超时 **30–60 秒**即可（异步接口本身很快，耗时在任务侧）
* 轮询间隔 15–30 秒，整体等待预算 **15 分钟**起步（1080p / 15 秒任务更长）
* 对 5xx 与超时做 **指数退避重试**（建议 2 次）
* 记录任务 `id` 与响应头 `X-Shellapi-Request-Id`（API易 的请求 ID，日志里可按它检索；`X-Request-Id` 是原厂的）方便排查
## 常见问题
慢的是**提交**，不是生成。素材要先从你的机器上行到 API易，再由我们转发到火山引擎并完成解码校验，这一整段走完才会返回任务 ID——所以内联 Base64 或大体积图片 URL 时，这一步会从秒级拖到几十秒，客户端读超时设 60 秒都可能不够。生成本身通常 2–5 分钟，是原厂的正常速度，与提交阶段无关。
根治办法是**先把素材入库拿 `asset://` 素材 ID 再引用**，请求体从数 MB 降到几十字节。耗时拆解、迁移步骤、以及超时之后怎么判断任务是否已创建，见 [素材优先实践](/api-capabilities/seedance2/asset-first-workflow)。
**按需要的能力选，不必默认上 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 系列最常见的报错，**九成是令牌分组勾错了**。报错原文会点名当前分组，例如：
```
Current group SeeDance2 has no available channels
for model doubao-seedance-2-5-260628
```
按模型对号入座，在令牌设置里勾上对应分组：
| 你要调的模型 | 需要勾选的分组 |
| - | - |
| `doubao-seedance-2-5-260628` | `SeeDance2` |
| `doubao-seedance-2-0-260128` | `SeeDance2` |
| `doubao-seedance-2-0-fast-260128` | `SeeDance2` 或 `SD2Fast` |
| `doubao-seedance-2-0-mini-260615` | `SeeDance2` 或 `SD2Mini` |
一把勾了 `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 接口的客户，正常业务量内不额外计费。用法见 [素材库](/api-capabilities/seedance2/asset-library)。
参数错误被拒（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 词，过长会导致模型忽略细节。支持中、英、日、西、葡、印尼语。建议描述「主体 + 动作 + 镜头运动 + 光线/风格」。
## 相关文档
* [视频生成 API 参考与在线调试](/api-capabilities/seedance2/video-generation) - `POST /seedance/api/v3/contents/generations/tasks`
* [素材优先实践](/api-capabilities/seedance2/asset-first-workflow) - 带图带视频时怎么让创建任务接口秒回，以及超时后的处理
* [VEO 3.1 视频生成](/api-capabilities/veo-3-1-official/overview) - Google 官方视频通道
* [充值加赠活动](/faq/recharge-promotions) - 叠加后基本持平官网
* [API 使用手册](/api-manual) - 通用调用规范
Seedance 是 2026 年视频生成第一梯队模型中**少数默认输出同步音频**的选择，配合全比例同价与 2.5 的 30 秒时长上限，适合作为短视频/电商素材量产的主力通道。需要对比选型时，站内 Sora 2、VEO 3.1、Wan2.7 均可用同一把令牌（追加分组）直接试。
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.