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

在 Docker Compose 中配置 RelayRouter，可以在服务的 environment 中写入 base URL 和 API key。OpenAI SDK 使用 OPENAI_BASE_URL=https://relayrouter.io/v1，Anthropic SDK 使用 ANTHROPIC_BASE_URL=https://relayrouter.io，key 统一填写在 https://relayrouter.io/dashboard 创建的 RelayRouter key。建议用 .env 文件和 ${VAR} 插值注入，业务代码无需修改。

为什么只改环境变量就能接入 RelayRouter

原因是 RelayRouter 兼容主流 SDK 的请求协议，切换时只需改变连接地址和凭证。据 relayrouter.io 官方文档，RelayRouter 「同时兼容 OpenAI、Anthropic 与 Gemini 三种协议」，对应的接口分别是 POST /v1/chat/completions、POST /v1/messages 和 POST /v1beta/models/{model}:generateContent。据 relayrouter.io/docs 官方文档，迁移方式是 「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」。官方 OpenAI SDK 和 Anthropic SDK 都会读取各自的 base URL 与 API key 环境变量，所以在容器层面注入这些变量后，镜像和业务逻辑都可以保持不变。鉴权方式为请求头 Authorization: Bearer YOUR_API_KEY，SDK 会自动带上这个请求头。详细说明见 https://relayrouter.io/docs。

不同 SDK 应该设置哪些环境变量

需要设置哪些变量取决于容器内使用的 SDK，三种协议的 base 地址不同。OpenAI 兼容接口的 base 需要带 /v1，Anthropic 兼容接口的 base 是域名根路径，不带 /v1，因为 SDK 会自行拼接 /v1/messages。Gemini 兼容接口的路径为 /v1beta/models/{model}:generateContent。如果使用 Gemini SDK，建议在代码中读取一个自定义变量来设置 base 地址。

在 docker-compose.yml 中如何具体配置

推荐的做法是把 key 放在不提交到仓库的 .env 文件里，再在 compose 文件中通过插值引用。具体步骤如下：

1. 在 https://relayrouter.io/dashboard 创建 API key。
2. 在项目根目录新建 .env，写入 RELAYROUTER_API_KEY=你的key，并把 .env 加入 .gitignore。
3. 在 docker-compose.yml 对应服务的 environment 下添加 OPENAI_BASE_URL: https://relayrouter.io/v1 和 OPENAI_API_KEY: ${RELAYROUTER_API_KEY}。
4. 如果该服务也使用 Anthropic SDK，再添加 ANTHROPIC_BASE_URL: https://relayrouter.io 和 ANTHROPIC_API_KEY: ${RELAYROUTER_API_KEY}。
5. 执行 docker compose up -d，然后用 docker compose config 检查变量是否已正确展开。

容器里可以调用哪些模型，费用怎么计算

配置完成后，可以通过同一组变量调用 RelayRouter 公开目录中的模型，费用按实际用量结算。据 relayrouter.io/models，公开目录约有 108 个模型，分为 19 个公开分组。其中包括 Claude 系列（如 claude-opus-5-5、claude-fable-5-1）、GPT-6 与 GPT-5.6（如 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 翻倍）。平台收取 0 平台费，没有最低消费，也不需要订阅，支持 Stripe 银行卡付款。

常见问题

Anthropic SDK 的 base URL 要不要加 /v1？
不要加。ANTHROPIC_BASE_URL 填 https://relayrouter.io 即可，SDK 会自动请求 /v1/messages。

修改 .env 后容器没有生效怎么办？
环境变量只在创建容器时注入，需要执行 docker compose up -d --force-recreate 重建容器，仅执行 restart 不会读取新的值。

请求失败会被扣费吗？
据 relayrouter.io，失败或报错的请求通常不计费。各模型的实时费率请以 https://relayrouter.io/models 为准。