概述
doubao-seedance-2-0-260128（标准版）与 doubao-seedance-2-0-fast-260128（极速版）是字节跳动最新一代视频生成模型，通过 API易 接入火山引擎中国国内版官方资源（非 BytePlus 海外版），自带上游内容安全机制，合规性更好。支持文生视频、首帧/首尾帧图生视频、1–9 张参考图、参考视频/音频等多模态输入，并能自动生成与画面同步的人声、音效与背景音乐。🎬 核心亮点：4–15 秒可控时长（支持
-1 智能时长）、480p/720p/1080p 三档分辨率、6 种宽高比 + adaptive 自适应、默认输出带同步音频、多语言提示词（中英日西葡印尼）。适合短视频量产、电商素材、动效设计、虚拟人内容等生产场景。视频生成 API 参考
POST /seedance/api/v3/contents/generations/tasks，异步任务式调用，在线调试 + 完整轮询/下载代码。API 使用手册
令牌创建、Base URL、计费模式等通用调用规范。
为什么选 API易 的 Seedance 2.0？
对标火山引擎官方通道，针对企业生产场景在 稳定性、成本、接入体验 三方面做了深度优化：官方资源 · 国内版直连
火山引擎中国国内版官方资源（非 BytePlus 海外版），自带上游内容安全机制，参数、响应、计费口径与官方完全一致。
不限并发 · 不排队
实测 15 个任务同时提交全部立即进入
running，无排队等待（2026-06-06 (UTC+8) 实测），适合批量生产场景直接放量。价格对齐官网 + 充值加赠
单价对齐火山引擎官网（站内扣费约上浮 10%），叠加 充值加赠活动 后基本持平官网，免去 200 元开通门槛与企业认证流程。
全球零门槛接入
无需火山引擎账号、无需实名认证，国内机房、家宽网络、海外节点均可直连
api.apiyi.com，一把令牌即用。专业服务 · 企业陪跑
团队深耕视频生成场景，具备丰富的选型、调优与集成经验，可为企业客户提供从 PoC 到生产上线的完整技术支持。
核心特性
三档分辨率 · 全比例同价
480p / 720p / 1080p（1080p 仅标准版）。同档位下 16:9、9:16、1:1 等所有比例像素面积相同、价格相同，横竖屏切换零成本。
默认同步音频
generate_audio 默认开启，自动生成与画面匹配的人声、音效、背景音乐；对话内容放在双引号内可显著优化配音效果。4–15 秒可控时长
duration 支持 4–15 整数秒，或设为 -1 由模型智能选择时长（按实际产出计费）。帧率固定 24fps。多语言提示词
中文（≤500 字）、英文（≤1000 词），额外支持日语、西班牙语、葡萄牙语、印尼语。
首帧 / 首尾帧生视频
传 1 张图作首帧，或 2 张图严格控制首尾画面；配合
return_last_frame 可把尾帧接力为下一段首帧，量产连续长视频。多模态参考生视频
1–9 张参考图 + 参考视频 + 参考音频自由组合（三种图生场景互斥），保持角色与风格一致性。
异步任务式调用
提交即返回
task_id，轮询查询，成功后从 content.video_url 下载 mp4（URL 24 小时有效）。seed 可复现
支持
seed 固定随机性（相同请求生成类似结果），watermark 默认关闭，输出无水印。模型定价
按 token 计费：token 数 ≈ 视频时长(秒) × 宽 × 高 × 24 / 1024（公式经实测精确验证，偏差少于 0.1%）。同分辨率档位下所有宽高比像素面积相同，因此价格只取决于分辨率档位和时长。官方公开价格口径（16:9 / 5 秒 / 无输入视频）：
| 分辨率 | 极速版 fast | 标准版 |
|---|---|---|
| 480p | ¥1.86 | ¥2.31 |
| 720p | ¥4.00 | ¥4.97 |
| 1080p | 不支持 | ¥12.39 |
| 分辨率 | 每 5 秒 | 每秒价格 | 每秒价格（¥） | 最多折扣 | 最多折扣（¥） |
|---|---|---|---|---|---|
| 480p | ≈$0.37 | $0.073/s | ¥0.51/s | $0.061/s | ¥0.43/s |
| 720p | ≈$0.79 | $0.157/s | ¥1.10/s | $0.131/s | ¥0.92/s |
| 1080p | ≈$1.77 | $0.354/s | ¥2.48/s | $0.295/s | ¥2.07/s |
计费说明：
- 实际扣费以控制台模型价格和调用日志为准；因税率、汇率与上游结算差异，站内扣费可能在官方原价基础上上浮 10% 左右，叠加 充值加赠 后基本持平官网
- 提交任务时预扣费，任务完成后多退少补；余额瞬时值会小幅波动，对账请以调用日志为准
- 请求被拒绝（HTTP 400 参数错误等）不扣费（实测验证）
- 时长与费用线性相关：15 秒视频 ≈ 5 秒视频的 3 倍
- 站内 fast 与标准版按同一单价计费，选 fast 主要收益是生成速度
内测期说明：Seedance 2.0 目前处于内测供给阶段，若实际扣费与上表偏差较大，欢迎联系客服沟通核对。平台会随官方政策（如官方后续推出更低价的版本）与 APIYI 供给能力动态调整价格，也欢迎有实力的渠道方洽谈合作。该模型以保障供给、服务客户为主，并非盈利型定价。
分组介绍
Seedance 2.0 走SeeDance2 专属分组（0.18x 倍率，人民币计价口径），有两个强制条件：① 令牌计费模式必须选「按量优先」或「按量计费」（按次计费无法路由）；② 令牌必须勾选 SeeDance2 分组——使用默认分组或其他视频分组的令牌会报「该模型无可用渠道」。
| 分组 | 倍率 | 适用场景 |
|---|---|---|
SeeDance2 | 0.18x | Seedance 2.0 全系列唯一可用分组，并发充足不排队 |
| 配置 | 适用场景 | 配法 |
|---|---|---|
| A. 一把令牌通用 | 个人开发、混合调用多模型 | 在现有令牌的分组列表中追加勾选 SeeDance2，计费模式保持「按量优先」 |
| B. 专用令牌 | 生产业务、需要独立账单 | 新建令牌只勾选 SeeDance2 分组，便于控量与额度告警 |
技术规格
| 维度 | 参数 |
|---|---|
| 模型名 | doubao-seedance-2-0-260128（标准版）/ doubao-seedance-2-0-fast-260128（极速版） |
| 分辨率 | 480p / 720p / 1080p（fast 不支持 1080p） |
| 宽高比 | 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 分钟 |
| 响应字段 | 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} | 查询任务状态 / 获取视频地址 | — |
分辨率与宽高比详解
分辨率档位定义的是像素面积而非短边，各比例实际输出像素值（官方口径，已实测核对）：| 宽高比 | 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 适配规则
- 文生视频：根据提示词内容智能选择最合适的宽高比
- 首帧 / 首尾帧：根据首帧图片比例自动选择最接近的宽高比（图片比例不一致时居中裁剪）
- 多模态参考：按提示词意图判断；否则以传入的第一个媒体文件为准（视频优先于图片）
- 实际使用的宽高比可在查询任务响应的
ratio字段中获取
最佳实践
HTTP 客户端加 Accept-Encoding: identity
网关响应头会标
content-encoding: gzip 但 body 实际未压缩，Python requests 等自动解压的客户端会报 ContentDecodingError。请求头加 Accept-Encoding: identity 即可规避（curl 不受影响）。错误码与重试
| 状态码 | 含义 | 处理建议 |
|---|---|---|
400 | InvalidParameter：分辨率/比例/时长等参数非法（如 fast + 1080p） | 错误信息会指明具体参数名，按本页参数表修正；不扣费 |
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-request-id方便排查
常见问题
报「该模型无可用渠道」怎么办？
报「该模型无可用渠道」怎么办？
这是 Seedance 2.0 最常见的报错：令牌没有勾选
SeeDance2 分组。默认分组或其他视频分组的令牌无法路由到该模型，请在令牌设置中勾选 SeeDance2 分组，且计费模式选「按量优先」。Python requests 报 ContentDecodingError / gzip 解码错误？
Python requests 报 ContentDecodingError / gzip 解码错误？
网关响应头标了
content-encoding: gzip 但 body 实际未压缩。在请求头加 "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 和标准版怎么选？
fast 和标准版怎么选？
站内两者按同一单价计费，fast 的收益是生成速度更快，但最高只支持 720p。需要 1080p、或对画质细节要求高时选标准版；批量生产 720p 以下素材选 fast。
duration 设为 -1 是什么效果？
duration 设为 -1 是什么效果？
模型在 4–15 秒内自主选择合适时长（实测生成了 10 秒视频），按实际产出时长计费。实际时长可在查询任务响应的
duration 字段获取。对成本敏感时建议固定时长。支持 frames 参数生成小数秒视频吗？
支持 frames 参数生成小数秒视频吗？
不支持。
frames 与 camera_fixed 参数是 Seedance 1.x 的能力，Seedance 2.0 系列暂不支持，请用整数 duration 控制时长。首帧、首尾帧、参考图可以混用吗？
首帧、首尾帧、参考图可以混用吗？
不可以。首帧（1 图）、首尾帧（2 图，role 必填
first_frame/last_frame）、多模态参考（1–9 图，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 均可用同一把令牌（追加分组）直接试。