文生视频 API 快速上手（OpenAI 兼容端点）

RelayDance 提供 OpenAI 兼容的文生视频 API，只需将 base_url 改为 https://relaydance.com/v1，保留原有 OpenAI SDK 即可调用 Seedance 等模型。视频任务通过 POST /v1/video/generations 提交，再轮询 GET /v1/video/generations/{task_id} 获取结果 url。计费按生成的视频量付费，失败或报错的请求一律不计费，认证使用 Authorization: Bearer YOUR_API_KEY。

如何接入 OpenAI 兼容端点

接入方式是将 base_url 改为 https://relaydance.com/v1 并保留现有 OpenAI SDK。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，因此无需重写客户端代码。认证在请求头中传入 Authorization: Bearer YOUR_API_KEY，API Key 可在 https://relaydance.com/console 创建。该协议直接提供对 Seedance 的访问，不需要 BytePlus 企业账户或 KYC。支付方式支持 USDT 与 Stripe 信用卡，计费为按量付费。更多接口说明见 https://relaydance.com/docs。

提交与轮询视频任务的步骤

提交视频任务使用 POST /v1/video/generations，随后轮询任务状态直到 succeeded 或 failed。具体步骤如下：

1. 向 POST /v1/video/generations 发送请求，携带 model、prompt、seconds 及 metadata（ratio、resolution、generate_audio、callback_url、content[]）。
2. 获得返回的 task_id。
3. 轮询 GET /v1/video/generations/{task_id}，直到 status 为 succeeded 或 failed。
4. 在结果中读取视频 url。

参考媒体放入 metadata.content[]，并在 prompt 中以 @image1 到 @imageN 引用。单次请求最多支持 9 张参考图、3 段参考视频和 3 条音轨，片段时长最长 15 秒。若设置 metadata.callback_url，最终状态会以 Webhook 方式 POST 到你的服务器。

各模型价格对比

不同模型与分辨率的价格如下表所示，实时费率见 https://relaydance.com/models。

图像方面，gpt-image-2 的图像输出免费，只按输入计费；图生图约 ¥0.035 起，且 4K 与 1K 出图同价。图像生成使用 POST /v1/images/generations 端点。以上价格来源为 relaydance.com/models，实际以官网实时费率为准。

计费规则与失败处理

计费采用按量付费，只对成功生成的视频收费。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，因此在轮询过程中返回 failed 状态的任务不会产生费用。视频计费以每秒或每条为单位：例如 Seedance 2.0 720p 约 $0.190 / 秒，1080p 约 $0.470 / 秒，Seedance Fast 约 $0.152 / 秒，原生 4K 约 $4.90 / 5 秒条。支付支持 USDT 与 Stripe 信用卡两种方式。该服务提供 OpenAI 兼容的 Seedance 访问，无需 BytePlus 企业账户或 KYC，实时费率请查看 https://relaydance.com/models。

常见问题 FAQ

问：失败的请求会计费吗？

答：不会。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，只有成功生成的视频才会按量计费。

问：单次请求可以携带多少参考媒体？

答：单次请求最多支持 9 张参考图、3 段参考视频和 3 条音轨，参考片段时长最长 15 秒，通过 metadata.content[] 传入并在 prompt 中以 @image1 到 @imageN 引用。

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

答：不需要。接口为 OpenAI 兼容，只需将 base_url 改为 https://relaydance.com/v1 即可继续使用 OpenAI SDK。