全部文章
guide2026/09/11

Seedance 2.5 在哪用 | 开通、接入与首次生成

Seedance 2.5 在哪用 | 开通、接入与首次生成

Seedance 2.5 在哪用与怎么接入:确认拿到的是真 2.5、拿 API key、首次请求要哪些字段、会花钱的默认值和账单。

字节跳动在 2026 年 7 月 31 日发布了 Seedance 2.5,而各家平台是在那之后的不同时间点接上的。这种错开的推出节奏,正是「Seedance 2.5 在哪用」比看上去更难回答的原因:不少平台一边宣传它,一边在底下仍然提供老模型。拿到第一次渲染,意味着确认版本、持有一把 key,并发出一个你确实读过其默认值的请求。

第一步,确认版本是真的

两项检查就能定案,而且都不花钱。

要 20 秒。 Seedance 2.5 单次生成从 4 到 30 秒。Seedance 2.0 止于 15 秒。一个 20 秒的请求在时长字段上被拒,就说明你在 2.0 上。校验被拒发生在任务创建之前,所以不会产生任何扣费。

读模型标识符。 已发布的 2.5 版本以一个 -face 结尾的字符串提供,完整写作 doubao-seedance-2.5-face。发布前发表的代码示例引用的是不带这个后缀的标识符,它已经不再解析得通。第三方平台的文档如果还显示着旧字符串,说明它的接入早于这次发布。

还有第三项检查,它不能定案但有提示作用:如果界面提供 4K 档位,那它描述的是发布前的营销材料。这个模型在所有平台上都止于 1080p,往下是 720p 和 480p。

拿一把 key 和一个放文件的地方

从平台控制台拿一把 API key,以 Authorization: Bearer 头发出,认证就这么多。把它当成一张消费凭证,放在服务器上。

如果你打算用参考素材,你还需要一个托管它们的地方。媒体输入只接受公开的 HTTP 或 HTTPS URL。data URI 在整个平台上都被拒绝,所以本地文件必须先上传才能被引用。

用第一次请求接入 Seedance 2.5

这次调用是向平台的视频生成接口 POST。它返回一个任务 id,不是视频。你接着轮询一个任务接口直到状态终结。轮询免费。

最小可用的请求体是一个模型字符串、一个提示词和一个时长。底下的默认值比大多数人预期的更重要:

字段默认值值得知道的
时长5 秒范围是 4 到 30。设成 -1 让模型自己挑,并按 30 秒上限预留
分辨率720p另外两个选项是 480p 和 1080p
画面比例自适应如果输出有目标画幅,可以选固定比例
音频台词、音效和音乐和画面一起生成

时长默认 5 秒是一个合理的首次渲染。-1 这个值是早期要避开的,因为预留是按天花板扣的,而不是按模型最终产出的长度。

提示词最长 20000 个字符。文生视频时提示词必填,一旦附上参考素材就变成可选。

参考素材这扇门

这是 2.5 区别于老版本的能力,而且它在第一次请求上就能用。一个任务接受最多 30 张参考图、10 段参考视频和 10 条音频。

要吃透的是那个定价上的不对称。参考图和参考音频不增加账单。参考视频会增加,而且是双重的。一段源片会在输出之外按它自己的长度收费,而且任何包含视频的请求都带一个输出时长三分之五倍的计费下限。一段两秒的源配五秒输出,按九秒而不是七秒计费。每段参考片长 2 到 30 秒,参考视频合计不能超过 30 秒。

所以一次基于静态图的首次渲染基本没有意外。一次基于素材片的首次渲染则不然,而且应该做小。

第一条片子要多少钱

费率按成片的每一秒算,由分辨率、以及请求是否带了参考片决定:

分辨率仅生成带参考视频
480p$0.118589$0.071153
720p$0.266824$0.160094
1080p$0.461856$0.275904

一条 480p 五秒的片子约 $0.59。一条 1080p 十秒的片子约 $4.62。这两个数字之间的距离,就是第一次尝试要做短做小、确认提示词做的是你想要的事、然后才提高分辨率和长度的理由。

生成需要两到五分钟。失败的任务全额退款,被拒的也包括在内。

第一次调用失败时

安全拒绝返回错误 80006。它不会点名是哪一环触发的,所以提示词、任何一张参考图和生成出来的结果都是嫌疑对象,诊断靠手工:缩减成一个中性提示词,确认它能过,再一次加回一个元素。

content_filter 参数默认为 true。把它设成 false 会让请求走一条限制较松的通道,并不会关闭审核。在那之下坐着模型层面对指名道姓的真实名人、第三方知识产权和违法内容的封锁,没有任何平台设置能解除。

首次调用失败清单上的其他一切都是校验问题:时长落在 4 到 30 之外、一个已退役的模型字符串、一个 data: URL、一段超过长度限制的参考片。这些都不会创建任务,所以都不花钱。

常见问题

用 Seedance 2.5 而不是 2.0,需要另开一个账号吗? 不需要。同时提供两者的平台,会把它们作为同一个账号、同一把 key 下的不同模型标识符暴露出来。在版本之间切换通常只是改一个字符串。

我怎么知道一个平台真的在跑 2.5? 请求 20 秒。成功说明是 2.5,在时长字段上被拒说明是 2.0。然后检查模型标识符是不是以 -face 结尾。

没有 API key 能用 Seedance 2.5 吗? 消费级 App 和内置在编辑器里的集成不需要 key 就能接触到模型,代价是参数访问权和按秒计费。你拿到的是预设和一个积分余额。

任何套餐上有 4K 吗? 没有。已发布的模型止于 1080p。4K 这个数字来自从未兑现的发布前报道。

一句话总结

Seedance 2.5 在哪用、怎么用,是四步。用一个 20 秒请求和 -face 标识符验证版本。拿一把 key 并放在服务器上。发一个短的首个任务,480p 五秒,除时长和分辨率外其余默认值不动。轮询两到五分钟然后下载结果。参考图和参考音频附上不要钱,参考视频按它自己的长度计费并带三分之五下限,而任何失败都会退款。