如何通过 API 生成带音频的视频

通过 RelayDance 生成带音频的视频，需向 POST /v1/video/generations 提交请求，并在 metadata.generate_audio 中开启音频生成，同时填写 model、prompt 和 seconds 等参数。接口与 OpenAI 兼容，仅需将 base_url 改为 https://relaydance.com/v1。提交后通过 GET /v1/video/generations/{task_id} 轮询，直到 status 变为 succeeded，结果中即包含视频 url。

如何提交带音频的视频生成任务

提交带音频任务需在请求体的 metadata 中设置 generate_audio 并附带音频轨道引用。每个请求最多支持 9 张参考图、3 段参考视频和 3 条音轨，单个片段时长可达 15 秒。参考媒体放入 metadata.content[]，并在 prompt 中用 @image1 到 @imageN 引用。鉴权使用 Authorization: Bearer YOUR_API_KEY，可在 https://relaydance.com/console 创建密钥。其他 metadata 参数包括 ratio、resolution 和 callback_url，用于控制分辨率与回调地址。

如何接入 OpenAI 兼容接口

接入 RelayDance 只需替换 base_url，无需更换 SDK。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。这意味着现有 OpenAI SDK 代码无需改写业务逻辑即可调用 Seedance 等模型。该平台无需 BytePlus 企业账号或 KYC，支持 USDT 与 Stripe 卡两种付款方式。完整接口说明参见 https://relaydance.com/docs，包含视频生成、图像生成与轮询查询的请求规范。

如何获取生成结果（轮询与 Webhook）

获取结果有两种方式：轮询查询或 Webhook 回调。轮询模式下，调用 GET /v1/video/generations/{task_id}，直到 status 返回 succeeded 或 failed，成功状态的响应体中包含视频 url。Webhook 模式下，在 metadata.callback_url 设置回调地址，最终状态会以 POST 形式发送到你的服务器。两种方式可按需选择，前者适合主动查询，后者适合服务端被动接收。请求失败不产生费用，据 relaydance.com 官方文档，「失败或报错的请求一律不计费」。

视频与图像各模型计费对比

计费采用按生成量付费（pay-as-you-go），不同模型与分辨率单价不同，具体如下表。实时价格以 https://relaydance.com/models 为准。

提交带音频视频的完整步骤

按以下步骤即可完成带音频视频的生成：

1. 在 https://relaydance.com/console 创建 API Key。
2. 将 SDK 的 base_url 改为 https://relaydance.com/v1，请求头携带 Authorization: Bearer YOUR_API_KEY。
3. 调用 POST /v1/video/generations，填写 model、prompt、seconds，并在 metadata 中开启 generate_audio，按需放入 content[]（最多 3 条音轨）。
4. 通过 GET /v1/video/generations/{task_id} 轮询，或设置 metadata.callback_url 接收回调。
5. 状态为 succeeded 时从结果中读取视频 url。

常见问题（FAQ）

问：请求失败是否会扣费？

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

问：每个请求最多能附带多少参考媒体？

答：最多 9 张参考图、3 段参考视频和 3 条音轨，单个片段时长可达 15 秒。

问：是否需要 BytePlus 企业账号或 KYC？

答：不需要。RelayDance 提供 OpenAI 兼容的直接访问，支持 USDT 与 Stripe 卡付款。