遇到 OpenAI API 余额不足，先别急着更换 API Key。调用失败可能与账户额度、项目预算、计费状态或中转账户余额有关，也可能只是触发速率限制。换 Key 不等于补充余额：如果新旧密钥仍归属同一计费账户，轮换通常不能解决额度问题，还可能引入配置错误和服务中断。
先定位：余额不足还是限流？
保留失败请求的 HTTP 状态码、错误类型、错误消息和请求 ID，但不要记录完整密钥。即使返回 429，也应结合响应正文判断：额度类错误与请求频率超限不能用同一种方式处理，单看状态码容易误判。
- 额度或计费提示：核对实际请求所属账户、组织或项目，检查余额、账单状态及适用限制。
- 速率限制提示：检查请求量、Token 使用量与并发，采用有上限的退避重试，避免持续放大流量。
- 认证失败提示：检查密钥是否被撤销、环境变量是否更新，以及请求地址是否配置正确。
- 通过中转调用：核对中转余额、模型权限与渠道错误信息，不要把平台额度当成官方账户额度。
以实际控制台和当前服务文档为准。预算设置可能用于告警，也可能关联限制，不应未经验证就视为统一的硬性停机阈值。对明确的额度不足错误，反复重试通常无助于恢复。
API Key 管理：先建立最小可用台账
建议按生产、测试和开发环境分离密钥，并在支持的范围内设置最小权限。台账只记录密钥标识、用途、负责人、所属项目、部署位置与轮换时间，不要保存明文 Key。密钥应放在服务端密钥管理系统或受控环境变量中，避免进入前端代码、代码仓库和工单截图。
余额排查前，先确认运行实例实际读取了哪份配置。容器、定时任务和旧实例可能仍持有旧密钥；只改本地配置，不代表线上已经生效。可用不含敏感信息的配置版本号核对实例，避免输出完整凭据。
低风险轮换清单：验证后再撤销
- 盘点影响范围：列出使用旧 Key 的应用、批处理任务和自动化流程，准备回滚配置。
- 创建替代密钥：确认所属项目与权限符合预期；不要为了绕过余额限制而盲目增加密钥。
- 小流量验证：使用低 Token 请求检查认证、模型权限和响应格式，同时观察错误日志。
- 分批更新：先切换少量实例，再逐步扩大范围，关注成功率、延迟、并发与消耗变化。
- 清理旧凭据：确认任务迁移完成后撤销旧 Key，检查遗留调用并更新台账。
如果密钥疑似泄露，应优先撤销并排查异常消费，不宜为了平滑切换而延长暴露窗口。正常维护则应避免一次性替换全部实例。
使用 API 中转时，如何核对余额与成本？
通过 openmagic.ai 等 API 中转方式接入时，应分别核对请求地址、平台密钥、模型名称及计费记录。中转余额与 OpenAI 官方余额是不同账本，在一侧充值或换 Key，不代表另一侧同步恢复；具体规则需查阅对应服务说明。
采购额度或评估 Token 批发方案前，应确认计费单位、输入输出 Token 的计算方式、失败请求处理规则和并发约束，再用小规模真实业务测试核算成本。长期治理可配合余额告警、单请求输出上限和异常用量监控。处理顺序应是：定位账本与错误原因，解决额度或限制问题，再按需轮换密钥，而不是把轮换当成通用修复按钮。