遇到“OpenAI API 余额不足”，先别急着充值。调用失败可能来自官方账户计费、项目预算、API 中转账户余额，也可能是 endpoint 与密钥不匹配。先确认请求发给谁、费用由谁扣除，再检查余额，能避免充错账户或反复更换密钥。
余额不足与限流，如何区分？
不要只看 HTTP 状态码。429 既可能涉及请求速率限制，也可能与配额或计费状态有关，应同时读取响应中的 error.type、error.code 和 message。出现 insufficient_quota 等提示时，优先检查计费与额度；出现 rate_limit_exceeded 时，重点检查请求频率、Token 吞吐及并发。第三方平台可能使用不同错误格式，需要结合其文档和控制台判断。
- 401：优先检查密钥是否有效、是否属于当前服务，以及鉴权头是否正确。
- 403：检查权限、项目访问范围及服务端返回的具体原因。
- 429：区分额度耗尽与限流，不要统一按“余额不足”处理。
- 连接失败或 404：核对域名、路径、接口类型及模型名称。
endpoint 与 SDK 应该怎样核对？
官方直连与 API 中转是两条不同计费链路。直连时检查对应 OpenAI 账户及项目；使用中转时，检查该服务的账户余额、密钥权限和模型授权。官方密钥与中转密钥不能默认互换，给一方充值也不会自动增加另一方额度。
使用 OpenAI SDK 时，核对初始化参数中的 api_key 与 base_url，确认它们属于同一服务。官方 API 常用基础地址为 https://api.openai.com/v1；中转地址应以服务商提供的接入说明为准，不要自行拼接路径。SDK 通常会追加资源路径，若基础地址已包含完整接口路径，可能造成重复拼接。
还要检查环境变量、容器配置和部署平台的密钥设置，避免本地已更新，线上仍读取旧值。排查日志可记录目标主机、模型、状态码和请求标识，但不要打印完整 API Key。配置组织或项目参数时，也应确认其与密钥归属一致。
控制台有余额，为什么仍调用失败？
控制台显示的余额不一定等于当前密钥可用额度。应进一步核对余额是否属于当前账户、项目是否受预算或权限限制、所选模型是否获授权，以及充值状态是否已生效。预算是告警还是硬性限制，应以对应服务的设置说明为准。ChatGPT 订阅与 API 计费也不能混为一谈。
若使用 API 中转，还需分别查看账户余额、密钥额度、模型倍率和并发限制。余额充足不代表所有模型都能调用。可用相同密钥发送一次短输入、低输出上限的测试请求，保留脱敏错误响应，再交由服务商定位；不要用高并发反复试错。
充值前如何控制成本与恢复调用？
确认确为余额问题后，再通过对应服务的正规账单入口处理。选择 Token 批发或 API 中转方案时，核对计费单位、模型映射、失败请求计费规则、余额查询方式和售后渠道，不应只比较宣传单价。
接入 openmagic.ai 时，同样应先核对接入文档与账户计费信息。业务侧建议设置用量告警、输出上限和重试次数：余额或鉴权错误应停止盲目重试，临时限流可采用带抖动的指数退避。恢复后先做小流量验证，再逐步放开并发。