Seedance 2.0 在哪用 | 从零接入到第一条视频

Seedance 2.0 在哪用一步步讲清:怎么选渠道、怎么拿 key、首次请求要哪些字段、要花多少钱,以及首次调用为什么会失败。
字节跳动没有发布任何直接把 Seedance 2.0 交到你手上的消费级 App。「Seedance 2.0 在哪用」在实践中意味着挑一个转售这个模型的渠道、拿到一份凭证,然后发出一个格式正确的请求。本文把这条路从头走到尾,带上第一条片子的成本,以及首次调用通常失败的四个原因。
这些都不费时间。难点大部分坐在每个渠道替你悄悄做掉的那些决定上。
承载这个模型的几类渠道
访问方式有三种形态,你选哪一种决定了你能控制什么。
消费级视频 App 给你一个文本框、几个预设和一个积分余额。不用 key,不用写代码。它是拿到第一条片子最快的路,也是藏得最多的一条:时长上限、分辨率降级和水印都是 App 而不是模型加的,而且你常常分不清自己被喂的是哪个版本。
托管 API 给你一把 key 和原始请求。模型暴露的每一个参数都够得着,计费是按成片秒数而不是按积分,而且出错时你能读到真正的错误。它要求你会发 HTTP。
捆绑集成把模型放进一个你本来就在付费的剪辑或设计工具里。如果你就住在那个工具里,它很方便,而且它的参数集通常是三者里最窄的。
只要不止是看个热闹,API 这条路才是那个会告诉你真相、让你知道自己拿到了什么的选项。
首次请求之前你需要什么
三样东西。
一个你选定平台上的账号,绑好付费方式。一把 API key,从平台控制台签发,以 Authorization: Bearer 头发出。以及,如果你打算用一张图来约束生成,还要那张图的可公开访问的 URL。媒体输入必须是公开的 HTTP 或 HTTPS 链接。data URI 在整个平台上都被拒绝,所以你笔记本上的文件得先上传到某个地方。
key 是持有即有效的凭证。任何拿到它的人都能花你的余额,所以把它放在服务端,别放进浏览器打包产物里。
通过托管 API 接入 Seedance 2.0
这次调用是向平台的视频生成接口 POST 一个 JSON 请求体,它返回的是一个任务 id 而不是一个视频。四个字段承载了整个请求:
- 模型标识符,从你想要的那个版本的官方文档里原样复制
- 提示词,一段镜头说明,而不是用文字堆出来的情绪板
- 以秒为单位的时长,在 2.0 上不能超过 15
- 分辨率,480p、720p 或 1080p 之一
没有 4K 设置。这个天花板在每一家平台上都一样,一个给这个模型宣传 4K 的页面是在复述发布前的说法。
模型字符串要复制,不要凭记忆敲。这个家族里的标识符版本号很精确,而网上流传的旧代码示例引用的字符串已经解析不通了。错误的标识符会在任务创建之前校验失败,所以它不花钱,但它产出的错误读起来像是权限问题而不是拼写问题。
轮询,以及等待
生成是异步的。创建调用立即返回一个任务 id,你轮询一个任务接口直到状态变为终态。轮询免费,这意味着没有理由激进地退避。
预期两到五分钟。一个二十分钟还没完成的任务已经出问题了,退款路径和其他任何失败一样。
任务成功时,响应里带着成片的 URL。把它下载下来。平台的结果 URL 不是永久归档。
第一条片子要多少钱
计费按成片的每一秒算,由分辨率定价。Seedance 2.5 的公开费率如下,它对每秒价格更低的 2.0 起到上限的作用:
| 分辨率 | 2.5 仅生成 | 2.5 带参考视频 |
|---|---|---|
| 480p | $0.118589 | $0.071153 |
| 720p | $0.266824 | $0.160094 |
| 1080p | $0.461856 | $0.275904 |
2.5 上一条 480p 五秒的片子大约 $0.59,在 2.0 上更少。这就是你的首次渲染应该花掉的数。从这里开始,而不是从 1080p 开始,确认整条链路能跑通,等你知道提示词到位了再提高分辨率。
失败的任务全额退款,包括内容审核的拒绝,所以一次出岔子的实验不是一笔支出。
首次调用为什么会失败
四个原因占了绝大多数。
时长超过 15 秒。 这是 2.0 上的硬天花板,在校验时被拒。如果你需要更长,目标是能跑到 30 秒的 Seedance 2.5。
一个本地或 data: 媒体 URL。 全平台拒绝。上传后传一个公开链接。
一个已退役的模型字符串。 校验错误,不创建任务,不扣费。
一次安全拒绝,以错误 80006 返回。它不会点名是哪一环触发的,所以提示词、某张参考图和生成出来的结果都是嫌疑对象。content_filter 参数默认为 true,把它设成 false 会路由到一条限制较松的通道,但不会关闭审核。在那之下,模型封锁指名道姓的真实名人、第三方知识产权和违法内容,没有任何平台设置能改变这一点。
常见问题
不写代码能用上 Seedance 2.0 吗? 能,通过消费级 App,或者剪辑工具里的捆绑集成。你用参数控制权和按秒计费,换来一个积分余额和别人定好的预设。
2.0 和 2.5 需要两把不同的 key 吗? 不需要。同时提供两者的平台把它们作为同一个账号、同一把 key 下的不同模型标识符暴露出来。切换版本通常只是改一个字符串。
多久才会有第一条视频? 请求被接受之后两到五分钟。创建调用本身在一秒内就返回一个任务 id,这正是让那些期待响应里直接有视频的人困惑的地方。
失败的生成会被扣费吗? 不会。失败全额退款,被拒的也在内。查一下结束任务上的积分数字,确认预留退回来了。
一句话总结
Seedance 2.0 在哪用、怎么接入,是三个决定加一个请求。选一个渠道,同时知道消费级 App 会把版本和上限都藏起来,而一把 API key 会把两者都暴露出来。拿到 key,放在服务端,并把任何参考图托管在一个公开 URL 上。发一个带模型字符串、提示词、不超过 15 秒的时长和一个分辨率的 POST,然后轮询两到五分钟。第一条做成 480p 五秒。它只花几分钱,而且失败还会退款。


