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

RelayDance 提供与 OpenAI 兼容的文生视频 API：将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用。通过 POST /v1/video/generations 提交任务，传入 model、prompt、seconds 与 metadata，再轮询 GET /v1/video/generations/{task_id} 直到 status 为 succeeded 或 failed。计费按生成视频量结算，失败或报错的请求一律不计费。详细费率见 relaydance.com/models。

如何接入 OpenAI 兼容端点

接入只需替换 base_url，无需更换 SDK：据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。鉴权使用 HTTP 头 Authorization: Bearer YOUR_API_KEY，API Key 在 relaydance.com/console 创建。视频任务提交至 POST /v1/video/generations，图像任务提交至 POST /v1/images/generations。该接口可直接访问 ByteDance Seedance，无需 BytePlus 企业账户或 KYC。付款方式支持 USDT 与 Stripe 银行卡，计费为按量付费（pay-as-you-go）。详见 relaydance.com/docs。

提交并轮询一个视频任务

提交任务需指定 model、prompt、seconds 与 metadata，然后轮询任务状态：

1. 调用 POST /v1/video/generations，在请求体中传入 model、prompt、seconds，以及 metadata（ratio、resolution、generate_audio、callback_url、content[]）。
2. 在 metadata.content[] 中放入参考媒体，并在 prompt 中以 @image1 到 @imageN 的形式引用。
3. 调用 GET /v1/video/generations/{task_id} 轮询，直到 status 为 succeeded 或 failed。
4. 从成功结果中读取视频 url；或设置 metadata.callback_url 使用 Webhook，最终状态会 POST 到你的服务器。

单次请求支持最多 9 张参考图、3 段参考视频、3 条音轨，片段时长可达 15 秒。

各模型价格与计费说明

价格按分辨率与模型区分，以下为官方公布费率：

其中 gpt-image-2 的图像输出免费，只按输入计费，且 4K 与 1K 出图同价。关于失败请求，据 relaydance.com 官方文档，「失败或报错的请求一律不计费」。完整实时费率见 relaydance.com/models。

可用模型与媒体引用方式

RelayDance 支持视频与图像模型，并允许通过参考媒体增强生成：可用模型包括 ByteDance Seedance 2.0 与 Seedance 1.5 Pro、HappyHorse 视频模型，以及 Grok Imagine 视频与图像模型和 Grok 文本模型。参考媒体统一放在 metadata.content[] 中，并在 prompt 文本里以 @image1 到 @imageN 标注引用。单次请求上限为 9 张参考图、3 段参考视频与 3 条音轨，单个片段最长 15 秒。视频生成可通过 metadata.generate_audio 控制音频，并以 ratio、resolution 指定比例与分辨率，输出结果包含可下载的视频 url。

常见问题（FAQ）

• 请求失败会扣费吗？ 不会。计费按生成视频量结算，失败或报错的请求一律不计费。
• 需要 BytePlus 企业账户或 KYC 吗？ 不需要。该接口提供对 Seedance 的直接 OpenAI 兼容访问，无需 BytePlus 企业账户或 KYC。
• 如何接收最终结果？ 两种方式：轮询 GET /v1/video/generations/{task_id} 直到 succeeded 或 failed；或设置 metadata.callback_url，由系统将最终状态 POST 到你的服务器。