OAuth 通道和 API Key 通道:两种上游的区别与混用陷阱

举报
Rolle 发表于 2026/11/15 17:44:23 2026/11/15
【摘要】 「登录 Codex」和「接入 OpenAI 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。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。