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

通过 RelayDance 生成带音频的视频，只需向 POST /v1/video/generations 提交请求，在 metadata 中将 generate_audio 设为 true，并填写 model、prompt 与 seconds。接口为 OpenAI 兼容，将 base_url 指向 https://relaydance.com/v1 即可。随后轮询 GET /v1/video/generations/{task_id}，当 status 为 succeeded 时可从结果中取得视频 url。

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

提交带音频视频任务的方式是向 POST /v1/video/generations 发送 JSON 请求，并开启 metadata.generate_audio。请求体包含 model、prompt、seconds，以及 metadata（可含 ratio、resolution、generate_audio、callback_url）。鉴权使用 Authorization: Bearer YOUR_API_KEY，API Key 在 https://relaydance.com/console 创建。可用模型包括 ByteDance Seedance 2.0 与 Seedance 1.5 Pro、HappyHorse 视频模型，以及 Grok Imagine 视频与图像模型。单次请求最多支持 9 张参考图片、3 段参考视频与 3 条音频轨道，片段时长最长 15 秒。

如何获取生成结果

获取结果有两种方式：轮询任务状态或使用 Webhook 回调。轮询模式下，持续请求 GET /v1/video/generations/{task_id}，直到 status 变为 succeeded 或 failed，成功结果中包含视频 url。Webhook 模式下，在 metadata.callback_url 中填入你的服务器地址，最终状态会以 POST 方式推送给你。参考媒体放入 metadata.content[]，并在 prompt 中以 @image1 到 @imageN 的形式引用。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，因此现有 OpenAI SDK 代码改动很小。

各模型价格如何计费

视频计费为按生成量的 pay-as-you-go 模式，不同模型与分辨率单价不同。据 relaydance.com/docs 官方文档，「失败或报错的请求一律不计费」，即失败或报错的请求不产生费用。以下为部分单价，实时费率见 https://relaydance.com/models：

图像方面，gpt-image-2 的图像输出免费，只按输入计费，图生图约 ¥0.035 起，4K 与 1K 出图同价。

接入的具体步骤是什么

接入 RelayDance 生成带音频视频的步骤如下，全程无需 BytePlus 企业账号或 KYC：

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 中设置 generate_audio 为 true。
4. 如需参考媒体，放入 metadata.content[] 并在 prompt 中以 @image1 引用。
5. 轮询 GET /v1/video/generations/{task_id} 或配置 metadata.callback_url 接收 Webhook。

支付方式支持 USDT 与 Stripe 信用卡。

常见问题

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

问：单次请求可以引用多少参考媒体？
最多 9 张参考图片、3 段参考视频与 3 条音频轨道，片段时长最长 15 秒。

问：可以直接用 OpenAI SDK 调用吗？
可以，接口为 OpenAI 兼容，将 base_url 改为 https://relaydance.com/v1 即可，无需 BytePlus 企业账号或 KYC。