如何调用 Seedance 2.0 视频生成 API

调用 Seedance 2.0 视频生成 API，需将 OpenAI SDK 的 base_url 改为 https://relaydance.com/v1，并在请求头加入 Authorization: Bearer YOUR_API_KEY。通过 POST /v1/video/generations 提交任务，传入 model、prompt 与 seconds，再轮询 GET /v1/video/generations/{task_id} 直到状态为 succeeded 或 failed。计费按生成视频时长计算，720p 约 $0.190 / 秒。

如何配置接口与鉴权

配置只需改写 base_url 并保留 OpenAI SDK 即可完成接入。RelayDance 采用 OpenAI 兼容协议，据 relaydance.com/docs 官方文档「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。鉴权使用 Authorization: Bearer YOUR_API_KEY，API Key 可在 https://relaydance.com/console 创建。无需 BytePlus 企业账号或 KYC 即可直接访问 Seedance。支付方式支持 USDT 与 Stripe 卡。完整接入说明见 https://relaydance.com/docs，实时按模型计费费率见 https://relaydance.com/models。

如何提交并查询视频任务

提交任务使用 POST /v1/video/generations，包含 model、prompt、seconds 与 metadata 字段。metadata 可设置 ratio、resolution、generate_audio、callback_url 以及 content[] 参考媒体。提交后轮询 GET /v1/video/generations/{task_id} 直到 status 为 succeeded 或 failed，结果中包含视频 url。参考媒体放入 metadata.content[]，在 prompt 中以 @image1 至 @imageN 引用，单次请求支持最多 9 张参考图、3 段参考视频与 3 条音轨，单个片段长度可达 15 秒。若设置 metadata.callback_url，最终状态会以 webhook 方式 POST 到你的服务器。

Seedance 各档位价格如何

价格按生成视频时长或条数计算，分为多个档位。下表列出主要费率，来源 relaydance.com/models：

关于失败请求，据 relaydance.com 官方文档「失败或报错的请求一律不计费」，因此调试阶段的错误请求不会产生费用。计费为 pay-as-you-go，按实际生成的视频结算。

如何用 OpenAI SDK 完成调用

完成一次调用可按以下步骤操作：

1. 在 https://relaydance.com/console 创建 API Key。
2. 将 OpenAI SDK 的 base_url 设为 https://relaydance.com/v1。
3. 在请求头加入 Authorization: Bearer YOUR_API_KEY。
4. 调用 POST /v1/video/generations，传入 model、prompt、seconds，并在 metadata 中设置 resolution（如 720p 约 $0.190 / 秒，1080p 约 $0.470 / 秒）。
5. 轮询 GET /v1/video/generations/{task_id} 或设置 metadata.callback_url 接收 webhook，直到状态为 succeeded，取出视频 url。

常见问题 FAQ

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

单次请求能上传多少参考媒体？最多 9 张参考图、3 段参考视频与 3 条音轨，单个片段长度可达 15 秒，在 prompt 中以 @image1 至 @imageN 引用。

4K 出图如何计费？gpt-image-2 的图像输出免费，只按输入计费；图生图约 ¥0.035 起，且 4K 与 1K 出图同价（来源 relaydance.com/models）。