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

通过 RelayDance 生成带音频的视频,需向 POST /v1/video/generations 提交请求,在 body 中填写 model、prompt 与 seconds,并在 metadata 内将 generate_audio 设为 true。接口为 OpenAI 兼容协议,base_url 使用 https://relaydance.com/v1,鉴权使用 Authorization: Bearer YOUR_API_KEY。提交后通过 GET /v1/video/generations/{task_id} 轮询,直到状态为 succeeded 并取回视频 url。

生成带音频视频的完整步骤

带音频视频的核心是在 metadata.generate_audio 中开启音频输出。RelayDance 采用 OpenAI 兼容协议,据 relaydance.com/docs 官方文档,「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。具体流程如下:

1. 在 https://relaydance.com/console 创建 API Key。
2. 将 base_url 设为 https://relaydance.com/v1,添加 Authorization: Bearer YOUR_API_KEY。
3. 调用 POST /v1/video/generations,传入 model、prompt、seconds,并设置 metadata.generate_audio。
4. 轮询 GET /v1/video/generations/{task_id},状态为 succeeded 或 failed。
5. 从 succeeded 结果中读取视频 url。

参考媒体与请求上限

参考媒体放在 metadata.content[] 中,并在 prompt 里用 @image1 到 @imageN 引用。单次请求最多支持 9 张参考图像、3 段参考视频与 3 条音频轨道,视频片段长度最长为 15 秒。音频轨道可结合 generate_audio 用于控制生成视频的声音内容。此外,请求还可通过 metadata 设置 ratio、resolution 与 callback_url。若设置 metadata.callback_url,最终状态会以 Webhook 形式 POST 到你的服务器,无需持续轮询。详细字段说明见 https://relaydance.com/docs。

可选模型与计价

RelayDance 提供 ByteDance Seedance 系列等多种视频模型,按生成视频量后付费计价。以下为部分实时价格(以 relaydance.com/models 为准):

价格随模型实时更新,建议以官方 models 页面为准。

计费规则与鉴权

RelayDance 采用按量付费,失败请求不产生费用。据 relaydance.com 官方文档,「失败或报错的请求一律不计费」,因此轮询到 failed 状态的任务不会计入账单。支付方式支持 USDT 与 Stripe 卡支付。鉴权统一使用 Authorization: Bearer YOUR_API_KEY,密钥在 console 创建。若使用 gpt-image-2 出图,图像输出免费,只按输入计费,图生图约 ¥0.035 起,且 4K 与 1K 出图同价。直接通过 OpenAI 兼容方式访问 Seedance,无需 BytePlus 企业账户或 KYC。

常见问题 FAQ

问:如何在生成的视频中加入音频?在 POST /v1/video/generations 的 metadata 中设置 generate_audio,并可在 metadata.content[] 中提供最多 3 条音频轨道作为参考。

问:任务失败会扣费吗?不会。据 relaydance.com 官方文档,「失败或报错的请求一律不计费」。

问:一次请求可以引用多少参考图像?单次请求最多 9 张参考图像,同时支持 3 段参考视频与 3 条音频轨道,片段最长 15 秒。