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 一般需要补扣

一条 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 均可用同一把令牌（追加分组）直接试。