Seedance 2.5 API 给你什么
一次 POST 创建任务，一次 GET 轮询状态，轮询免费。Seedance 2.5 API 通过你填了哪些媒体字段来判定模式，而不是靠一个单独的参数。
只给 prompt 就是文生视频。加上图片，Seedance 2.5 API 就跑图生视频。加上首帧和尾帧，它就补出中间的过渡。加上源片，它就做编辑或续接。
POST 会立刻返回任务 id，生成需要 2 到 5 分钟。接入 Seedance 2.5 API 需要一个轮询循环或队列，而不是同步请求。
平台以 doubao-seedance-2.5-face 提供服务。写错 Seedance 2.5 API 的模型字符串是首次调用最常见的失败原因，它会同步返回错误，而不是扣费。
一个 header，按工作区划分范围，没有项目 id。Seedance 2.5 API 的 key 继承签发它的工作区的计费范围。
每一个失败的任务都全额退还积分，包括被审核拒绝的情况。Seedance 2.5 API 从不为你没收到的成片收费。
这里没有生成器。Seedance 2.5 API 调用跑在托管 API 上，下面每一个参数和单价都取自其公开文档。
最要紧的几个 Seedance 2.5 API 参数
决定成本与结果的四个字段。
duration
4 到 30 秒，默认 5 秒。传 -1 让模型自己决定，但 Seedance 2.5 API 会按 30 秒上限预扣积分再退还差额，余额不足时可能触发 402。
resolution
480p、720p 或 1080p，默认 720p。Seedance 2.5 API 上没有 4K，请求 4K 会返回错误，而不是自动降级给你一段片子。
content_filter
布尔值，默认为 true。设为 false 会把 Seedance 2.5 API 请求转到限制更宽松的通道，并让 prompt 变成必填。平台文档把它写作路由，而不是关闭开关。
omni_reference_task_type
声明是编辑还是续接，Seedance 2.5 API 就会在提交时校验规则，而不是几分钟后才失败。任何带参考素材的任务都值得设上。
四步跑通一次 Seedance 2.5 API 调用
- 1
创建 key
在平台控制台里生成一个，作为 bearer token 发送。Seedance 2.5 API 在 authorization 头上不接受其他形式。
- 2
POST 提交任务
把 model、prompt 和媒体 URL 发到视频生成端点。Seedance 2.5 API 的每个媒体字段都只收公开的 HTTP 或 HTTPS URL，整个平台都不接受 base64。
- 3
轮询任务
用任务 id 做 GET，直到状态变成 completed 或 failed。Seedance 2.5 API 的轮询不花钱，所以 2 秒一次也没问题。
- 4
读取输出
完成的 Seedance 2.5 API 任务会带回视频 URL，如果你要了尾帧，还会带一个尾帧 URL。要长期保留的文件请自行转存，因为返回的 URL 不是永久有效的。
Seedance 2.5 API 常见问题
按计费视频秒数收费，从 $0.071153 到 $0.461856，取决于分辨率以及请求是否带了参考片段。10 秒 1080p 约 $4.62。参考图和参考音频不增加账单。
输出时长，加上任何参考视频的完整长度；任何包含视频的请求还有一个下限，即输出时长的 5/3 倍。2 秒源片配 5 秒输出按 9 秒计费而不是 7 秒，这一点让多数首次接入的人意外。
托管 API 上是 doubao-seedance-2.5-face。旧教程引用的是不带后缀的 doubao-seedance-2.5，那是上线之前的写法，现在解析不到。请查模型页面，不要照抄代码示例。
轮询是文档给出的方式，而且免费，所以一个短间隔的循环就是最简单的 Seedance 2.5 API 接法。生成耗时 2 到 5 分钟，2 到 5 秒一次的轮询不会带来实质负载，也不需要搭回调设施。
那是 schema 校验，并且没有扣费。常见原因是分辨率取值非法、size 与首帧或尾帧同时使用，或者文生视频请求漏了 prompt。错误信息会指出出问题的字段。
要么是任务类型规则，要么是审核。错误码 80006 是安全拒绝，不指明环节。编辑类任务的参数不匹配会产生另一种失败，而显式声明 omni_reference_task_type 能让下一次直接返回 400。
最多 30 张图片、10 段视频（合计 30 秒）和 10 条音轨。图片数组和带角色标签的图片数组互斥，所以每次 Seedance 2.5 API 请求只能选其一。
有，同一个端点、换一个模型 id。Seedance 2.0 上限是 15 秒，2.5 能到 30 秒，请求结构足够接近，所以切换版本基本上只是改一个字符串。
一个 key 继承签发它的工作区的计费范围，也没有单独的项目 header。需要分开记账的团队会另建工作区，而不是在一个工作区里多建几个 key，因为用量是按工作区汇总的。