遇到 OpenAI API 余额不足，先别批量删除密钥。请求失败可能与账户额度、账单状态、项目限制或中转账户余额有关，也可能只是速率限制。轮换 API Key 不会增加余额，也不能绕过计费限制。正确顺序是定位账单归属，再决定充值、调整预算或更换密钥。
先确认：是余额不足，还是限流与鉴权失败？
排查时记录 HTTP 状态码、错误体中的 type、code、message，以及请求时间和请求 ID。不要只看“429”：它可能关联速率限制，也可能出现额度相关错误，应以实际响应和控制台信息交叉判断。401 则通常应优先检查密钥、鉴权头和请求地址，而不是直接充值。
- 直连 OpenAI：核对当前密钥对应的组织、项目及账单信息，检查可用额度、支付状态与相关限制。
- 通过 API 中转接入：检查中转账户余额、模型权限、渠道状态与上游错误说明，不要把两套账本混为一谈。
- 近期切换过环境：确认生产环境加载的是预期密钥与 base_url，排除旧配置、错误项目或测试账户。
- 只有部分请求失败：比较模型、并发、输入长度和输出上限，判断是否为特定模型限制或流量突增。
低风险 API Key 轮换：先验证，再撤销
如果问题只是余额不足，优先处理账单；若密钥泄露、人员变更或需要隔离环境，再进行轮换。正常轮换应避免先撤销旧密钥、再验证新密钥。若已确认泄露，则应优先撤销风险凭据并启动事件处置，不能为了平滑切换继续暴露。
- 建立清单：记录密钥用途、所属项目、负责人、部署位置与最近使用情况。清单只保存标识或脱敏尾号，不保存完整密钥。
- 创建替代密钥：按项目支持的权限能力配置，区分开发、测试和生产，避免多个业务共用一个高权限凭据。
- 小流量验证：使用目标 base_url 和实际所需模型发起低成本请求，检查鉴权、响应格式及用量记录。
- 逐步更新：通过密钥管理服务或部署配置替换，观察错误率、延迟与账单变化；不要把新密钥写进代码仓库。
- 撤销旧密钥：确认所有实例及定时任务均已更新后再撤销，并复查是否仍有旧配置触发失败。
接入中转服务前，核对余额与计费边界
评估 OpenAI API 中转充值或 Token 批发方案时，不能只比较标价。应确认计费单位、模型标识、用量查询方式、失败请求处理规则，以及是否支持项目隔离、余额告警和密钥撤销。缓存与不同类型 Token 的计费口径如有区别，也应以服务方文档和账单为准。
中转余额与上游官方余额不是同一概念。更换中转密钥通常只改变访问凭据，不会自动补足账户资金。接入 openmagic.ai 前，可先核对当前支持的模型、接口兼容范围及计费说明，再用小额、低并发测试验证业务链路，避免一次性迁移全部生产流量。
恢复调用后，防止再次停服
为余额与用量设置告警，按业务拆分密钥，并限制异常并发、超长输入和不必要的输出长度。对额度类错误暂停无效重试，防止任务持续堆积；对可重试的临时错误再采用有限次数退避。最终验收不仅看“能返回结果”，还应确认用量可追踪、费用可解释、旧密钥已失效。