调用 OpenAI API 时提示余额不足，不一定只是账户没有充值。请求发往错误的 endpoint、SDK 读取旧密钥，或中转账户与官方账户混用，都可能让排查方向跑偏。对于通过 openmagic.ai 等 API 中转入口接入的业务，应先确认请求实际由谁计费，再检查余额、额度与鉴权配置。
余额不足、限流和鉴权失败如何区分？
不要只根据 HTTP 429 判断余额不足。429 可能涉及请求速率限制，也可能与配额或计费状态有关，应结合响应体中的 error.type、error.code 和 message 判断。若出现 insufficient_quota 等提示，优先核对对应账户的计费与配额状态；若提示速率限制，则检查请求频率、并发及 Token 吞吐。
401 通常更应先查密钥有效性与鉴权方式，403 则需结合权限和具体错误说明分析。中转网关可能转换上游错误，也可能返回自身的余额提示，因此需要保留状态码、脱敏错误体及请求 ID，不能仅凭一句中文报错确定原因。
Endpoint 与 API Key 必须来自同一计费入口
官方账户余额与中转平台余额通常不能互通。如果使用官方 endpoint，应检查该密钥所属账户及项目的计费状态；如果使用中转地址，则应检查中转账户余额、模型权限及平台返回的错误说明。给另一侧账户充值，通常不能解决当前请求的扣费问题。
- 核对 base_url 的域名、路径前缀和实际请求地址，避免重复拼接 /v1。
- 确认 API Key 由当前 endpoint 对应的服务方签发，不要交叉使用。
- 检查环境变量、容器配置和部署密钥，排除旧配置覆盖新配置。
- 如设置了组织或项目参数，确认其与密钥权限一致。
排查时只记录域名、密钥末尾少量字符与错误信息，不要把完整密钥写入日志、工单或截图。修改配置后，还需确认运行中的进程已重新加载。
SDK 已配置，为什么仍然提示额度不足？
以 Python 的 OpenAI SDK 为例，可通过 OpenAI(api_key=key, base_url=url) 显式指定密钥与地址，并执行一次最小请求。显式配置有助于排除默认环境变量干扰，但仍须检查封装层是否创建了其他客户端，或在重试时切换到了不同网关。
测试应使用当前入口明确支持的模型，并缩短输入与输出。若最小请求成功，而生产请求失败，应继续对比模型名称、项目设置、输入长度及输出上限。不同入口的模型映射和接口兼容范围可能不同，不能假设仅替换域名就能完整兼容所有功能。
充值前检查什么，恢复后怎样控制成本？
建议依次核对：实际计费入口、可用余额、项目预算、模型访问权限以及错误详情。预算是否拦截请求、充值何时反映到可用状态，应以对应服务说明和账户记录为准，不要把所有额度提示都归结为余额为零。
余额类错误不宜无限重试。应暂停相关任务并告警，待配置或计费问题处理后再验证；速率限制则可按接口说明采用有上限的退避重试。业务侧可增加余额预警、单任务输出上限和用量统计。选择 API 中转或 Token 批发方案时，应确认计费口径、失败请求处理方式、并发规则与对账能力，再评估实际成本。