遇到 OpenAI API 余额不足，先别急着删除旧 Key 或购买新 Key。失败可能来自账户额度、项目预算、计费状态，也可能是中转账户余额耗尽。轮换 API Key 通常不能解决同一计费范围内的余额不足。先确认请求由谁计费，再处理凭证，才能避免停服与重复充值。
先判断：余额不足，还是限流与认证失败？
保留失败请求的时间、模型、HTTP 状态码、错误类型和请求 ID，但不要记录完整 Key。429 不一定代表余额不足，也可能是速率限制；401 则应优先检查凭证、权限和请求地址。以响应正文与对应计费后台为准，不要只凭客户端提示充值。
- 直连官方 API：核对组织、项目、计费状态及可用额度，确认应用使用的 Key 属于预期项目。
- 通过中转接入：检查中转账户余额、套餐限制、模型权限及上游错误说明；中转余额不等于官方账户余额。
- 检查预算设置：区分通知阈值与实际限制，不能默认每个预算数字都会阻止调用。
- 检查近期变更：新模型、并发增加、长上下文和异常重试，都可能让消耗明显上升。
低风险操作：先恢复计费，再决定是否换 Key
确认额度耗尽后，应通过对应服务的正规计费入口处理，并核实充值或额度调整是否已经生效。不要假设付款后立即恢复，也不要连续提交充值。新建 Key 不会自动带来新余额；同一计费范围内换凭证，通常仍受原有额度约束。
若只是余额问题，可暂停非必要批处理，限制单次输出并降低后台任务并发。不要对额度错误无限重试：这无法恢复余额，还会挤占队列、放大告警。恢复后先做小流量验证，再逐步放开任务。
确需轮换时，按清单切换与回滚
Key 泄露、权限过宽、人员交接或凭证治理，才是更明确的轮换理由。普通轮换应先验证新 Key，再撤销旧 Key；若已确认泄露，应优先撤销或限制受影响凭证，并排查异常用量。
- 盘点使用位置：列出生产服务、定时任务、CI/CD、测试环境和密钥管理系统，避免遗漏后台脚本。
- 创建最小权限凭证：核对所属项目、可用模型与接口权限，不要把服务端 Key 放入浏览器或移动端代码。
- 小流量验证：使用目标 Base URL、实际 SDK 与指定模型，检查认证、响应、用量记录和计费归属。
- 分批更新配置：通过环境变量或密钥管理系统部署，观察错误率、延迟和消费变化，不要一次修改全部实例。
- 完成撤销：确认旧凭证无业务依赖后撤销；若需回滚，仅使用未泄露且仍有效的凭证。
使用 API 中转，如何核对成本与责任边界？
选择 Token 中转或 API 批发服务时，应明确余额归属、模型计费口径、失败请求处理方式、并发限制和账单查询能力。比较成本要基于同一模型、输入输出量与任务成功率，不能只看单一 Token 报价。
对于 openmagic.ai 接入场景，建议上线前核对当前控制台和文档中的接口地址、认证方式及计费说明。把余额告警与密钥轮换分开管理：前者关注消费趋势，后者关注权限与暴露风险。这样才能在故障时快速判断该补额度、调并发，还是撤销凭证。