很多开发者接完 API 才第一次遇到「额度不足」的报错,翻遍后台也说不清到底卡在哪一层:是账户余额、组织级限额、还是项目级或每分钟请求限制。这篇把额度限制拆成几层分别讲清,给出查数和排查的动作顺序,并说明额度真耗尽时先做什么、后做什么。文中不写死任何数字,具体阈值和价格都指到站内页面按当期口径核对。
很多开发者是接完 API 才第一次撞上「额度不足」的报错,然后翻后台翻半天也说不清到底卡在哪一层:是账户余额见底、还是自己给组织设的用量上限、还是服务端按分钟算的速率限制。这三样处理起来完全不是一个动作,弄混了就会白充值或者白改代码。
这篇把额度限制拆成几层分别讲,给出查当期数字的站内路径和从外到内的排查顺序,再说额度真耗尽时先做什么、后做什么。文中不写死任何阈值和价格,具体数字一律到站内对应页面按当期口径核对。
额度限制其实分好几层,别混成一句「没额度了」
先建立分层的意识,后面排查才有方向。看到限额报错时不要急着充值,先判断它属于哪一层,每层的解法差别很大,很多时候问题根本不在钱上。
- 账户余额或预付信用
- 账户里还剩多少钱可扣。这层见底表现为余额不足类报错,属于充值和计费方式问题。
- 组织/项目用量上限
- 你自己或团队在后台设的硬闸门,常见于多项目共用一个组织时,被谁设的限额挡住自己都不知道。
- 服务端速率限制
- 按分钟或按天统计的请求数与 token 数。超了返回限流错误,而不是把余额扣光。
- 单次请求能力上限
- 单次请求能塞进去的上下文长度和能吐出来的输出长度,这是模型能力边界,和账户额度无关。
- 先看报错原文里的关键词,区分是余额类、限流类还是参数类,这是最快的分流
- 余额类问题去查账户余额与预付信用,见底就充值或调整计费方式
- 限流类问题看请求频率分布,高频小请求和低频大请求撞的是不同闸门
- 参数类问题看输入输出长度是否超了模型上限,这种报错常被误读成额度不足
别背数字,去这几页看当期口径
额度相关的阈值、单价、上下文档位都会随档位和厂商调整,背下来的数字必然过期。正确做法是每次要算账时都去站内页面看当期口径,把「查」变成习惯而不是靠记忆。
| 要查的东西 | 站内路径 |
|---|---|
| 官方价目表与按量计费口径 | /official-api |
| 某个厂商的规格与计费方式 | /official-api/providers/openai |
| 用自己用量做成本预估 | /tools/model-cost-calculator |
| 单次调用的 token 与价格换算 | /tools/token-price-calculator |
另外提醒一句:拿别人的账单截图当自己的参考是常见坑。别人的调用结构、模型配比、缓存命中率都和你不一样,预估成本一定要代入自己的真实用量去算。
查额度的动作顺序:从外到内四步走
遇到额度相关报错时,按下面的顺序走一遍,通常前三步就能定位问题,不必一上来就充值。
- 第一步:读报错原文把返回的错误信息完整读一遍,找关键词区分余额不足、超出速率限制、参数超长三类。三类处理方式完全不同,别跳过这步。
- 第二步:查账户余额到账户后台确认余额与预付信用是否见底。见底就是充值或换计费方式的问题,和限速没有关系。
- 第三步:查组织与项目上限看组织级和项目级有没有被设过硬上限。多项目共用组织时,这条最容易被忽略,改完限额可能就恢复了。
- 第四步:查速率限制看请求的并发与频率分布,按分钟和按天的限制是两道不同的闸。需要时做请求排队或加退避重试,而不是硬冲。
这套顺序的价值在于:它让你在动手花钱之前先排除掉不需要花钱的原因。限额是自己设的、参数是写错的,这两种情况充值也解决不了。
额度真耗尽之后,先做哪件事
确认确实是额度用尽后,也别第一时间就充值。先判断影响面,再决定短期动作和中期动作,顺序错了容易反复踩同一个坑。
- 先判断影响面:是整条业务停摆,还是只有某个批处理任务失败。影响面决定你是马上加钱还是先降级
- 短期动作:关键路径留着,非关键任务切到更便宜的模型;批量任务挪到非高峰时段跑
- 短期动作:给重试加退避,避免失败后密集重试二次消耗额度
- 中期动作:补上用量监控与告警。没有告警,下一次还会在同样的地方断掉
- 中期动作:核对触发的是余额还是人为限额。是人为限额就先改限额,顺序反了会白花钱
如果限制来自上游中转渠道而不是原厂账户,排查路径要换:先去渠道侧确认它的额度口径和计费节奏,再回头看你自己的用量。判断渠道可信度可以参考站内的检测工具和导航页,别只看宣传页。
这套思路什么时候不适用
- 调用量极小、基本是个人试用的场景,不值得为额度搭整套监控,盯余额就够
- 限制来自中转渠道而非原厂账户时,排查路径不同,得先确认渠道侧口径
- 业务对限流极度敏感时,靠排队和重试解决不了,要从架构上做多通道分流,这已超出额度管理范围
- 只是想临时跑个脚本验证想法时,别花时间做用量建模,跑通比算准重要
换句话说,额度管理的投入应该和你的调用规模、业务连续性要求成正比。规模小的时候,简单盯余额反而是更务实的选择,别为了「规范」给自己加没有收益的活。
下一步去站内官方 API 页面对一遍当期价目与规格口径,再用成本计算器代入你自己的用量估一遍,这次的数才是你能用的数。→常见问题
额度用完了会不会自动扣费继续跑?
取决于你在账户里是不是开了自动充值或后付费。没开的话通常是直接拒绝请求,开了就会从绑定的付款方式扣。建议先去后台确认这一项,再决定要不要长期开启,别等账单出来才发现。
为什么我余额还有,却提示额度不足?
最常见的是撞上了速率限制,而不是钱不够,两者报错文案容易看混。其次是组织或项目级设了用量上限。按报错关键词分流,再看限额设置,基本能定位。
每小时限额和每天限额,该盯哪个?
要看你流量的形态。突发型流量先被分钟或小时限速拦住,持续型流量更容易撞日累计上限。建议两个都设告警,先观察一周自己的曲线,再决定重点盯哪个。