一句话结论
官方 Key 配 api.openai.com，中转 Key 配中转站给的 BASE_URL，模型名以平台列表为准。
适用场景
- 同时有 OpenAI 和 1A1API 的 Key
- 切来切去搞混了
- 想知道哪些工具能直接用中转 Key
常见现象
- Key 没问题但报 401
- 模型名能选，但调用就报 model not found
- 扣费速度和预期对不上
原因解释
- Key 和 BASE_URL 不匹配（官方 Key 走中转、或反过来）
- 模型名只在某一边可用
- 中转站计费可能包含模型基准价、输入 / 输出 / 缓存费率、倍率或分组规则，应以当前控制台为准
解决步骤
- 在安全凭据存储或部署平台 Secret 中维护两套 Key，并用清楚的环境变量名区分用途
- BASE_URL 一定要和 Key 配套，绝不混填
- 明确 BASE_URL 变量是否已经包含 `/v1`；本文统一让它包含 `/v1`，模型列表只再拼 `/models`
- 用最小模型列表请求查看各自可用模型，再分别对照官方账单和中转站控制台
可复制命令
# Base URL 已包含 /v1
export OPENAI_OFFICIAL_BASE='https://api.openai.com/v1'
curl -i "$OPENAI_OFFICIAL_BASE/models" \
-H "Authorization: Bearer $OPENAI_OFFICIAL_KEY" | head
# 1A1API 的 OpenAI-compatible Base URL 已包含 /v1
export OPENAI_RELAY_BASE='https://1a1api.top/v1'
curl -i "$OPENAI_RELAY_BASE/models" \
-H "Authorization: Bearer $OPENAI_RELAY_KEY" | head
仍然不行怎么办
- 401 反复出现就先把 Key 与 BASE_URL 配对关系画在便签上
- 模型名错误就到中转站后台复制最新型号名
小白先准备什么
- 把官方 Key、1A1API Key、其他中转 Key 分开放在不同的安全凭据条目或部署平台 Secret 中，并使用不同环境变量名。
- 记录每个 Key 对应的 Base URL、可用模型、余额和用途。
- 先用最小请求测试 `/v1/models` 或一个简单对话，不要直接接入生产工作流。
- 截图或发给别人排错前，不保留 Key 的任何真实片段，统一替换成 `<REDACTED>`。
验收标准
- 官方 Key 搭配官方 Base URL 能通，中转 Key 搭配中转 Base URL 能通。
- 环境变量命名清楚，例如 `OPENAI_API_KEY`、`OPENAI_BASE_URL`、`ANTHROPIC_API_KEY`。
- 同一个工具里能看出正在用哪个模型和哪条线路。
- 失败时能区分是 Key 错、Base URL 错、模型名错，还是余额/权限问题。
可复制排查命令
# OPENAI_BASE_URL 按 Help 填完整 Base URL，本文示例已经包含 /v1
export OPENAI_BASE_URL='https://1a1api.top/v1'
curl -s "$OPENAI_BASE_URL/models" \
-H "Authorization: Bearer $OPENAI_API_KEY" | head
# 如果这里都不通，先检查 Key、Base URL、协议、网络、分组权限和余额。
常见误区和不适合场景
- 误区一：官方 Key 配中转 Base URL，或者中转 Key 配官方 Base URL。
- 误区二：只复制 Key，忘了改 Base URL。
- 误区三：模型名照搬别人的，但你的账号没有这个模型权限。
- 不适合：多人共用一个没有限额、没有日志、没有备注的 Key。
还卡着？
仅把删除凭证、客户数据和环境变量值后的必要截图、日志片段、需求说明或当前页面链接发到 zhemuy@gmail.com。