很多人第一次用 Google AI Studio,是通过网页对话还是 API key 分不清,以为「免费额度」是一个统一数字。真到写代码时才发现,网页里能跑不代表接口能调,接口能调不代表额度够一轮批量任务。这篇按入口把覆盖范围拆开讲,给一套自查顺序,让你在动手前就知道这次调用走的是哪条额度。
很多人第一次接触 Google AI Studio,其实是通过网页对话进去的,聊几句觉得「这不免费吗」,就以为免费额度是件很确定的事。等到真的写代码、发 API key 请求,才发现网页里能跑和接口能调完全是两码事,接口能调又不代表额度撑得住一轮批量任务。
这篇不给你一个「免费额度等于多少」的固定答案,那种数字隔一阵就变一次,照抄旧文章只会踩坑。这里只做一件事:把入口拆开,给你一套动手前的自查顺序,让你在发出第一个请求前就知道,这次调用走的是哪条额度通道、边界在哪。
先分清入口:网页、API、以及挂靠在别处的调用
免费额度最容易搞混的地方,是大家默认它只有一个。实际上至少有三种走法:在 AI Studio 网页里点着试玩、拿自己的 API key 在代码里直接调、以及通过第三方平台(聚合站、云厂商托管服务)转发调用。这三条路的额度池、限速口径、计费主体都不一样,互不共享也互不顶替。
| 入口形态 | 额度归属 | 你要去哪里确认 |
|---|---|---|
| AI Studio 网页试玩 | 平台自己的试玩额度 | 到 /official-api/providers/google 看当期说明 |
| 自己的 API key 直连 | 绑定项目的免费/付费额度 | 到 /plans/gemini-ai-pro 核对计划口径 |
| 云厂商托管或中转站 | 对方的计费体系 | 到 /sites 里的中转站条目自行判断可信度 |
重点在于第二条和第三条常被忽略。如果你是从某个中转站拿到的 key,那这次调用发生在对方的账号里,AI Studio 那套免费规则跟你没关系。判断标准很简单:看这个请求最终记在谁的账单上。记不清就说明你没确认过入口,别急着写批量脚本。
免费额度一般覆盖什么、不覆盖什么
免费额度通常倾向于覆盖文本类的基础调用,以及一定量的网页试玩次数。一旦你开始传图片、传音频、传长文件,很多时候就落在「另算」甚至「不在范围内」的区域了。这不是说这些功能一定不能用,而是说别默认它们和纯文本走同一份额度。
还有一个经常被混为一谈的点:总量和速率是两回事。总量是你还能用多少,速率是每分钟、每天最多发多少次请求。撞到任意一个都会报错,但报错信息和解法完全不同。只看一个维度去估算,很容易在批量任务跑一半时突然断掉。
- 具体覆盖哪些模态、速率上限是多少,到 /official-api/providers/google 核对当期口径,别照抄任何旧文章的数字
- 同时在 /plans/gemini-ai-pro 看计划层面的说明,两处对照着看才完整
- 额度用完后的行为也要确认:是直接拒绝、排队,还是自动转付费,这决定了你要不要提前准备通道
- 不适用的情况:如果你要跑的是有稳定 SLA 要求的生产服务,免费额度不管覆盖多少,都不该作为容量规划的基础
动手前的四步自查顺序
与其事后排查为什么报错,不如动手前花几分钟把这四步过一遍。顺序不要跳,每一步的结论会决定下一步问什么。
- 第一步:确认入口这次调用是网页对话、自己的 API key,还是别人平台转发的?把 base_url 和 key 来源写下来,来源不明的先去 /sites 查。
- 第二步:确认模态纯文本,还是带图、带文件、带音频?非文本的部分先去 /official-api/providers/google 确认是否在这一期的覆盖范围内。
- 第三步:确认量级单次调用还是批量跑?按日均调用数和峰值并发估一遍,看会不会先撞速率上限。拿不准就到 /tools/model-cost-calculator 按 token 粗算一轮消耗。
- 第四步:确认兜底额度耗尽后是什么行为?直接报错还是转付费?到 /resets 和相关说明页看当期规则,据此决定要不要提前接好付费通道。
这四步做完,基本能避免「脚本跑到一半突然断掉、还不知道断在哪」的尴尬。尤其是第三步,很多人的问题不是额度不够,而是一秒钟发了太多请求被限速挡下来了。
什么时候免费额度一定不够用
先说清楚:下面这些场景不是说免费额度有问题,而是说它们本来就不该靠免费通道扛。判断标准是「稳定性要求」和「并发规模」,而不是「用了多少 token」。
- 需要长时间稳定运行、并发要求高的服务:速率上限会先卡住你,这跟总额度还剩多少没关系
- 涉及长文档、大上下文的批量任务:单次消耗高,掉得比想象快,建议先用 /tools/model-cost-calculator 估一遍
- 团队多人共用一个 key:额度是共享的,谁在跑什么很难追溯,这种场景更适合单独开付费账号并把用量分离
- 不适用的情况:一次性的验证、学习、个人小脚本调试,免费额度通常绰绰有余,没必要提前付费
最后提醒一句,上面提到的所有具体数字——覆盖多少个模态、速率是多少、额度耗尽的处理方式——都会调整。这类信息一律以站内当期页面为准,别拿半年前某篇教程里的数字去套现在的情况。
下一步与其记数字,不如先确认自己走的是哪条通道。去中转站列表翻一翻你正在用的平台有没有被记录,再去模型成本计算器把这次任务的量级估出来,两件事做完,要不要准备付费通道心里就有数了。→常见问题
网页里能免费用,为什么写成代码调用就报错了?
因为网页试玩和 API 调用是两条不同的额度通道,各自有独立的速率和用量限制。网页里跑通只说明模型可用,不代表你的 API key 有同样的可用额度。先确认你调用的是哪条通道,再去站内核对对应的当期限制。
免费额度用完之后会自动扣费吗?
取决于你的账号有没有绑定结算方式。没绑定的通常直接报错或拒绝请求;绑定过的可能转入付费计费。这个规则各家会调整,别凭印象判断,到 /resets 和官方 API 说明页看当期口径,再决定要不要绑卡。
额度是每天恢复还是用完就没了?
多数免费通道是按时间窗口滚动的,撞到的如果是速率限制,等窗口过去就能继续;撞到的是总量上限,那就得等下一个周期或换付费通道。两种情况报错信息不同,先看清报的是哪一个再决定等不等。