一个请求同时用参考视频和参考音频：图片之外的多参考用法

在 RelayDance 中，一个请求可同时携带参考视频和参考音频：把媒体放入 metadata.content[]，在 prompt 中用 @image1 到 @imageN 引用。单次请求上限为 9 张参考图像、3 段参考视频和 3 条音频轨道，片段长度最高 15 秒。接口为 OpenAI 兼容，通过 POST /v1/video/generations 提交任务，详见 relaydance.com/docs。

如何在一个请求里组合参考视频与参考音频

参考媒体统一放入 metadata.content[]，视频与音频可在同一个数组中共存。每个请求支持最多 3 段参考视频、3 条音频轨道以及 9 张参考图像，单段片段长度上限为 15 秒。提交时使用 POST /v1/video/generations，并在 prompt 里以 @image1 到 @imageN 的形式引用这些媒体。接口保留 OpenAI 兼容形式，据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，因此现有客户端无需重写即可携带多参考媒体发起生成任务。

提交多参考请求的步骤

多参考请求的提交流程分为提交、轮询和取回三步。

1. 调用 POST /v1/video/generations，填写 model、prompt、seconds，并在 metadata.content[] 中放入参考视频与参考音频（最多 3 段视频、3 条音频）。
2. 在 prompt 中用 @image1 到 @imageN 引用对应媒体；也可设置 metadata.callback_url 启用 Webhook 回调。
3. 轮询 GET /v1/video/generations/{task_id}，直到 status 为 succeeded 或 failed，成功后结果包含视频 url。

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

参考媒体的数量与长度限制

单次请求的参考媒体受固定上限约束。可携带最多 9 张参考图像、3 段参考视频和 3 条音频轨道，任何片段长度上限为 15 秒。所有媒体都在 metadata.content[] 中声明，并通过 prompt 中的 @image1 到 @imageN 标记建立对应关系。下表汇总各类参考媒体的数量上限：

计费与失败处理

多参考请求按生成的视频用量计费，失败不额外扣费。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，因此提交带视频与音频的任务不会因报错产生费用。按模型计费，例如 Seedance 2.0 720p 约 $0.190 / 秒，1080p 约 $0.470 / 秒，Seedance Fast 约 $0.152 / 秒，Seedance 原生 4K 约 $4.90 / 5 秒条。支付方式包括 USDT 与 Stripe 卡。各模型实时费率见 relaydance.com/models。

常见问题

一个请求能同时放视频和音频吗？可以，两者都放在 metadata.content[] 中，单请求支持最多 3 段视频与 3 条音频。

参考片段最长多久？任何参考片段长度上限为 15 秒。

任务失败会扣费吗？不会，失败或报错的请求一律不计费。