如何通过 API 生成 4K 视频

通过 RelayDance 生成 4K 视频，需要向 POST /v1/video/generations 提交任务，在请求体中指定 model、prompt 和 seconds 参数，并在 metadata 中设置 resolution 与 ratio。RelayDance 采用 OpenAI 兼容协议，base_url 为 https://relaydance.com/v1。Seedance 原生 4K 价格约 $4.90 / 5 秒条，1080p 价格约 $0.470 / 秒。任务提交后通过轮询或 webhook 获取最终视频 url。

调用接口的基本步骤

生成 4K 视频需按提交任务、轮询状态、获取 url 三步完成。RelayDance 采用 OpenAI 兼容协议，据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。

1. 提交任务：向 POST /v1/video/generations 发送 model、prompt、seconds 及 metadata（ratio、resolution、generate_audio、callback_url）。
2. 轮询状态：调用 GET /v1/video/generations/{task_id}，直到 status 为 succeeded 或 failed。
3. 获取结果：succeeded 状态的响应中包含视频 url。
4. 认证方式：请求头携带 Authorization: Bearer YOUR_API_KEY，密钥在 https://relaydance.com/console 创建。

各分辨率的计费差异

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

4K 采用按条计费，与按秒计费的其他规格不同，实际选型时可结合时长与预算比较。

使用参考媒体与 webhook

参考媒体放入 metadata.content[] 并在 prompt 中以 @image1 到 @imageN 引用。单次请求最多支持 9 张参考图像、3 段参考视频和 3 条音轨，单个片段时长不超过 15 秒。

• Webhook 模式：设置 metadata.callback_url，任务最终状态将 POST 到你的服务器。
• 轮询模式：重复调用 GET /v1/video/generations/{task_id} 获取状态。
• 音频控制：通过 metadata.generate_audio 控制是否生成音频。
• 画面比例：通过 metadata.ratio 指定输出比例。

支付与访问方式

RelayDance 支持 USDT 与 Stripe 卡两种付款方式，计费为按生成视频量的 pay-as-you-go 模式。它提供对 Seedance 的 OpenAI 兼容访问，无需 BytePlus 企业账户或 KYC。除视频模型外，gpt-image-2 的图像输出免费，仅按输入计费，图生图约 ¥0.035 起，且 4K 与 1K 出图同价。图像生成使用 POST /v1/images/generations 接口，详见 https://relaydance.com/docs。

常见问题（FAQ）

问：请求失败会扣费吗？

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

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

答：不需要。RelayDance 提供对 Seedance 的 OpenAI 兼容访问，无需 BytePlus 企业账户或 KYC。

问：单次请求可上传多少参考素材？

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