调用模型时提示“OpenAI API 余额不足”，不一定只是账户没钱，也可能是请求发到了错误的服务地址、使用了其他项目的密钥，或中转账户存在独立额度限制。先确认请求由谁接收、费用由谁结算，再处理充值，才能避免充错账户和重复排障。
余额不足与限流，如何区分？
不要仅凭 HTTP 状态码判断。429 可能涉及请求频率限制，也可能与额度有关，应结合响应中的 error.type、error.code 和 message 分析。出现 insufficient_quota 等信息时，优先检查计费与额度；出现 rate_limit_exceeded 时，则重点检查请求速率、Token 吞吐和并发。具体含义仍应以当前服务返回的信息为准。
ChatGPT 订阅与 API 计费通常是不同的付费体系，不能因为已购买聊天产品订阅，就认定 API 已有可用余额。使用 API 中转服务时，中转账户余额与上游账户计费也需要分别理解，两者不会因持有同一邮箱而自动互通。
Endpoint、API Key 和 SDK 应怎样核对？
标准 SDK 只是请求工具，不负责确认密钥属于哪个服务商。排查时应把服务地址、密钥来源和模型名称作为一组配置检查，避免“官方地址配中转密钥”或“中转地址配官方密钥”。
- 检查 base_url：官方接入与中转接入应分别使用各自文档指定的地址，确认版本路径是否正确，避免重复拼接 /v1。
- 检查 API Key：确认密钥有效、来源正确，项目或组织选择符合预期；不要在日志、截图或工单中暴露完整密钥。
- 检查环境变量：核对 OPENAI_API_KEY、OPENAI_BASE_URL 及应用自身配置，防止旧变量覆盖新设置。
- 检查模型名称：中转平台可能使用模型映射，需按其文档填写，不能假设所有模型名称均可直接复用。
- 检查 SDK 初始化：以当前 SDK 版本支持的参数为准，修改配置后重启进程，确认运行中的实例已加载新值。
官方 API Key 与中转平台密钥不能默认互换。如果通过 openmagic.ai 接入，应先核对对应接入文档与账户信息，再判断是本地配置问题，还是需要平台协助查询的计费问题。
充值后仍然报错，按什么顺序处理？
首先进入实际扣费方的控制台，核对付款状态、可用余额与计费记录。随后检查项目预算、账户消费上限、密钥授权范围，以及中转服务是否设置了独立的密钥额度或模型权限。预算提醒是否会阻断请求，应以对应控制台说明为准。
接着关闭自动重试，用一个已获授权的模型发送短文本请求，并降低输出上限。记录请求时间、模型、脱敏后的地址、错误体和 request ID（如有）。如果最小请求成功，再逐步恢复业务参数，以区分额度问题与并发、上下文长度或调用链配置问题。充值后的状态更新时间以实际服务说明为准，不应假设立即恢复。
如何降低再次耗尽额度的风险？
余额告警与用量限制应分开设置：前者提醒补充资金，后者约束异常消耗。建议按应用隔离密钥，跟踪输入、输出 Token 用量，限制单次输出，并为批处理设置并发上限。只有确认属于可重试的临时错误时，才使用带退避的重试策略；额度不足时反复重试通常不能解决问题。
选择 API 中转或 Token 批发方案时，应重点核对计费单位、模型映射、用量明细、退款规则与错误追踪能力，而不是只比较宣传单价。先完成小额充值和最小请求验证，再扩大调用规模，更便于控制接入成本与排障范围。