遇到 OpenAI API 余额不足，不要先删除旧 Key、批量创建新 Key。报错可能涉及账户计费、项目预算、组织归属，也可能来自 API 中转站自己的余额系统。换 Key 通常不能解决同一计费主体的余额问题，反而可能扩大故障范围。建议先定位账单归属，再处理凭证轮换。
先分清余额不足、额度限制与限流
保留失败请求的时间、HTTP 状态码、错误类型、脱敏响应和请求 ID。仅看到 429 不能直接判断余额不足：它也可能表示请求速率或 Token 吞吐受限，应结合响应中的错误字段判断。不要把完整 Key 放进工单、日志或聊天记录。
- 直连 OpenAI：确认请求使用的组织、项目和对应计费账户，检查可用余额、支付状态及适用限制。
- 通过中转接入：核对服务地址与该平台的余额、模型权限、消费限额；中转余额不等于官方账户余额。
- 只有某个应用失败：检查环境变量、密钥版本和项目归属，排除部署仍在读取旧配置。
- 高峰期集中失败：同时排查并发和速率限制，不要只靠充值或增加 Key 处理。
API Key 轮换前的低风险清单
先盘点依赖，再新增凭证，最后撤销旧凭证。记录每把 Key 的负责人、用途、运行环境和调用入口，不记录明文。生产、测试与个人调试应分开管理，权限按实际需要配置，避免一把 Key 被多个不相关服务共用。
- 列出后端服务、定时任务、CI/CD、函数计算及密钥管理系统中的引用位置。
- 确认目标账户或项目具备可用计费条件；若余额问题未解决，先处理账单而不是轮换。
- 在正确项目下创建替代 Key，写入密钥管理系统，避免提交到代码仓库或前端页面。
- 用少量、低 Token 请求验证鉴权、目标模型权限与响应，测试请求也可能产生费用。
- 先切换少量实例，观察错误率、延迟和消耗，再逐步扩大；确认没有旧 Key 流量后撤销。
回滚应指向仍有效且未泄露的配置。如果旧 Key 已泄露，不应为保持服务而继续保留，应优先撤销并排查异常消费。凭证泄露属于安全事件，余额不足属于计费排查，两者可能同时发生，但不能用同一套处置顺序机械处理。
中转接入时，怎样控制余额与切换风险
采购 API 中转或 Token 批发服务前，应核对计费单位、模型映射、余额查询方式、错误码说明及并发规则。预算提醒和硬性消费上限也要分别确认，不能默认提醒就会自动停止请求。业务侧可按日统计费用，设置分级告警，并限制单请求输出长度和无效重试。
切换网关时，除 API Key 外，还要核对 base_url、SDK 兼容性及返回结构，不能假定所有服务都完全一致。对明确的余额或配额不足错误，应暂停无意义重试并通知维护人员；只有确认属于可重试的临时故障，才使用有限次数的退避重试。
恢复后的验收标准
恢复不能只看一次请求成功。应检查主要调用链路、账单归属、实际用量和旧 Key 残留，记录故障原因及变更时间。将余额监控与密钥轮换分开维护，才能减少重复充值、误删凭证和盲目切换带来的成本。