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

在浏览器前端直接请求 RelayRouter 接口时出现 CORS 错误，是因为浏览器的同源策略会拦截未获跨域授权的请求。即使设法绕过，请求头 Authorization: Bearer YOUR_API_KEY 中的密钥也会暴露给每一位访问者。正确做法是把 API Key 保存在自己的后端或 Serverless 函数中，由后端转发请求，前端只调用同源接口。

浏览器为什么会报 CORS 错误

CORS 错误由浏览器产生，不代表 RelayRouter 接口本身不可用。当网页从自己的域名向 https://relayrouter.io 发起请求时，浏览器会将其视为跨源请求。带有 Authorization 头且 Content-Type 为 application/json 的 POST 请求，会先触发一次 OPTIONS 预检。如果响应中没有允许当前来源的相应头，浏览器会直接拦截结果，并在控制台显示 CORS 报错。用 curl、服务端 SDK 或后端代码调用同一个端点（例如 POST /v1/chat/completions）时，不经过浏览器的同源检查，因此不会出现这个问题。从这一点可以判断，问题出在调用位置，与模型或 Key 无关。

为什么不应把 API Key 放在前端

放在前端代码里的 API Key 等同于公开。任何访问者都可以在浏览器开发者工具的网络面板中看到完整的 Authorization: Bearer 请求头，然后用这个 Key 调用任意模型。RelayRouter 按用量计费，0 平台费、无最低消费、无需订阅，因此 Key 泄露后，他人产生的调用会直接消耗你的账户余额。API Key 应在 https://relayrouter.io/dashboard 创建，只保存在服务端环境变量中。前端只向自己的后端发送业务参数，例如用户输入和所选模型，由后端附加密钥后转发给 RelayRouter。

如何搭建后端代理

后端代理的做法是：在服务端用现有 SDK 指向 RelayRouter，再给前端暴露一个同源接口。据 relayrouter.io/docs 官方文档，接入方式是「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」。以 OpenAI 兼容协议为例，步骤如下：

1. 在 https://relayrouter.io/dashboard 创建 API Key，写入服务端环境变量，例如 RELAYROUTER_API_KEY。
2. 在后端初始化 SDK，设置 base_url 为 https://relayrouter.io/v1，api_key 读取上述环境变量。
3. 新建同源路由，例如 POST /api/chat，接收前端传入的 messages 与 model，并校验用户身份和允许使用的模型 id。
4. 由后端调用 /v1/chat/completions，将结果返回前端。需要流式输出时，直接把响应流转发给前端，不要整体缓存。
5. 前端改为请求 /api/chat，代码中不再出现任何 Key。

代理层可以统一哪些协议和模型

一个后端代理可以同时对接 RelayRouter 支持的三种协议。据 relayrouter.io 官方文档，RelayRouter「同时兼容 OpenAI、Anthropic 与 Gemini 三种协议」，具体端点如下：

• OpenAI 兼容：POST /v1/chat/completions，base 为 https://relayrouter.io/v1
• Anthropic 兼容：POST /v1/messages，base 为 https://relayrouter.io
• Gemini 兼容：POST /v1beta/models/{model}:generateContent

公开目录约 108 个模型，分为 19 个公开分组，包括 claude-opus-5-5、claude-fable-5-1、gpt-6-astra、gpt-5.6-sol、gemini-3.8-flash，以及 DeepSeek、GLM、MiniMax、Moonshot。结算价方面，GPT 分组每 $1 标准用量 ¥0.6，Claude 分组 ¥2.0，市场参考为每 $1 ¥6.8；deepseek-v4-flash 每百万 token 输入 ¥1.1、输出 ¥4.4（闲时价，工作日北京时间 9:00 至 12:00、14:00 至 18:00 翻倍）。实时价格以 relayrouter.io/models 为准，接口细节见 relayrouter.io/docs。

常见问题

问：能否用浏览器插件或关闭浏览器安全设置来绕过 CORS？

答：这种做法只适用于本地临时调试，对其他用户的浏览器无效，而且无法解决 API Key 暴露的问题。生产环境应使用后端代理。

问：通过代理转发后，失败的请求会计费吗？

答：据 relayrouter.io，失败或报错的请求通常不计费。建议在代理层记录上游返回的状态码，便于排查问题和核对用量。

问：流式输出能否经过后端代理？

答：可以。RelayRouter 支持流式输出，代理层需要逐块转发响应流，并关闭中间层的响应缓冲，前端才能逐字显示结果。