很多人买了 Google AI Pro，想拿它当 API 用，结果一调就报配额不足或者被限流，回头又找不到额度数字写在哪一页。这篇不背具体数字，只讲清三件事：你的额度到底挂在哪条通道上、限流按什么口径卡你、卡住之后按什么顺序排查。看完你能自己定位是订阅额度、免费层还是计费项目的问题，也知道该去站内哪一页核对当时的数字。
买了 Google AI Pro，兴冲冲生成一个 key 丢进代码里，结果一调就报配额不足或者被限流——这是很常见的落差。原因多半不在你代码写错了，而在于你搞混了两套东西：订阅给你的权益，和 API 调用消耗的配额，它们在后台是两条互不相通的通道。
这篇不背具体数字，数字会变。只讲清三件事：你的额度挂在哪条通道上、限流按什么口径卡你、卡住之后按什么顺序排查。看完你能自己判断是订阅权益、免费层还是计费项目的问题，也知道该去站内哪一页核对当时的数字。
先分清：你说的「Google AI Pro」到底是哪条通道
Google AI Pro 是面向个人用户的订阅档位，登录网页端和自家客户端就能用。而 API 调用走的是另一套账号体系——开发者后台里的项目、key、配额。这两者额度不互通，订阅不等于自动送你 API 配额，反过来也一样。
- 订阅权益
- 按人算，登录客户端聊天、用高级功能，和 API 请求量没关系
- API 配额
- 按项目算，挂在开发者后台的某个项目下，和 key 绑定使用
- 免费层 / 计费层
- 同一个项目里两种状态，key 本身不决定额度，项目状态决定
判断方法很直接：看你手里的 key 是在哪个后台生成的。进那个后台，找到对应项目，看当前项目是免费层还是已经开了计费——这一步基本就能确认你的额度来自哪里。别把订阅页面的说明和接口侧的后台当成一笔账。
- 去 /plans/gemini-ai-pro 看这一档订阅包含什么，明确它管的是客户端还是接口
- 去 /official-api/providers/google 看接口侧的规格与来源说明，以那边为准
- 确认 key 所属项目当前处于哪一层，这是后面所有排查的起点
- 如果你只是自己电脑上用客户端聊天，那根本用不到 API 配额，这篇对你没用
额度上限和限流不是一回事，卡你的是哪一个
配额是单位时间内的总量上限，通常按分钟或按天计；限流是瞬时的并发或每秒请求数，超了直接返回错误，等一会儿往往就恢复了。两种问题的处理方式完全不同，先分清楚再动手。
| 现象 | 大概率是什么 | 该怎么处理 |
|---|---|---|
| 报错后等几十秒重试就好了 | 瞬时请求数超了，属于限流 | 加退避重试，控制并发 |
| 怎么重试当天都不通 | 日额度用光，属于配额 | 换通道或等重置，重试无意义 |
| 一直提示权限或未开通 | 鉴权 / 项目没开对应接口 | 先解决权限，和额度无关 |
| 时快时慢、失败率忽高忽低 | 可能是服务方排队 | 先测基线再判断 |
先量基线再谈限流：用 /tools/speed-test 测出你自己的延迟和失败率，区分「是我发太快」还是「服务方本来就在排队」。如果并发一压就崩，那是你客户端的问题，不是额度问题。
- 把错误码原文记下来，别只看「失败了」三个字
- 区分分钟级超限和日级超限，前者能重试，后者别浪费重试次数
- 鉴权类错误单独归类，它跟配额限流没有关系
- 测出稳定基线后，再决定是加退避、限并发还是换通道
先搞清楚是等一会儿能好，还是今天都不会好，再决定要不要动代码。
额度到底在哪看：一套固定的排查顺序
额度数字不会写在一个显眼的横幅上，得按顺序查。这套顺序的价值在于：每一步都能排掉一类可能性，不会让你在错误的方向上反复试。
- 第一步：看后台用量页面确认当前项目和当前 key 对应的是免费层还是计费层。大部分「额度莫名其妙没了」到这一步就解释清楚了。
- 第二步：看错误码本身区分是本分钟超了、本日超了，还是这个模型你根本没开通。三种情况的处理方式完全不同。
- 第三步：核对当时的数字单价、免费额度区间、各档位限制都会变，去 /official-api 和 /price-watch 核对当时的口径，别用上周记下来的数字推今天的事。
- 第四步：再决定升级或换通道确认是长期不够用，而不是偶发超限，再动手调整。偶发超限调架构比加钱更有效。
额度不够用时的降本动作和预算闸门
确认是长期不够用之后，再谈降本。顺序很重要：先做用量归因，找出吃掉大部分配额的少数几类请求，往往是长上下文或高频重试，而不是你调用次数最多的那类。
- 缩短输入：把整篇文档塞进去不如先做一次筛选再送
- 减少无效重试：没有退避的循环重试会成倍放大配额消耗
- 批量化：能合并的请求合并，减少固定开销
- 任务分级：非关键任务挪到更便宜的档位，关键路径保留高质量模型
- 最后才考虑升级订阅，先确认前面几步都做了
给项目加预算闸门，这一步最容易被忽略。设一个每日或每周的调用上限，超了就停，防止某次死循环或异常流量把整月额度跑空。数字设多少，取决于你的业务能承受多少，没有通用答案。
想更直观地看成本，可以去看 /usage 的真实用量分布做对照，再用 /tools/model-cost-calculator 把「每次调用多少钱」换算成「一个月多少钱」，比对着配额看更容易发现异常。
常见问题
买了 Google AI Pro，是不是就有 API 额度了？
不一定。订阅档位给的是客户端和网页端的使用权益，API 走的是另一套按项目计量的体系，两边不自动打通。要看你的 key 是在哪个项目下生成的、那个项目开的是免费层还是计费层。具体某档订阅包含什么，去站内订阅页和官方 API 页各看一遍再下结论。
调用报配额不足，是该等还是该升级？
先看错误里的时间单位。如果是每分钟级别的限制，等一会儿重试通常就恢复了，说明是限流不是配额；如果是每日额度，重试没有意义。先按「查项目归属→看错误码→核对当时限制」的顺序走一遍，确认真的是长期不够用，再考虑升级或换通道。
额度数字为什么每次查到的都不一样？
因为平台会调整免费层范围、限流档位和单价，这类数字本来就带时效性。所以别记死数字，记路径：需要时去站内官方 API 页和价格追踪页核对当前口径，再拿你自己的用量记录去对，这样推出来的预算才站得住。
