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

浏览器直接调用 RelayDance 会触发 CORS 错误，根本原因是视频生成属于服务端接口：请求需在 Authorization: Bearer YOUR_API_KEY 头中携带密钥，而在前端 JavaScript 中暴露密钥并不安全，因此接口未开放跨域访问。正确做法是把 RelayDance 调用放在你自己的服务端，前端只与你的后端通信，由后端向 https://relaydance.com/v1 转发请求并保管密钥。

为什么会报 CORS 错误

CORS 错误出现，是因为视频生成接口按服务端场景设计，未对浏览器跨域请求返回放行头。RelayDance 采用 OpenAI 兼容协议，据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。这类调用需要在请求头中传入 Authorization: Bearer YOUR_API_KEY，密钥在 https://relaydance.com/console 创建。若在浏览器端直接发起请求，不仅会遇到跨域拦截，还会把密钥暴露给终端用户。更多协议细节见 https://relaydance.com/docs。

正确的服务端调用步骤

正确方式是让前端请求你的后端，由后端携带密钥调用 RelayDance。以下为提交视频任务的步骤：

1. 在 https://relaydance.com/console 创建 API Key。
2. 后端把 base_url 设为 https://relaydance.com/v1，并保留 OpenAI SDK。
3. 调用 POST /v1/video/generations，传入 model、prompt、seconds 与 metadata（ratio、resolution、generate_audio、callback_url、content[]）。
4. 轮询 GET /v1/video/generations/{task_id}，直到 status 为 succeeded 或 failed，成功后从结果中读取视频 url。
5. 如需回调，设置 metadata.callback_url，最终状态会 POST 到你的服务器。

参考媒体与限制

参考媒体放在 metadata.content[] 中，并在 prompt 里用 @image1 到 @imageN 引用。每个请求最多支持 9 张参考图、3 段参考视频与 3 条音轨，片段时长最长 15 秒。这些资源的组织同样发生在服务端，因为它们与密钥一并出现在请求体中。把这部分逻辑集中在后端，可以避免前端拼装带密钥的请求体，从源头消除 CORS 拦截与密钥泄露两类问题。图像生成走 POST /v1/images/generations，处理方式一致。

计费与价格参考

RelayDance 按生成的视频计费，失败请求不产生费用，据 relaydance.com 官方文档，「失败或报错的请求一律不计费」。这意味着服务端在轮询到 failed 时无需担心扣费。以下为部分实时费率，完整列表见 https://relaydance.com/models：

支付方式支持 USDT 与 Stripe 卡。

常见问题（FAQ）

问：可以在前端直接调用 RelayDance 吗？不建议。视频生成接口需要在请求头携带 Authorization: Bearer YOUR_API_KEY，前端调用会暴露密钥并触发 CORS 错误，应放在服务端。

问：任务失败会扣费吗？不会。据 relaydance.com 官方文档，「失败或报错的请求一律不计费」，轮询到 failed 状态时不产生费用。

问：如何从 OpenAI 迁移到 RelayDance？据 relaydance.com/docs 官方文档，「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」，在服务端修改 base_url 与密钥即可。