全部文章
reference2026/09/11

Seedance 2.5 怎么用 | 参数、限制与计费规则

Seedance 2.5 怎么用 | 参数、限制与计费规则

Seedance 2.5 怎么用(托管 API):逐个讲清请求字段与取值范围、参考素材规则、轮询流程、计费秒数算法和 80006 错误。

知道 Seedance 2.5 怎么用,主要就是知道它的请求长什么样。一次调用带上一个提示词、四项输出设置,以及最多三类参考素材;平台返回一个任务 id;成片通过轮询取回。跟老版本不同的机制是 30 秒上限、参考素材的预算规模,以及一条让参考视频比费率表看上去更贵的计费规则。

动手之前先确认你在 2.5 上

有几家平台在把 2.5 加进来的同时,仍然把 Seedance 2.0 留作默认,所以模型字符串决定了你拿到的是什么。已发布的 2.5 版本以一个 -face 结尾的标识符提供。较早的代码示例引用的是不带这个后缀的标识符,它已经不再解析得通。

第二种检查不需要读代码。提交一个 20 秒的生成请求。在 2.0 上它会在时长字段上被拒,发生在任务存在之前,所以不会产生任何扣费。

通过托管 API 使用 Seedance 2.5

一次生成请求接受这些字段。

字段取值范围默认值
prompt最多 20,000 个字符无
duration4 到 30 秒,或 -15
resolution480p、720p、1080p720p
aspect_ratio16:9、9:16、1:1、4:3、3:4、21:9、adaptiveadaptive
generate_audiotrue 或 falsetrue
content_filtertrue 或 falsetrue

文生视频时提示词是必填的,一旦有参考素材就变成可选。里面用引号括起来的句子会被生成为语音,和画面在同一遍里生成,作为一条覆盖台词、音效和音乐的单声道音轨。

把 duration 设成 -1 就是把长度的决定权交给模型。预留是按 30 秒上限扣的,所以用它的时候要按满长度的片子做预算。

除这些之外,请求还暴露了 output_format(mp4 或 mov),以及 bitrate_mode、watermark、return_last_frame、seed、image_with_roles、omni_reference_task_type 和一个 tools 数组。return_last_frame 是做接龙时最关键的字段,因为一次生成的最后一帧就是下一次的种子。

会让请求被拒的参考素材规则

参考素材上的校验很严,而且它在任务创建之前就触发,这让被拒不花钱,但也让你很容易反复撞上。

  • 图片:每次请求最多 30 张,jpeg、png、webp、bmp、tiff、gif、heic 或 heif,每张小于 30 MB。
  • 视频:最多 10 段,mp4 或 mov,每段不超过 200 MB,每段 2 到 30 秒,合计 30 秒。
  • 音频:最多 10 条,wav 或 mp3,每条不超过 15 MB,每条 2 到 30 秒,合计 30 秒。

以上每一项都必须是公开的 HTTP(S) URL。data URI 在整个平台上都被拒绝,所以先把文件托管出去。

参考图和参考音频不增加账单。参考视频会,而且是以两种方式,这是下一节的内容。

发出去之前先把账算清楚

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

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

计费秒数取两个数字中较大的那个:参考视频长度向上取整加输出时长,或者输出时长的三分之五倍向上取整。

两个算过的例子能说明这为什么重要。

一次不带参考片的 1080p 十秒生成,按十秒乘 $0.461856 计费,约 $4.62。

同样是 1080p 十秒输出,带一段六秒的参考片,则按 16 秒和 17 秒中较大的那个计费,也就是 17 秒乘 $0.275904,约 $4.69。较低的费率被下限抵消掉了。

更小的任务能把这个效应显示得更尖锐。一次 720p 五秒输出配三秒参考片,按九秒而不是八秒计费,合计约 $1.44,而同样的五秒从零生成只略高于 $1.33。

轮询、耗时与退款

任务是异步的。提交会返回一个任务 id,视频通过轮询那个任务直到它报告完成来取回。

生成平均两到五分钟。轮询免费,所以固定十五到二十秒一次的间隔是合理的,激进地退避没有好处。

失败的任务全额退款。失败任务的用量数字会显示预留的金额是否已经退回,批量任务出岔子时值得查一下。

读懂一次拒绝

安全拒绝返回错误 80006。这个错误不会指明是哪一环触发的,所以原因可能是提示词、某个参考文件,也可能是生成出来的结果。

从提示词开始查。指名道姓的真实名人、第三方知识产权和违法内容在模型内部就被拦住,没有任何平台设置能解除。然后检查参考图,因为提供的照片里有一张脸或一个 logo,可能触发和直接点名一样的结果。

content_filter 默认为 true。把它设成 false 会让请求走一条限制较松的通道,并不会关闭审核。它是一个路由开关而不是总闸,而且旧的别名 nsfw_checker 仍然能通过校验。

常见问题

调用 Seedance 2.5 要用哪个模型字符串? 已发布的版本带一个以 -face 结尾的标识符。不带这个后缀的标识符来自发布前的示例,已经不再解析得通。

怎么生成超过 30 秒的片子? 把多次生成接龙起来。三十秒是单次请求的上限,所以更长的片子是拆成多个任务、在剪辑软件里拼接,return_last_frame 给你一个干净的交接点。

为什么参考视频比费率表上写的更贵? 参考片会在输出之外按它自己的长度计费,而且请求的计费秒数永远不会低于输出时长的三分之五倍向上取整。两个数字中较大的那个成为计费秒数。

关掉内容过滤是不是就什么都能过? 不是。把 content_filter 设成 false 只是选择一条限制较松的通道,审核依然生效。模型层面对真实名人、第三方 IP 和违法内容的封锁在任何情况下都保持不变。

一句话总结

Seedance 2.5 怎么用,按顺序是:确认 -face 模型字符串,把时长设在 4 到 30 秒之间,挑一个分辨率和画面比例,除非你要静音否则音频保持开启,参考图随便加因为它们免费,提交,然后每十五秒轮询一次,等两到五分钟。只要涉及参考视频,就按计费秒数而不是输出秒数来算价,并且把错误 80006 当成一次退款加一次重写。