图生视频 API：用 RelayDance 让一张图片动起来

RelayDance 是一个 OpenAI 兼容的图生视频 API，你可以上传一张图片作为参考媒体，让它动起来生成视频。方法是向 POST /v1/video/generations 提交请求，把图片放入 metadata.content[] 并在 prompt 中用 @image1 引用，随后轮询 GET /v1/video/generations/{task_id} 获取视频 url。计费为按生成时长付费，失败请求不计费。详见 relaydance.com/models。

如何用一张图片生成视频

用图片生成视频需要把图片作为参考媒体提交，并在 prompt 中引用它。参考媒体放入 metadata.content[]，在 prompt 里以 @image1 到 @imageN 的形式引用。单次请求最多支持 9 张参考图片、3 段参考视频和 3 条音轨，单个片段时长最长 15 秒。提交任务后，通过轮询 GET /v1/video/generations/{task_id} 直到状态变为 succeeded 或 failed，成功结果中包含视频 url。你也可以设置 metadata.callback_url，让最终状态通过 Webhook POST 到你的服务器。

接入方式与鉴权

RelayDance 采用 OpenAI 兼容协议，只需替换 base_url 即可接入。据 relaydance.com 官方文档：「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。鉴权使用 Authorization: Bearer YOUR_API_KEY，API Key 可在 https://relaydance.com/console 创建。接入步骤如下：

1. 将 base_url 设为 https://relaydance.com/v1。
2. 在请求头加入 Authorization: Bearer YOUR_API_KEY。
3. 向 POST /v1/video/generations 提交 model、prompt、seconds 与 metadata。
4. 轮询 GET /v1/video/generations/{task_id} 或使用 callback_url 接收结果。

更多协议细节见 relaydance.com/docs。

价格与计费方式

RelayDance 按生成的视频付费，失败请求不计费。据 relaydance.com 官方文档：「失败或报错的请求一律不计费」。不同分辨率与模型的费率如下表所示，实时费率以 relaydance.com/models 为准。

付款方式支持 USDT 和 Stripe 银行卡。

参考媒体与图像生成

RelayDance 支持在一次请求中组合多种参考媒体，并提供独立的图像生成接口。视频请求可携带最多 9 张参考图片、3 段参考视频和 3 条音轨，片段最长 15 秒，参考图片通过 @image1 至 @imageN 在 prompt 中引用。图像生成使用 POST /v1/images/generations。在 gpt-image-2 的计费中，图像输出免费，只按输入计费，图生图约 ¥0.035 起，且 4K 与 1K 出图同价。这种方式提供直接的 OpenAI 兼容访问，无需 BytePlus 企业账户或 KYC。

常见问题 FAQ

失败的请求会收费吗？不会。据 relaydance.com 官方文档：「失败或报错的请求一律不计费」，计费为按生成视频付费。

一次请求可以放几张参考图片？单次请求最多支持 9 张参考图片、3 段参考视频和 3 条音轨，片段最长 15 秒。

如何获取生成的视频？轮询 GET /v1/video/generations/{task_id} 直到状态为 succeeded，结果中包含视频 url；或设置 metadata.callback_url 通过 Webhook 接收最终状态。