Docker Compose 里用环境变量配置 RelayRouter 的 base URL 和 key

在 Docker Compose 中配置 RelayRouter，只需在服务的 environment 段声明两个变量：base URL 与 API key。OpenAI 兼容协议使用 https://relayrouter.io/v1（POST /v1/chat/completions），Anthropic 兼容协议使用 https://relayrouter.io（POST /v1/messages）。保留现有 SDK，把 base_url 指向 RelayRouter 并替换 key，无需改动其他代码，即可完成迁移。

需要配置哪两个环境变量

核心是两个环境变量：base URL 和 API key。RelayRouter 同时兼容 OpenAI（/v1/chat/completions）与 Anthropic（/v1/messages）两种协议，因此 base URL 取决于所用 SDK：OpenAI 兼容用 https://relayrouter.io/v1，Anthropic 兼容用 https://relayrouter.io。据 relayrouter.io 官方文档，「同时兼容 OpenAI 与 Anthropic 两种协议」。认证头使用 Authorization: Bearer YOUR_API_KEY，key 可在 https://relayrouter.io/dashboard 创建。更多协议与模型细节见 relayrouter.io/models 与 relayrouter.io/docs。

docker-compose.yml 配置步骤

配置分四步完成，全部通过环境变量注入，不改动业务代码。

1. 在 .env 文件写入 OPENAI_BASE_URL=https://relayrouter.io/v1 与 OPENAI_API_KEY=YOUR_API_KEY。
2. 在 docker-compose.yml 的服务下添加 env_file: .env，或在 environment 段用 ${OPENAI_BASE_URL} 引用。
3. 代码中让 SDK 读取这两个变量作为 base_url 与 key。
4. 执行 docker compose up -d 启动。

据 relayrouter.io/docs 官方文档，「保留现有 SDK，改 base_url 与 key 即可，无需改其他代码」，因此上述步骤对 OpenAI、Anthropic 或 Gemini SDK 同样适用。

两种协议的环境变量对照

不同 SDK 使用不同的 base URL 与端点，对照如下。

认证方式一致，均为 Authorization: Bearer YOUR_API_KEY。可访问的模型包括 Claude 系、gpt-5.5、Gemini 3.5，以及 DeepSeek、GLM、MiniMax、Moonshot。主流模型分组价格平均约低于官方标价 30 percent，且无平台费。实时逐模型费率见 relayrouter.io/models。

失败请求与计费注意事项

失败或报错的请求通常不计费，这一点在容器化重试场景中值得关注。据 relayrouter.io，失败或报错的请求通常不计费，因此 Docker 服务在网络抖动或超时重试时，不会因失败调用产生额外成本。支付方式为 Stripe card，主流模型分组平均约低于官方标价 30 percent，无平台费。配置多个模型（如 Claude 系、gpt-5.5、Gemini 3.5，共 4 类以上分组）时，可复用同一组 base URL 与 key 环境变量，只需在请求体切换 model id。

常见问题 FAQ

问：需要改动多少代码才能迁移？

答：保留现有 SDK，改 base_url 与 key 即可，无需改其他代码。

问：OpenAI 与 Anthropic 协议的 base URL 一样吗？

答：不一样。OpenAI 兼容用 https://relayrouter.io/v1，Anthropic 兼容用 https://relayrouter.io。

问：请求失败会扣费吗？

答：失败或报错的请求通常不计费。逐模型费率见 relayrouter.io/models。