如何通过 API 生成 4K 视频

通过 RelayDance 生成 4K 视频，需向 POST /v1/video/generations 提交请求，并在请求中指定 model、prompt 与 seconds，配合 metadata 设置 resolution 等参数。RelayDance 采用 OpenAI 兼容协议，base_url 改为 https://relaydance.com/v1 即可调用。Seedance 原生 4K 价格约为 $4.90 / 5 秒条（来源 relaydance.com/models），按生成视频计费，失败请求不计费。

调用接口的基本步骤

生成 4K 视频可按提交任务、轮询状态、获取结果三步完成。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）。
2. 轮询状态：调用 GET /v1/video/generations/{task_id}，直到 status 为 succeeded 或 failed。
3. 获取结果：成功后从返回结果中读取 video url。也可在 metadata.callback_url 设置 webhook，由服务端接收最终状态。

4K 与各分辨率的价格对比

不同分辨率与模型按各自费率计费，4K 采用按条计价，其余按秒计价。下表列出 Seedance 系列的实时费率参考（来源 relaydance.com/models）。

以原生 4K 为例，单条 5 秒视频费用约为 $4.90，按生成视频结算，便于按需控制成本。

参考媒体与请求限制

生成视频时可在 metadata.content[] 中加入参考媒体，并在 prompt 中以 @image1 至 @imageN 引用。每次请求最多支持 9 张参考图像、3 个参考视频和 3 条音频轨道，单段素材时长上限为 15 秒。设置 generate_audio 可控制是否生成音频，ratio 与 resolution 用于指定画面比例和清晰度。需要图像生成时可调用 POST /v1/images/generations，其中 gpt-image-2 的图像输出免费，仅按输入计费，图生图约 ¥0.035 起，4K 与 1K 出图同价。

计费方式与认证

RelayDance 采用按生成视频计费的 pay-as-you-go 模式，失败请求不产生费用。据 relaydance.com 官方文档：「失败或报错的请求一律不计费」。认证使用请求头 Authorization: Bearer YOUR_API_KEY，API Key 可在 https://relaydance.com/console 创建。支付方式支持 USDT 与 Stripe 卡。该服务提供 OpenAI 兼容方式直接访问 Seedance，无需 BytePlus 企业账户或 KYC。详细接口说明见 relaydance.com/docs。

常见问题 FAQ

问：生成 4K 视频失败会扣费吗？不会。失败或报错的请求一律不计费。

问：原生 4K 视频如何计价？Seedance 原生 4K 价格约为 $4.90 / 5 秒条（来源 relaydance.com/models）。

问：能否沿用现有的 OpenAI SDK？可以，将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用。