OAuth 通道和 API Key 通道:两种上游的区别与混用陷阱
「登录 Codex」和「接入 OpenAI API Key」看起来都是「加一个上游」,但它们对应的是完全不同的凭据体系和计费体系。混用它们会导致账目对不上。
凭据性质不同
OAuth 通道走账号授权,凭据有时效、会刷新;API Key 通道走项目凭据,长期有效但有到期日和权限范围。调度和冷却逻辑对两者的容忍度也不同。
「登录 Codex」和「接入 OpenAI API Key」是两条完全不同的上游路径。
OAuth 通道走的是账号授权,API Key 通道走的是项目凭据——它们对应上游平台完全不同的计费体系。
计费是两笔账
Codex 账号里的余量和 OpenAI API 平台的账单完全独立,不能互相推断。看到「余额充足」不代表另一边的池子还有额度。
凭据刷新失败可以触发切换
生成请求之前的 OAuth 凭据刷新失败,是少数几个「换条路可能成」的场景之一,所以它被列在可切换的原因清单里。
同时还有更严格的门槛:只有明确的暂时性故障(401/403/429/502/503/504、OAuth 刷新失败、连接拨号失败)才允许切换。
像 context_length_exceeded、invalid_request_error、content_filter 这类请求级错误不触发切换,因为换渠道同样会失败。
上游凭据的存储红线
两条通道的凭据都要加密存储,管理后台不返回明文,导出一律掩码。这不是优化项,是硬性要求。
两者的价值不对等,凭据就该按这个分层来设计。
真实 token、密码、私钥、支付凭据、完整请求正文,都不应该出现在日志、测试、文档或截图里。
实操:先查模型列表,确认你的 Key 到底能访问哪些模型。
在后台配好渠道之后,先用「发现模型」同步一遍可用模型再投入使用。
curl "https://aiminis.info/v1/models" \
-H "Authorization: Bearer sk-gw-你的密钥"
# 返回里每项都带上所属平台、支持的能力和是否在售,
# 写代码前先对着这份列表确认模型 ID,别抄文档里的旧名字。
几个容易踩的坑
- 带着
previous_response_id期待网关自动换号续接——带这个参数的请求不会跨渠道重试。 - 把 Codex 账号的余量当成 OpenAI API 平台的余额来对账。
- 在流式已经开始之后客户端超时断开,却期待网关补一个正常的结束标记。
- 对
context_length_exceeded这类请求级错误也做重试,换渠道同样失败。
小结
技术上的事大多不复杂,难的是把每个异常分支都想清楚。把这份清单存下来,下次排障会快不少。
文中的配置和示例都能在 https://aiminis.info/ 直接跑一遍,接入文档在 https://aiminis.info/docs/api-integration。
- 点赞
- 收藏
- 关注作者
评论(0)