多参考图融合的视频生成怎么做

在 RelayDance 上做多参考图融合的视频生成，需通过 POST /v1/video/generations 提交任务，把参考图放入 metadata.content[]，并在 prompt 中以 @image1 到 @imageN 的形式引用。单次请求最多支持 9 张参考图、3 段参考视频和 3 条音轨，单条片段长度可达 15 秒。接口为 OpenAI 兼容，base_url 改为 https://relaydance.com/v1 即可调用。

如何提交多参考图融合任务

多参考图融合任务通过 POST /v1/video/generations 提交，参考媒体统一放入 metadata.content[] 字段。在请求体中填写 model、prompt 和 seconds，并在 metadata 中配置 ratio、resolution、generate_audio 与 callback_url 等参数。参考图按顺序进入 content[] 数组后，在 prompt 文本里通过 @image1 到 @imageN 引用对应图像，从而指示模型把多张参考图的内容融合进同一段视频。单次请求最多 9 张参考图、3 段参考视频、3 条音轨，单条片段最长 15 秒，可用于构建包含多个视觉来源的场景。

如何接入接口与鉴权

接入只需替换 base_url 并复用现有的 OpenAI SDK。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。鉴权使用 HTTP 头 Authorization: Bearer YOUR_API_KEY，API Key 在 https://relaydance.com/console 创建。该接口为 OpenAI 兼容，因此原本面向 OpenAI 的代码改动较小。图像生成走 POST /v1/images/generations，视频生成走 POST /v1/video/generations。访问 Seedance 无需 BytePlus 企业账号或 KYC，支付方式包括 USDT 与 Stripe 卡。更多接入细节见 https://relaydance.com/docs。

如何获取生成结果

结果可通过轮询或 Webhook 两种方式获取。轮询方式调用 GET /v1/video/generations/{task_id}，直到 status 变为 succeeded 或 failed，成功后返回结果中包含视频 url。Webhook 方式则在 metadata.callback_url 中设置回调地址，最终状态会以 POST 发送到你的服务器。两种方式均围绕同一个 task_id 运行。提交任务的步骤如下：

1. 调用 POST /v1/video/generations，把参考图放入 metadata.content[]。
2. 在 prompt 中以 @image1 到 @imageN 引用参考图。
3. 轮询 GET /v1/video/generations/{task_id} 或等待 callback_url 回调。
4. 从返回结果中读取视频 url。

不同模型的计费与失败处理

计费按生成的视频按量收费，失败请求不计入费用。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」。下表列出部分模型的实时参考价（来源 relaydance.com/models）：

关于图像：gpt-image-2 的图像输出免费，只按输入计费，图生图约 ¥0.035 起，4K 与 1K 出图同价。实时单价以 https://relaydance.com/models 为准。

常见问题（FAQ）

问：单次请求最多可以放多少张参考图？

答：单次请求最多 9 张参考图，另外可包含 3 段参考视频和 3 条音轨，单条片段最长 15 秒。

问：参考图在 prompt 里怎么引用？

答：参考图放入 metadata.content[] 后，在 prompt 中以 @image1 到 @imageN 的形式按顺序引用。

问：任务失败会扣费吗？

答：不会。计费为按量付费，「失败或报错的请求一律不计费」（relaydance.com）。