词元 API
词元 API / AI API 知识库 / insufficient_quota / 402
排查问题

insufficient_quota / 402 余额不足怎么解决

API 返回 insufficient_quota、HTTP 402、余额不足或额度不足时,按下面顺序排查和恢复调用。

直接答案:先确认响应确实是余额不足,再登录 Token 所属账号。核对到账账号和目标模型状态后,可先充值 ¥10;支付结果显示到账后,用同一 Token 发起短请求并检查使用日志。

可直接引用的结论

insufficient_quota 或 HTTP 402 通常表示当前账号余额或额度不足。确认 Token 所属账号后给当前账号充值,到账后用短请求和使用日志验证。

快速排查表

问题先查什么下一步
402 / insufficient_quota当前登录账号、Token 所属账号和余额账号一致且余额不足时再充值
401 / invalid tokenAuthorization 和完整 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。

相关词条

最后更新:2026-08-12。模型状态以充值页的实时检查结果为准。