insufficient_quota只说明一件事:当前这个计费账户没有可花的钱了,要么根本没绑卡、要么预付余额见底、要么月度上限被你自己设死了,按计费页逐项查,不要改代码。
先把报错翻译成人话
现象:接口返回429并带着insufficient_quota,程序直接停摆。
原因:429里混着两种完全不同的问题,限速是暂时忙,这个是配额不足,系统在说你的计费计划当前不让再花钱了。
怎么办:先确认错误码里的类型字样是quota再往下查,改重试逻辑对这个错没有任何作用,钱的问题只能在计费侧解决。
新账号没绑卡
现象:刚注册、刚建密钥,第一次调用就报这个错。
原因:现在新账号没有自动可用的免费额度,不绑付款方式、不预充值,接口就是零额度状态,第一条请求都会被拒。
怎么办:到接口平台的计费页绑好本人付款方式并充入第一笔预付金额,再回去调,顺序反了试多少次代码都是这个结果。
试用额度早就过期了
现象:很久以前调通过,现在突然全报配额不足。
原因:早期送的试用额度有有效期,过期自动清零,账号表面正常,钱包实际上是空的。
怎么办:去计费概览看信用余额那一栏是否为零,是零就按正式付费处理,绑卡充值,不要再按有免费额度的预期排期。
预付余额被烧完
现象:跑得好好的服务在某个时间点集体报错。
原因:预付费是先充后扣,调用量涨上来后余额见底的速度比预想快,尤其长文本和高价模型烧得最猛。
怎么办:看用量页按模型拆账,找出烧钱大户,补足余额后开自动充值并把触发线设高,同时给项目设月度硬上限,下次只报警不停机。
月度上限是自己设死的
现象:钱包明明还有余额,还是报配额不足。
原因:组织或项目的月度预算上限先于余额到顶了,系统执行的是你自己定的封顶,不是没钱。
怎么办:到限额设置里把当月上限调高或等下个周期,调完等几分钟再测,顺手把用量提醒打开,别让自己定的规则把自己锁死第二次。
付款方式失效或欠款
现象:绑过卡、充过钱,最近一次自动扣款出问题后开始报错。
原因:卡过期、限额被降或扣款被银行挡下,账户进入欠费状态时,新调用会被一并停掉。
怎么办:更新默认付款方式,先把欠的账结清,再小额充值一笔验证通道恢复,确认计费状态变回正常后,接口才会重新放行。
看错了组织或项目
现象:明明刚充完钱,计费页显示有余额,调用还是报错。
原因:密钥所属的组织或项目,和你充值查看的不是同一个,钱进了A的钱包,请求花的却是B的账。
怎么办:把密钥所属组织、项目和计费页右上角选中的组织逐一对齐,三处是同一个再测,这是老手最容易栽的跟头。
常见问答
充完钱多久恢复?
一般几分钟内就生效,超过半小时还报同一个错,就回头查组织对没对齐、账结没结清。
订了聊天会员能抵这个错吗?
不能,会员和接口是两本账,会员再贵也变不成接口额度。
报错会不会自己消失?
限速会,配额不会,余额、上限和欠款任何一项不处理,它会一直报下去。