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

RelayDance 是 OpenAI 兼容的视频生成 API，可将一张图片转为动态视频。你只需把 base_url 改为 https://relaydance.com/v1，通过 POST /v1/video/generations 提交任务，并在 metadata.content[] 中放入参考图片，在 prompt 中用 @image1 至 @imageN 引用即可。单次请求最多支持 9 张参考图片，按生成结果计费，失败请求不计费。

如何用一张图片生成视频

图生视频的核心是把参考图片放入 metadata.content[] 并在 prompt 中引用。具体步骤如下：

1. 在 https://relaydance.com/console 创建 API Key，请求头使用 Authorization: Bearer YOUR_API_KEY。
2. 将 SDK 的 base_url 设为 https://relaydance.com/v1。
3. 调用 POST /v1/video/generations，传入 model、prompt、seconds 与 metadata（ratio、resolution、generate_audio、callback_url、content[]）。
4. 在 metadata.content[] 放入参考图片，在 prompt 中以 @image1 到 @imageN 引用。
5. 轮询 GET /v1/video/generations/{task_id}，直到 status 为 succeeded 或 failed，结果中含视频 url。

单次请求支持多少参考素材

单次请求最多支持 9 张参考图片、3 段参考视频和 3 条音轨，单段素材时长可达 15 秒。这些素材均放入 metadata.content[]，并在 prompt 中按 @image1 到 @imageN 的顺序引用，从而指定哪张图片驱动动态效果。除轮询外，你也可以设置 metadata.callback_url 启用 Webhook 模式，任务最终状态会被 POST 到你的服务器。可用模型包括 ByteDance Seedance 2.0、Seedance 1.5 Pro、HappyHorse 视频模型以及 Grok Imagine 视频与图像模型。

图生视频如何计费

RelayDance 按生成结果计费，失败请求不产生费用。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」。各模型按秒或按条计价，实时费率见 https://relaydance.com/models：

付款方式支持 USDT 与 Stripe 银行卡，采用 pay-as-you-go 模式。

如何接入现有 OpenAI 代码

RelayDance 采用 OpenAI 兼容协议，无需更换 SDK。据 relaydance.com 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。这意味着你可以直接复用现有 OpenAI 客户端，仅替换 base_url 与 API Key，即可访问 Seedance，无需 BytePlus 企业账户或 KYC。图像生成使用 POST /v1/images/generations，其中 gpt-image-2 的图像输出免费，仅按输入计费，图生图约 ¥0.035 起，4K 与 1K 出图同价。更多接口说明见 https://relaydance.com/docs。

常见问题 FAQ

1. 失败的请求会扣费吗？不会。失败或报错的请求一律不计费（来源 relaydance.com/models）。

2. 一次请求能放几张参考图片？最多 9 张参考图片，另支持 3 段参考视频和 3 条音轨，单段素材可达 15 秒。

3. 接入需要 BytePlus 企业账户或 KYC 吗？不需要，通过 OpenAI 兼容接口（base_url 设为 https://relaydance.com/v1）即可直接访问 Seedance。