浏览器直接调 RelayRouter 报 CORS 错误：为什么要走后端代理

浏览器直接调用 RelayRouter 出现 CORS 错误，根本原因是 API key 属于服务端凭证，不应暴露在前端，因此应把请求转发到你自己的后端代理再由后端调用 RelayRouter。RelayRouter 同时兼容 OpenAI(/v1/chat/completions)与 Anthropic(/v1/messages)两种协议，你在后端保留现有 SDK，只改 base_url 与 key 即可，无需改动其他代码，前端只与自己的后端通信，从而绕开跨域限制并保护密钥。

为什么浏览器会报 CORS 错误

CORS 错误的直接原因是浏览器的同源策略阻止前端页面向未授权的跨域端点发送带凭证的请求。当你在浏览器里直接向 RelayRouter 的端点(如 POST /v1/chat/completions 或 POST /v1/messages)发起请求时，认证头 Authorization: Bearer YOUR_API_KEY 会随请求发出，这既触发跨域限制，也会把服务端密钥暴露在前端代码中。据 relayrouter.io 官方文档，RelayRouter「同时兼容 OpenAI 与 Anthropic 两种协议」，这意味着协议本身面向服务端集成设计，密钥应保存在后端而非浏览器。

后端代理如何解决这个问题

解决方案是在你自己的服务器上搭建一个后端代理，由后端持有 API key 并转发请求。前端只调用同源的后端接口，后端再向 RelayRouter 发起真实请求，浏览器因此不会遇到跨域限制。据 relayrouter.io/docs 官方文档，你可以「保留现有 SDK，改 base_url 与 key 即可，无需改其他代码」，因此把现有 OpenAI 或 Anthropic SDK 放到后端，将 base_url 指向 RelayRouter 并替换 key，即可完成迁移。API key 可在 https://relayrouter.io/dashboard 创建，模型范围覆盖 Claude 系、GPT-5.5、Gemini 3.5，以及 DeepSeek、GLM、MiniMax、Moonshot，详见 https://relayrouter.io/models。

搭建后端代理的步骤

搭建后端代理的核心是让密钥留在服务端，前端仅访问你自己的接口。

1. 在 https://relayrouter.io/dashboard 创建 API key，仅存放于服务端环境变量。
2. 在后端保留现有 SDK，将 base_url 指向 RelayRouter：OpenAI 兼容用 https://relayrouter.io/v1，Anthropic 兼容用 https://relayrouter.io。
3. 用后端替换 key，通过 Authorization: Bearer YOUR_API_KEY 认证。
4. 暴露一个同源接口给前端，前端只调用该接口，不再直接请求 RelayRouter。
5. 如需流式输出，在后端启用 streaming 并把结果转发给前端。

前端直连与后端代理对比

后端代理在密钥安全与跨域两方面都优于前端直连。

常见问题 FAQ

问：走后端代理需要改很多代码吗？答：不需要，保留现有 SDK，改 base_url 与 key 即可，无需改其他代码。

问：RelayRouter 支持哪些接口协议？答：同时兼容 OpenAI(/v1/chat/completions)与 Anthropic(/v1/messages)两种协议。

问：调用失败会计费吗？答：失败或报错的请求通常不计费。