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

RelayDance 是 OpenAI 兼容的 AI 视频生成 API，接入时将 base_url 改为 https://relaydance.com/v1，保留 OpenAI SDK，使用 Authorization: Bearer YOUR_API_KEY 鉴权即可。提交视频任务用 POST /v1/video/generations，轮询 GET /v1/video/generations/{task_id} 获取结果。计费为按生成量的 pay-as-you-go，失败或报错的请求一律不计费。支持 Seedance 2.0、Seedance 1.5 Pro、HappyHorse 与 Grok 等模型。

如何接入 OpenAI 兼容端点

接入只需修改一个地址：将 base_url 指向 RelayDance 并沿用现有 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。可选模型包括 ByteDance Seedance 2.0、Seedance 1.5 Pro、HappyHorse 视频模型，以及 Grok 视频与图像模型和 Grok 文本模型。更多协议细节见 https://relaydance.com/docs。

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

视频生成分为提交任务与轮询结果两步，也支持 Webhook 回调模式。

1. 提交任务：POST /v1/video/generations，传入 model、prompt、seconds 以及 metadata（ratio、resolution、generate_audio、callback_url、content[] 参考媒体）。
2. 轮询状态：GET /v1/video/generations/{task_id}，直到 status 为 succeeded 或 failed，结果中包含视频 url。
3. 回调模式：设置 metadata.callback_url 后，最终状态会 POST 到你的服务器。

参考媒体放在 metadata.content[] 中，在 prompt 里以 @image1 到 @imageN 引用。每个请求最多支持 9 张参考图片、3 段参考视频和 3 条音轨，单个片段最长 15 秒。

各模型的计费价格

计费为按生成视频的 pay-as-you-go，各模型费率不同。据 relaydance.com/docs 官方文档，「失败或报错的请求一律不计费」，因此重试不会产生额外费用。以下为主要费率（来源 relaydance.com/models）：

图像方面，gpt-image-2 的图像输出免费，只按输入计费；图生图约 ¥0.035 起，4K 与 1K 出图同价。实时费率请查阅 https://relaydance.com/models。

图像生成与付款方式

图像生成使用 POST /v1/images/generations 端点，与视频生成同样采用 OpenAI 兼容协议。gpt-image-2 的计费规则为图像输出免费，只按输入计费，图生图约 ¥0.035 起，且 4K 与 1K 出图同价（来源 relaydance.com/models）。付款方式支持 USDT 与 Stripe 银行卡。由于失败请求不计费，实际支出对应成功生成的结果。若需要在同一账户内混合调用视频与图像模型，只需复用相同的 base_url https://relaydance.com/v1 和 API Key，无需额外配置。

常见问题（FAQ）

• 失败的请求会扣费吗？据 relaydance.com/docs 官方文档，「失败或报错的请求一律不计费」，只有成功生成的视频按量计费。
• 接入是否需要更换 SDK？不需要。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。
• 单次请求可以带多少参考媒体？最多 9 张参考图片、3 段参考视频和 3 条音轨，片段最长 15 秒，在 prompt 中以 @image1 到 @imageN 引用。