SeeDance2 分组,费用按 token 计算。
创建令牌
在令牌管理创建用于 Seedance 2.0 的令牌时,按下面配置:
Seedance 模型只开放在
SeeDance2 分组,请求必须使用这个分组的令牌;default、Wan 等其他分组的令牌无法调用,会返回无可用渠道等错误。
计费与价格
Seedance 按 token 计费。2026 年 9 月 24 日公开价格配置中,SeeDance2 分组的倍率为 0.18,各模型的基础单价与火山方舟官方人民币单价数字相同,所以:
- 老张API美元单价 = 官方人民币单价 × 0.18;
- 按 1:7 固定汇率折算,0.18 × 7 = 1.26,名义价格约为火山方舟官方价的 1.26 倍。
官方刊例价是 480p、720p 不含视频的单价。「5 秒约」按 16:9、输出 5 秒、输入不含视频估算,按实际输出 121 帧计,720p 约 108,900 tokens,1080p 约 245,025 tokens。
实际 tokens 以任务返回的
usage.completion_tokens 为准,每个任务的最终费用以两条消费日志的合计金额为准。各模型单价也可在控制台模型价格查看,模型与价格总表列出了分组与倍率。
按规格估算费用
火山方舟官方的费用估算公式:- 火山方舟官方的 1080p 单价高于 480p、720p(Seedance 2.5 为 ¥77,Seedance 2.0 为 ¥51,每 1M tokens);老张API在输入不含视频时三档同价,按上表单价计算。fast 与 mini 最高支持 720p。
- 输入包含视频(
video_url)时按更低一档的单价计费:Seedance 2.5 为每 1M tokens $7.56,Seedance 2.0 输出 1080p 时为 $5.58。但输入视频的时长也计入 token 用量,同样输出 5 秒,总价通常更高。 - 官方还为输入包含视频的任务设置了最低 token 用量,估算值低于最低用量时按最低用量计费。
- 输出越长,token 用量越多。Seedance 2.5 的
duration默认为-1,由模型在 4–30 秒内自选时长;需要控制成本时,请显式传入duration。
区间的低值对应 2–4 秒的输入视频,高值对应最长的输入视频(2.5 为 30 秒,2.0 系列为 15 秒)。
为什么一次任务会出现两条消费日志?
Seedance 视频生成是异步任务。创建任务时,系统还不知道最终视频会消耗多少 tokens,无法一次完成准确结算。因此系统先按预计用量预扣,任务结束后再按实际usage.completion_tokens 补扣或退回差额。
一次任务会显示两条日志,但它们不是两次独立调用,也不是对同一个视频重复收取两次完整费用:
第二条“流式”日志只是系统生成的结算记录,不代表客户端调用了流式视频接口,也不代表另一个 API Key 发起了新请求。它不显示令牌、分组或 IP 属于正常现象,请求来源请查看第一条预扣日志。
最终费用 = 预扣日志金额 + 完成结算日志金额。
例如,第一条预扣约 $0.90,第二条补扣约 $3.58,这一次任务的最终费用约为 $4.48,而不是两次独立的视频消费。如果实际用量低于预估,第二条记录也可能是退回差额。
对账时建议:
- 在调用日志中搜索
doubao-seedance或所用的完整模型 ID。 - 用预扣记录确认调用令牌、分组和来源 IP。
- 用完成结算记录查看实际补全 tokens。
- 在异步任务页按任务 ID、提交时间和完成时间核对视频结果,不要把两条日志当成两个视频。
topup_convert_ratio: 0.18,同时显示 group_ratio: 1。这两个字段用途不同,group_ratio: 1 不表示漏算了 0.18 倍率。
预扣日志会显示 SeeDance2 和 0.18x;完成结算日志不重复显示分组,也不代表按全价结算。
接口与任务流程
/v1,不带 /seedance/api/v3 前缀)。不带任务 ID 的 GET /contents/generations/tasks 列表查询在当前中转路径下会返回站点 HTML,不能作为业务接口使用。
1
创建任务
调用
POST /contents/generations/tasks,在 model 中传入纯模型 ID,并通过 content 数组传入提示词和可选素材。保存响应中的任务 id。2
轮询状态
调用
GET /contents/generations/tasks/{id},按下面的判定规则检查 status,直到进入终态。3
下载结果
任务成功后,从
content.video_url 下载视频,或调用兼容下载接口 /v1/videos/{id}/content 取回视频文件;如果创建时设置了 return_last_frame=true,还可以读取 content.last_frame_url。任务状态与判定规则
读取查询响应顶层的
status,按以下规则处理:
queued、running:继续轮询;succeeded、completed:任务成功,按以下顺序获取视频:content.video_urldata.content.video_url- 顶层
result_url - 兼容下载接口
/v1/videos/{id}/content
failed、expired:停止轮询,查看error;- 出现上表以外的值:停止轮询,保存完整响应并联系支持团队。
模型
mini 与 2.5 的能力来自火山方舟 Seedance 2.5 教程中的模型能力对比。Seedance 2.5 的首帧/首尾帧、视频编辑和视频延长任务对
ratio、duration 有额外限制,改用 2.5 前请先阅读该教程。
model 只填纯模型 ID,老张API按纯模型 ID 匹配通道。不要传入控制台接入点 ID(ep-...),也不要在模型名后附加中文备注。
创建任务
请求头
请求参数
content 内容项
常用
role:
真人与虚拟人素材
包含真人身份或需要人物一致性的任务,不能用普通真人人脸图片代替专用素材流程。 请先按真人与虚拟人素材 API完成真人认证或创建虚拟人素材;素材状态变为Active 后,把返回的 asset://... URI 作为 reference_image 提交。素材 API 托管在 yingtu.ai,同样使用老张API密钥鉴权。
文生视频
先设置密钥。下面的示例用jq 提取任务 ID 和视频地址(macOS 可用 brew install jq 安装):
TASK_ID 为空,查看 seedance-create.json 中的错误信息。
下面两个示例同样把响应保存到 seedance-create.json,创建后用同一条 jq 命令取出 TASK_ID。
首尾帧
图片、视频、音频参考
查询任务
status 进入终态。成功响应示例:
结果 URL 是临时签名地址,通常有效期为 24 小时。生产环境建议任务成功后立即下载,并转存到自己的对象存储。
下载结果
查询结果中有签名地址时,可以直接下载,无需Authorization 请求头:
https://api.laozhang.ai/v1,不是 /seedance/api/v3。任务成功后,该接口会根据服务端保存的任务结果定位视频文件,并返回或重定向到可下载的 MP4:
Python 完整示例
先安装依赖pip install requests,并设置 LAOZHANG_API_KEY 环境变量。示例按上面的判定规则轮询,每 15 秒查询一次,总超时 20 分钟,成功后把视频保存为 <任务 ID>.mp4。
常见接入问题
一次请求出现两条日志,是扣了两次吗?
一次请求出现两条日志,是扣了两次吗?
不是重复扣费:两条日志分别是预扣和完成结算,金额相加才是这个任务的费用,对账方法见计费与价格中的两条消费日志说明。
任务失败或请求被拒绝会扣费吗?
任务失败或请求被拒绝会扣费吗?
都不计费。创建请求被直接拒绝(例如参数错误返回 4xx、没有拿到任务 ID)时不扣费;任务已创建但最终
failed 或 expired 时,创建时的预扣金额会在结算时退回。实际扣费以调用日志为准。如果失败或过期的任务仍有扣费,请带上任务 ID 联系支持团队(hi@laozhang.ai)。SeeDance2 的 0.18 倍率是折扣吗?
SeeDance2 的 0.18 倍率是折扣吗?
不是,0.18 是人民币价格换算为美元余额的系数,换算方法和各模型单价见计费与价格。
三档同价,为何 1080p 更贵?竖屏呢?
三档同价,为何 1080p 更贵?竖屏呢?
因为 token 用量随输出像素增加。「三档同价」指输入不含视频时每 1M tokens 的单价相同;同样输出 5 秒,720p 约 108,900 tokens,1080p 约 245,025 tokens,所以 1080p 的单个视频更贵。同一分辨率下,各宽高比的像素数基本相同,例如 720p 的 16:9 为 1280×720、9:16 为 720×1280,横屏、竖屏和方形的费用也基本一致。估算公式见按规格估算费用。
请求路径和 model 应该怎么写?
请求路径和 model 应该怎么写?
路径必须是
/seedance/api/v3/contents/generations/tasks,不要去掉官方路径里的 /api:写成 /seedance/v3/... 会返回站点 HTML 而不是 JSON。也不要调用不带任务 ID 的列表查询,它同样返回 HTML。model 只填纯模型 ID,例如 doubao-seedance-2-0-260128。不要传控制台接入点 ID(ep-...),也不要在模型名后附加备注,例如 doubao-seedance-2-0-260128 (2.0-音画同生)。四个 Seedance 模型怎么选?
四个 Seedance 模型怎么选?
为什么生成的视频自带声音?怎么关掉?
为什么生成的视频自带声音?怎么关掉?
因为
generate_audio 默认为 true:Seedance 2.0 与 2.5 会根据提示词和画面自动生成人声、音效和背景音乐,输出为单声道。需要无声视频时,在请求体中显式传 "generate_audio": false。需要生成对白时,把台词放在双引号里效果更好。任务成功后视频地址在哪里?多久失效?
任务成功后视频地址在哪里?多久失效?
方舟透传详情里的视频地址在
content.video_url,24 小时内有效。老张API兼容任务对象也可能返回嵌套的 data.content.video_url 或顶层 result_url;只需要下载文件时,调用兼容下载接口 /v1/videos/{id}/content。按火山方舟说明,视频地址 24 小时内有效,Seedance 2.5 生成的视频地址最多可下载 100 次。任务成功后请立即下载并转存到自己的存储,不要把签名地址直接发给终端用户。音频参考能单独传吗?
音频参考能单独传吗?
只有 Seedance 2.5 可以。Seedance 2.0 系列(标准版、fast、mini)要把音频和至少一个图片或视频素材一起传入。