Seedance API 怎么设置视频时长：15 秒上限意味着什么

在 RelayDance 的 Seedance API 中，视频时长通过 POST /v1/video/generations 请求中的 seconds 参数设置，单位为秒。当前单次请求生成的片段上限为 15 秒，超出该长度需要拆分为多个任务。RelayDance 采用 OpenAI 兼容协议，按生成的视频计费，失败或报错的请求不计费。完整费率见 relaydance.com/models。

如何设置 seconds 参数

设置时长的方法是在 POST /v1/video/generations 请求体中传入 seconds 字段。除 seconds 外，还需提供 model 和 prompt，并可在 metadata 中配置 ratio、resolution、generate_audio 和 callback_url。请求鉴权使用 Authorization: Bearer YOUR_API_KEY，API Key 可在 https://relaydance.com/console 创建。接入方式沿用 OpenAI SDK，据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，无需更换客户端库。

15 秒上限意味着什么

15 秒上限意味着每次 POST /v1/video/generations 请求生成的片段最长为 15 秒，需要更长视频时应拆分为多段任务并在应用层拼接。同一请求内还可引用参考媒体：最多 9 张参考图片、3 段参考视频和 3 条音轨，均放入 metadata.content[]，并在 prompt 中以 @image1 到 @imageN 的形式引用。提交后通过 GET /v1/video/generations/{task_id} 轮询，直到 status 为 succeeded 或 failed，结果中包含视频 url。也可设置 metadata.callback_url 使用 webhook 模式，最终状态会 POST 到你的服务器。

时长与分辨率如何影响费用

费用取决于时长和分辨率，因为 Seedance 按秒计费，时长越长费用越高。以下为 relaydance.com/models 提供的参考费率：

以 15 秒 720p 片段为例，按约 $0.190 / 秒计算约为 $2.85。计费方式为按量付费，据 relaydance.com 官方文档，「失败或报错的请求一律不计费」。

调用视频任务的步骤

按以下步骤即可设置时长并提交视频任务：

1. 在 https://relaydance.com/console 创建 API Key。
2. 将 SDK 的 base_url 改为 https://relaydance.com/v1。
3. 发送 POST /v1/video/generations，传入 model、prompt 及 seconds（上限 15 秒）。
4. 如需参考媒体，将文件放入 metadata.content[]，并在 prompt 中用 @image1 引用。
5. 轮询 GET /v1/video/generations/{task_id}，或设置 metadata.callback_url 接收 webhook。
6. 当 status 为 succeeded 时读取结果中的视频 url。

常见问题（FAQ）

问：单次请求最长可以生成多少秒的视频？

答：单次请求片段上限为 15 秒，通过 seconds 参数设置。

问：请求失败会扣费吗？

答：不会。据 relaydance.com 官方文档，失败或报错的请求一律不计费。

问：接入是否需要更换 SDK？

答：不需要。RelayDance 为 OpenAI 兼容协议，将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用，详见 relaydance.com/docs。