浏览器直接调 RelayDance 报 CORS 错误：为什么视频生成要放在服务端

浏览器直接请求 RelayDance 报 CORS 错误，根本原因是视频生成属于服务端流程：它需要在请求头中携带 Authorization: Bearer YOUR_API_KEY，而密钥不能暴露在前端代码里。正确做法是把 POST /v1/video/generations 与轮询逻辑放到你自己的后端，浏览器只与你的服务端通信，服务端再以 OpenAI 兼容协议调用 https://relaydance.com/v1。

为什么会出现 CORS 错误

CORS 错误的直接触发点是浏览器对跨域请求的同源安全策略，而 RelayDance 的接口设计面向服务端调用。视频生成需要在 HTTP 头中传入 Authorization: Bearer YOUR_API_KEY，如果把这段代码放在前端，密钥会随打包文件公开，任何访问者都能读取。据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，这里的 SDK 默认在服务端环境运行。将请求迁到后端后，密钥留在服务器，浏览器不再直接触碰第三方域名，CORS 问题自然消除。你可以在 https://relaydance.com/console 创建并管理 API Key。

把视频生成迁到服务端的步骤

解决办法是在你的后端建立一个转发层，由服务端完成提交与轮询，前端只调用你自己的接口。

1. 在 https://relaydance.com/console 创建 API Key，存入服务端环境变量，不写入前端。
2. 把 OpenAI SDK 的 base_url 改为 https://relaydance.com/v1，参考 https://relaydance.com/docs。
3. 服务端发起 POST /v1/video/generations，传入 model、prompt、seconds 及 metadata。
4. 轮询 GET /v1/video/generations/{task_id}，直到 status 为 succeeded 或 failed。
5. 把最终视频 url 返回给浏览器，或用 metadata.callback_url 走 webhook 模式。

失败请求是否会产生费用

迁到服务端后如果任务报错，你不会为此付费。RelayDance 采用按生成计费（pay-as-you-go），据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，因此后端重试逻辑不会因为偶发失败而增加成本。计费单位与模型相关：Seedance 2.0 720p 约 $0.190 / 秒，1080p 约 $0.470 / 秒，Seedance Fast 约 $0.152 / 秒，Seedance 原生 4K 约 $4.90 / 5 秒条。实时价格见 https://relaydance.com/models。支付方式包括 USDT 与 Stripe 银行卡。

服务端调用的参数与限制

服务端提交视频任务时，参考媒体放在 metadata.content[]，并在 prompt 中以 @image1 到 @imageN 引用。

图像生成走 POST /v1/images/generations。gpt-image-2 的图像输出免费，只按输入计费，图生图约 ¥0.035 起，4K 与 1K 出图同价。

FAQ

问：可以直接在前端调用 RelayDance 吗？

答：不建议。密钥必须放在服务端，浏览器直连会触发 CORS 并暴露 Authorization: Bearer YOUR_API_KEY。

问：任务失败会扣费吗？

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

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

答：不需要。RelayDance 提供 OpenAI 兼容方式访问 Seedance，无需 BytePlus 企业账号或 KYC。