跳转到主要内容

概述

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。
🎬 核心亮点:4–15 秒可控时长(支持 -1 智能时长)、480p/720p/1080p 三档分辨率(1080p 仅标准版)、6 种宽高比 + adaptive 自适应、默认输出带同步音频、多语言提示词(中英日西葡印尼)。适合短视频量产、电商素材、动效设计、虚拟人内容等生产场景。

视频生成 API 参考

POST /seedance/api/v3/contents/generations/tasks,异步任务式调用,在线调试 + 完整轮询/下载代码。

API 使用手册

令牌创建、Base URL、计费模式等通用调用规范。

可视化接口测试

在 iCover 可视化测试工具里直接调试本接口,无需写代码。

异步任务查询 / 下载

在 API易后台查看已提交的视频任务、下载视频链接(API 之外的查询入口)。

为什么选 API易 的 Seedance 2.0?

先说定位:该模型官方没有折扣,平台也非盈利型定价,上架以保障供给、方便客户为主。选 API易 的核心价值不在”更便宜”,而在接入与使用体验:

官方资源 · 国内版直连

火山引擎中国国内版官方资源(非 BytePlus 海外版),自带上游内容安全机制,参数、响应、计费口径与官方完全一致。

不限并发 · 不排队

实测 15 个任务同时提交全部立即进入 running,无排队等待(2026-06-06 (UTC+8) 实测),适合批量生产场景直接放量。

保供定价 · 基本持平官网

官方无折扣、平台也不靠它盈利:单价对齐火山引擎官网(站内扣费约上浮 10%),叠加 充值加赠活动基本持平官网,充值大客户个别档位甚至更低。

零门槛接入 · 免实名认证

无需火山引擎账号、免官网实名认证、无消费门槛(免 200 元开通费与企业认证流程),国内机房、家宽网络、海外节点均可直连 api.apiyi.com,一把令牌即用。

虚拟人脸白名单权限

通道自带上游虚拟人脸白名单权限,AI 生成人脸、虚拟人像素材可直接用于图生视频,无需自行向官方申请白名单(真人人脸仍受上游内容安全机制限制)。

视频模型生态齐全

站内同时提供 VEO 3.1Sora 2Wan2.7 等视频通道,可按场景混搭选型。

专业服务 · 企业陪跑

团队深耕视频生成场景,具备丰富的选型、调优与集成经验,可为企业客户提供从 PoC 到生产上线的完整技术支持。

核心特性

三档分辨率 · 全比例同价

480p / 720p / 1080p(1080p 仅标准版)。同档位下 16:9、9:16、1:1 等所有比例像素面积相同、价格相同,横竖屏切换零成本。

默认同步音频

generate_audio 默认开启,自动生成与画面匹配的人声、音效、背景音乐;对话内容放在双引号内可显著优化配音效果。

4–15 秒可控时长

duration 支持 4–15 整数秒,或设为 -1 由模型智能选择时长(按实际产出计费)。帧率固定 24fps。

多语言提示词

中文(≤500 字)、英文(≤1000 词),额外支持日语、西班牙语、葡萄牙语、印尼语。

首尾帧 / 首帧生视频

传 2 张图严格控制首尾画面,或 1 张图作首帧;配合 return_last_frame 可把尾帧接力为下一段首帧,量产连续长视频。

多模态参考生视频

0~9 参考图 + 0~3 参考视频 + 0~3 参考音频自由组合(至少 1 图或 1 视频,三种图生场景互斥),可生成全新 / 编辑 / 延长视频,保持角色与风格一致性。

异步任务式调用

提交即返回 task_id,轮询查询,成功后从 content.video_url 下载 mp4(URL 24 小时有效)。

seed 可复现

支持 seed 固定随机性(相同请求生成类似结果),watermark 默认关闭,输出无水印。

模型定价

一句话理解定价 —— 按 token 精确计费,分档对齐火山引擎官网。 三个模型价格不同:轻量版 mini < 极速版 fast < 标准版(与官网同方向,mini 单价约为标准版一半,三者并非同一价格水平)。站内一般折扣价约为官网的 1.1 倍,叠加 充值加赠(一般送 10%、充值大客户最高 20%)后基本与官网持平,个别档位(如 1080p 大客户价)甚至更低。按面积×时长结算,±5% 的偏差属正常现象,欢迎随时测试、对账与沟通核对。
按 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 为准。
计费说明
  • 实际扣费以控制台模型价格和调用日志为准
  • 提交任务时预扣费,任务完成后多退少补;余额瞬时值会小幅波动,对账请以调用日志为准——日志里一条视频对应两条扣费记录,见下方「计费如何看日志」
  • 请求被拒绝(HTTP 400 参数错误等)不扣费(实测验证)
  • 时长与费用线性相关:15 秒视频 ≈ 5 秒视频的 3 倍

计费如何看日志(预扣费 + 多退少补)

打开控制台日志页 api.apiyi.com/log,搜索模型名 doubao-seedance-2-0 即可看到每笔消耗。一条视频对应两条扣费记录
  1. 预扣费:提交任务时按预估金额先行扣除(日志标「非流式」,显示令牌与分组),如下图的 $0.449998
  2. 实际补扣 / 退回:任务完成后按实际生成的 tokens 多退少补(日志标「流式」、带补全 tokens 数),如下图的 $5.611858——1080p 一般需要补扣
API易日志页中 Seedance 2.0 一条视频的两条扣费记录:预扣费与实际补扣

一条 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.0 目前处于内测供给阶段,若实际扣费与上表偏差较大,欢迎联系客服沟通核对。平台会随官方政策(如官方后续推出更低价的版本)与 APIYI 供给能力动态调整价格,也欢迎有实力的渠道方洽谈合作。该模型以保障供给、服务客户为主,并非盈利型定价。

分组介绍

Seedance 2.0 走 SeeDance2 专属分组(0.18x 倍率,人民币计价口径),有两个强制条件:① 令牌计费模式必须选「按量优先」或「按量计费」(按次计费无法路由);② 令牌必须勾选 SeeDance2 分组——使用默认分组或其他视频分组的令牌会报「该模型无可用渠道」。
0.18x 倍率怎么来的? 系统内置的 Seedance 2.0 模型单价与火山引擎官网一致,但官网价是人民币口径,而站内余额按美元计价(1:7 固定汇率)。若倍率为 1x,相当于按官网数字的 7 倍人民币扣费,因此专门调低分组倍率来折算汇率:0.18 × 7 = 1.26,即站内名义扣费约为官网人民币价的 1.26 倍。再叠加 充值加赠 后,一般用户实付约比官网高 10% 左右,充值大客户基本持平、个别档位(如 1080p)甚至低于官网。请务必知悉:系统始终按 tokens 实际用量计费,token 折算本身存在小幅浮动折损(±5% 偏差属正常),官网价也只是一个参考锚点,并非逐单对齐的承诺。当前定价为合理的保供口径,请叠加充值加赠活动整体核算。扣费出现异常欢迎随时联系客服对账沟通;但「为什么会比官网略高」不在争辩范围——介意请慎用。换个角度看,并发充足、不排队正是这条通道的核心价值。
两种推荐配置方式,按业务隔离需要选:
生产业务推荐 B 专用令牌:账单清晰、便于按业务线控量,出现异常消耗时也容易定位。

技术规格

端点一览

域名选择api.apiyi.com 为主域名,也可使用 vip.apiyi.com 等平台提供的其他网关域名。注意路径前缀是 /seedance/api/v3不要漏掉 /api,也不要走 /v1/videos

分辨率与宽高比详解

分辨率档位定义的是像素面积而非短边,各比例实际输出像素值(官方口径,已实测核对):

adaptive 适配规则

  1. 文生视频:根据提示词内容智能选择最合适的宽高比
  2. 首尾帧 / 首帧:根据首帧图片比例自动选择最接近的宽高比(图片比例不一致时居中裁剪)
  3. 多模态参考生视频:按提示词意图判断;否则以传入的第一个媒体文件为准(视频优先于图片)
  4. 实际使用的宽高比可在查询任务响应的 ratio 字段中获取
ratio 仅支持上表 7 个枚举值,传 "2:1" 等非法比例会直接返回 InvalidParameter 错误(实测验证);duration 超出 4–15 范围同样报错。这两类错误均不扣费

最佳实践

1

按需求选模型

要 1080p 或最高画质选标准版 doubao-seedance-2-0-260128;批量出片、成本敏感选轻量版 doubao-seedance-2-0-mini-260615单价约标准版一半、生成最快,最高 720p);画质与成本折中选 fast
2

用 adaptive 比例减少裁剪

图生视频场景保持默认 adaptive,模型按首帧图片自动适配,避免居中裁剪损失画面;明确投放渠道时再固定 9:16(竖屏)或 16:9(横屏)。
3

控制时长就是控制成本

费用与时长线性相关。先用 5 秒小批量验证 prompt,确认效果后再上 10–15 秒;不确定节奏时用 duration: -1 让模型自主决定。
4

不需要声音时显式关闭音频

generate_audio 默认开启。后期要自行配音的场景传 false,输出纯视频画面更干净。
5

对话放双引号内优化配音

需要角色说话时,把台词放在双引号内,如:男人说:「你记住,以后不可以用手指指月亮。」模型会自动生成对应人声。
6

HTTP 客户端加 Accept-Encoding: identity

网关响应头会标 content-encoding: gzip 但 body 实际未压缩,Python requests 等自动解压的客户端会报 ContentDecodingError。请求头加 Accept-Encoding: identity 即可规避(curl 不受影响)。
7

轮询 15–30 秒一次,成功后立即下载

任务通常 2–5 分钟完成。content.video_url 是 24 小时有效的签名直链,成功后立即转存到自己的存储。
8

用 return_last_frame 量产连续长视频

return_last_frame: true 拿到无水印尾帧 png,作为下一段任务的首帧,即可拼接多段连续视频。

错误码与重试

建议客户端
  • 创建/查询请求超时 30–60 秒即可(异步接口本身很快,耗时在任务侧)
  • 轮询间隔 15–30 秒,整体等待预算 15 分钟起步(1080p / 15 秒任务更长)
  • 对 5xx 与超时做 指数退避重试(建议 2 次)
  • 记录任务 id 与响应头 x-request-id 方便排查

常见问题

这是 Seedance 2.0 最常见的报错:令牌没有勾选 SeeDance2 分组。默认分组或其他视频分组的令牌无法路由到该模型,请在令牌设置中勾选 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.0 不支持直接上传含真人人脸的参考图/视频(上游内容安全机制拦截)。替代方案:使用 Seedance 模型近 30 天内生成的含人脸产物做二次创作、使用平台预置虚拟人像(asset:// 素材 ID)、或使用已授权真人素材。
参数错误被拒(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 分钟);需要 1080p 或对画质细节要求最高时选标准版;两者之间折中选 fast。mini 与 fast 最高都只支持 720p,请求 1080p 会返回 400 参数错误(不扣费)。
模型在 4–15 秒内自主选择合适时长(实测生成了 10 秒视频),按实际产出时长计费。实际时长可在查询任务响应的 duration 字段获取。对成本敏感时建议固定时长。
不支持。framescamera_fixed 参数是 Seedance 1.x 的能力,Seedance 2.0 系列暂不支持,请用整数 duration 控制时长。
不可以。首尾帧(2 图,role 必填 first_frame/last_frame)、首帧(1 图)、多模态参考生视频(0~9 图 + 0~3 视频 + 0~3 音频,至少 1 图或 1 视频,图片 role 均为 reference_image)是三种互斥场景。需要”首尾帧 + 参考”效果时,可在多模态参考模式下用提示词指定某张图作首帧。
SeeDance2 分组并发充足、不排队(实测 15 任务齐发全部立即运行)。如有更大规模的批量需求,可联系商务确认配额。
中文建议不超过 500 字、英文不超过 1000 词,过长会导致模型忽略细节。支持中、英、日、西、葡、印尼语。建议描述「主体 + 动作 + 镜头运动 + 光线/风格」。

相关文档

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