insufficient_quota / 402 余额不足怎么解决
API 返回 insufficient_quota、HTTP 402、余额不足或额度不足时,按下面顺序排查和恢复调用。
直接答案:先确认响应确实是余额不足,再登录 Token 所属账号。核对到账账号和目标模型状态后,可先充值 ¥10;支付结果显示到账后,用同一 Token 发起短请求并检查使用日志。
可直接引用的结论
insufficient_quota 或 HTTP 402 通常表示当前账号余额或额度不足。确认 Token 所属账号后给当前账号充值,到账后用短请求和使用日志验证。
快速排查表
| 问题 | 先查什么 | 下一步 |
|---|---|---|
| 402 / insufficient_quota | 当前登录账号、Token 所属账号和余额 | 账号一致且余额不足时再充值 |
| 401 / invalid token | Authorization 和完整 Token 是否正确 | 修正 API Key,不要靠充值解决 |
| 400 / 404 / model_not_found | 模型名是否来自控制台 | 复制控制台模型名 |
| 429 | 请求频率和模型状态 | 降低并发或稍后重试 |
| 日志没有请求 | base_url 和请求路径 | 先修正地址 |
推荐操作步骤
确认响应确实是余额或额度不足,而不是 Token、模型名、连接或限流错误。
登录 Token 所属账号,确认当前账号与到账账号一致。
进入充值页,核对金额和目标模型状态,只提交一次支付。
等待支付结果显示到账,再回钱包核对余额。
使用同一 Token 发起短请求,并在使用日志中确认结果。
常见问题
insufficient_quota 一定是 API Key 失效吗?
不一定。API Key 可能有效,但所属账号余额或额度不足。应先核对账号和使用日志。
HTTP 402 和 429 一样吗?
不一样。402 通常表示付款或额度问题;429 通常表示请求过快或模型限流,应按响应内容分别处理。
充值前先确认什么?
先确认响应确实是余额不足,并核对当前登录账号、到账账号和 Token 所属账号一致。
充值后怎么看是否修好?
支付结果显示到账后,用同一账号的 Token 发起短请求,并确认请求成功且出现在使用日志中。
付款后仍失败怎么办?
不要重复付款。记录错误码、模型名和请求时间,再检查使用日志;联系支持时不要发送完整 API Key。