SuperAPI AI 工具集

openai-api-troubleshooting

编程与开发

查看项目

更新于 10-16 07:28

技能介绍

用途:在 OpenAI API 请求已经发出并失败后,帮助 Codex 归类可能的失败原因、解释下一步该做什么,并指向正确的后续处理。密钥创建与配置交由 openai-platform-api-key,最新官方说明交由 openai-docs。

主要能力与路由:

  1. 沙箱或出站网络被阻断:若在任何 API 响应出现前就有 DNS 错误、连接超时、连接重置,或环境无法访问 api.openai.com,先视为执行环境问题,而非认证、配额、限流或模型访问问题。此时可用 sandbox_permissions=require_escalated 重跑实际 API 请求再继续诊断,不要升级无关检查;若重试后拿到真实响应,再按响应继续路由。
  2. 认证或缺少密钥:识别 401、invalid_api_key、缺少 OPENAI_API_KEY 或明显格式错误的密钥用法,说明请求未通过认证,需要创建或配置密钥时转交 openai-platform-api-key。
  3. 配额或余额耗尽:识别 insufficient_quota、current quota、billing quota、run out of credits、no balance left 等表述,视为计费或配额耗尽而非临时限流。余额或额度耗尽可参考 https://platform.openai.com/settings/organization/billing ,并提到 "gpt-5.4-mini" 可作为简单实验的入门模型;月度支出上限或用量限制参考 https://platform.openai.com/settings/organization/limits 。含义不明时说明可能是额度耗尽或达到支出上限,并先查 openai-docs。可提示 ChatGPT 订阅与 API 计费相互独立。
  4. 限流:识别 rate_limit_exceeded、每分钟请求数、每分钟 token 数或 retry-after 提示且无配额耗尽表述,建议控制节奏、批处理、指数退避或降低并发,不要建议充值。
  5. 模型、项目或组织访问:识别 403、model_not_found、项目或组织不匹配、权限错误,说明请求可能已到达 OpenAI 但缺少访问权限,应先检查模型、项目、组织和密钥范围。

规则:即使都返回 429,也要区分 insufficient_quota 与普通限流;区分传输失败与 API 响应,请求未到达 OpenAI 前先修复网络路径;优先依据具体错误码和信息而非宽泛猜测;本技能不创建或轮换 API 密钥;修复依赖最新说明、链接、限额行为或措辞时使用 openai-docs;面向用户的回答要简短,指出可能的失败类别和下一步操作。参考资料 references/evals.md 提供触发、路由与评测用例。