OpenAI 官方 Key 和中转站 Key 怎么区分

不同平台的 Key 外观可能相似,但 BASE_URL、协议、模型和计费规则必须配套;混用可能出现 401、403、404、model_not_found 或协议错误。

内容更新 2026-07-26

先看结论

官方 Key 配 api.openai.com,中转 Key 配中转站给的 BASE_URL,模型名以平台列表为准。

先理解这些

  • Key 和 BASE_URL 不匹配(官方 Key 走中转、或反过来)
  • 模型名只在某一边可用
  • 中转站计费可能包含模型基准价、输入 / 输出 / 缓存费率、倍率或分组规则,应以当前控制台为准

小白先准备什么

  1. 把官方 Key、1A1API Key、其他中转 Key 分开放在不同的安全凭据条目或部署平台 Secret 中,并使用不同环境变量名。
  2. 记录每个 Key 对应的 Base URL、可用模型、余额和用途。
  3. 先用最小请求测试 /v1/models 或一个简单对话,不要直接接入生产工作流。
  4. 截图或发给别人排错前,不保留 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。

适合谁看

  • 同时有 OpenAI 和 1A1API 的 Key
  • 切来切去搞混了
  • 想知道哪些工具能直接用中转 Key

试着做一次

  1. 在安全凭据存储或部署平台 Secret 中维护两套 Key,并用清楚的环境变量名区分用途
  2. BASE_URL 一定要和 Key 配套,绝不混填
  3. 明确 BASE_URL 变量是否已经包含 /v1;本文统一让它包含 /v1,模型列表只再拼 /models
  4. 用最小模型列表请求查看各自可用模型,再分别对照官方账单和中转站控制台

命令与示例

# 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

需要解决的问题

  • Key 没问题但报 401
  • 模型名能选,但调用就报 model not found
  • 扣费速度和预期对不上

遇到困难时

  • 401 反复出现就先把 Key 与 BASE_URL 配对关系画在便签上
  • 模型名错误就到中转站后台复制最新型号名