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

RelayDance 是一套 OpenAI 兼容的 AI 视频生成 API，可将一张图片作为参考媒体驱动为动态视频。核心步骤是：把参考图放入 metadata.content[]，在 prompt 中用 @image1 引用，向 POST /v1/video/generations 提交任务，再轮询任务状态直至 succeeded。base_url 改为 https://relaydance.com/v1 即可，单张请求最多支持 9 张参考图，失败或报错的请求一律不计费。

如何用一张图片生成视频

图生视频通过 metadata.content[] 传入参考图并在 prompt 中引用即可完成。将图片放入 content[] 数组，然后在文本中用 @image1 到 @imageN 的形式引用，向 POST /v1/video/generations 提交 model、prompt、seconds 等参数。单张请求最多支持 9 张参考图、3 段参考视频与 3 条音轨，单个片段时长最长 15 秒。接入方式与 OpenAI 一致，据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，无需 BytePlus 企业账号或 KYC。详见 https://relaydance.com/docs。

提交与查询任务的步骤

图生视频任务采用提交加轮询（或 webhook 回调）两种方式获取结果。具体流程如下：

1. 向 POST /v1/video/generations 提交请求，携带 model、prompt、seconds 及 metadata（ratio、resolution、generate_audio、content[] 参考媒体）。
2. 在 prompt 中用 @image1 引用 metadata.content[] 里的参考图。
3. 调用 GET /v1/video/generations/{task_id} 轮询，直到 status 为 succeeded 或 failed，结果中包含视频 url。
4. 如需回调，可设置 metadata.callback_url，最终状态会以 POST 方式推送到你的服务器。

鉴权使用 Authorization: Bearer YOUR_API_KEY，API Key 在 https://relaydance.com/console 创建。

图生视频的价格与计费

RelayDance 采用按生成量的 pay-as-you-go 计费，不同分辨率单价不同。以下为各档参考价格，实时费率见 https://relaydance.com/models：

据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，因此调试阶段的报错请求不会产生费用。支付支持 USDT 与 Stripe 银行卡。

图像生成与出图计费

除视频外，RelayDance 也提供图像接口 POST /v1/images/generations，用于图生图等场景。以 gpt-image-2 为例，图像输出免费，只按输入计费；图生图约 ¥0.035 起，且 4K 与 1K 出图同价。这一计费方式对生成参考图或批量处理素材的工作流具有可预算性。所有模型的实时费率均可在 https://relaydance.com/models 查询。RelayDance 提供与 OpenAI 兼容的直连方式访问 Seedance，无需 BytePlus 企业账号或 KYC 流程。

常见问题（FAQ）

问：图生视频最多能传几张参考图？
答：单张请求最多支持 9 张参考图、3 段参考视频与 3 条音轨，单个片段最长 15 秒。

问：请求失败会扣费吗？
答：不会。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」。

问：需要 BytePlus 企业账号或 KYC 吗？
答：不需要。RelayDance 提供 OpenAI 兼容的直连方式访问 Seedance，无需 BytePlus 企业账号或 KYC。