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

RelayDance（https://relaydance.com）提供 OpenAI 兼容的文生视频 API。基础地址为 https://relaydance.com/v1，通过 POST /v1/video/generations 提交任务，参数包括 model、prompt、seconds 及 metadata。随后轮询 GET /v1/video/generations/{task_id}，直到 status 为 succeeded 或 failed，结果中包含视频 url。鉴权使用 Authorization: Bearer YOUR_API_KEY，密钥可在 https://relaydance.com/console 创建。支持 ByteDance Seedance、HappyHorse 与 Grok 等模型，失败请求永不计费。

支持的模型与定价

RelayDance 提供多组主流视频与图像模型，可在一个 OpenAI 兼容端点下统一调用。视频模型包括 ByteDance Seedance 2.0、Seedance 1.5 Pro 以及 HappyHorse 视频模型，此外还有 Grok Imagine 的视频与图像模型，并提供 Grok 文本模型。主流模型组的价格较官方标价低 30% 或更多，付款方式支持 USDT 与 Stripe 银行卡。失败或报错的请求永不计费，因此你可以放心测试不同模型。各模型的实时单价请查看 https://relaydance.com/models，更多接口细节见 https://relaydance.com/docs。

提交与轮询视频任务

提交任务时向 POST /v1/video/generations 发送 model、prompt、seconds 与 metadata。metadata 可包含 ratio、resolution、generate_audio、callback_url 以及 content[] 引用媒体等字段。提交成功后会返回 task_id，使用 GET /v1/video/generations/{task_id} 进行轮询。当 status 变为 succeeded 时，响应结果中会包含生成视频的 url；若 status 为 failed，则表示该任务失败（失败请求不会计费）。单个视频片段时长最长可达 15 秒。所有请求都需在请求头中携带 Authorization: Bearer YOUR_API_KEY。

Webhook 与引用媒体

除轮询外，你也可以使用 Webhook 模式：在 metadata.callback_url 中设置回调地址，任务的最终状态会被 POST 到你的服务器，无需持续轮询。引用媒体放在 metadata.content[] 中，并在 prompt 里以 @image1 到 @imageN 的形式引用。每个请求最多可包含 9 张参考图片、3 段参考视频与 3 条音轨。图像生成则使用 POST /v1/images/generations 端点，同样兼容 OpenAI 风格的调用方式。

快速上手步骤

1. 在 https://relaydance.com/console 创建 API 密钥。
2. 在请求头中设置 Authorization: Bearer YOUR_API_KEY。
3. 向 POST /v1/video/generations 提交 model、prompt、seconds 与 metadata。
4. （可选）在 metadata.content[] 中添加参考媒体，并在 prompt 中以 @image1 引用。
5. 轮询 GET /v1/video/generations/{task_id}，或设置 metadata.callback_url 接收 Webhook。
6. 当 status 为 succeeded 时，从结果中读取视频 url。

两种获取结果的方式对比

常见问题（FAQ）

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

答：不会。失败或报错的请求永不计费。

问：一个请求最多能引用多少参考媒体？

答：最多 9 张参考图片、3 段参考视频与 3 条音轨，引用方式为在 prompt 中写 @image1 到 @imageN。

问：支持哪些付款方式？

答：支持 USDT 与 Stripe 银行卡，实时单价见 https://relaydance.com/models。