截至 2026 年 10 月 10 日,Gemini Developer API 仍然提供免费层。在 Google 的 Gemini Developer API 价格页上,输入和输出都标为免费的文本模型有 gemini-3.8-flash、gemini-3.6-flash、gemini-3.5-flash-lite、gemini-3.1-flash-lite 和 gemini-3-flash-preview。当前的 Pro 文本模型、全部图片模型、视频和音乐模型在免费层一栏写的是“不提供”,要通过 API 调用就得先开通结算。
新项目从 gemini-3.8-flash 或 gemini-3.5-flash-lite 起步最稳妥。价格页上 2.5 代的三个文本模型也标着免费,但 Google 只向过去活跃使用过它们的用户开放,新项目不要按它们来规划。
已经开通结算(也常说“开通计费”)、AI Studio 也显示 Tier 1,请求却仍因免费层配额报 429:层级由结算账号决定,经项目传给 API Key,所以先查出错的 Key 属于哪个项目,再查结算账号本身的状态,最后才是等待生效和 Google 一侧的问题。完整顺序见开通结算后仍按免费层配额的排查;想从付费层回到免费层,见退回免费层。
“有免费层”只回答了最容易的那个问题。项目能否跑起来还取决于:所在地区是否支持、这个项目当前拿到多少配额,以及输入的数据能不能接受非付费服务条款。学习、验证提示词或做一个可容忍中断的内部原型,免费层依然很有价值;要服务真实用户、处理敏感资料或承诺稳定可用,就不应把“token 单价为 0”理解成生产级服务保证。
Gemini API 免费模型清单:哪些 model ID 能免费调用
下表是截至 2026 年 10 月 10 日,价格页“免费层级”一栏输入、输出都为免费的文本模型,状态取自 Google 的模型页。请求里要填的是左列的 model ID,不是“Flash”“Pro”这样的系列名。
| model ID | 模型页状态 | 使用前要知道的 |
|---|---|---|
gemini-3.8-flash | 稳定版,当前最新的 Flash | Google 建议新项目使用 |
gemini-3.6-flash | 稳定版 | 可免费调用 |
gemini-3.5-flash-lite | 稳定版 | Google 建议新项目使用 |
gemini-3.1-flash-lite | 稳定版 | 可免费调用 |
gemini-3-flash-preview | Preview,价格页称其为旧版 Flash | 限额可能更严,下线只提前至少两周通知 |
gemini-2.5-pro、gemini-2.5-flash、gemini-2.5-flash-lite | 2.5 代,未弃用 | 只对过去活跃使用过的用户开放 |
gemini-3.7-flash 和 gemini-3.5-flash 已经不在价格页和模型页上。Google 的弃用页写明,发往这两个 ID 的请求会自动转到 gemini-3.8-flash 和 gemini-3.6-flash,关停日期尚未公布。代码里还写着旧 ID 的,实际执行的已经是新模型,直接改成新 ID 更清楚。
“Gemini 3 Flash”在这里是一个具体的 Preview 模型(gemini-3-flash-preview),不是 3.x 各版 Flash 的统称。照着旧清单填 gemini-2.0-flash、gemini-2.0-flash-lite、gemini-3-pro-preview 或 gemini-3.1-flash-lite-preview 会直接失败,这四个模型已经关停。gemini-flash-latest 这类别名会随每次发布切换到新模型,做实验方便,要固定行为的服务应写明具体版本。
文本之外,价格页还有这些免费行:
- 实时语音(Live):
gemini-3.8-live、gemini-3.8-live-extended-thinking、gemini-3.1-flash-live-preview,以及gemini-3.5-live-translate-preview、gemini-2.5-flash-native-audio-preview-12-2025(弃用页写明后者于 2026 年 11 月 17 日关停)。 - 语音转写:
gemini-3.5-transcribe、gemini-3.5-transcribe-live。 - 语音合成(TTS):
gemini-3.8-flash-tts、gemini-3.8-flash-lite-tts、gemini-3.1-flash-tts-preview、gemini-2.5-flash-preview-tts(同样于 2026 年 11 月 17 日关停)。 - 嵌入:Gemini Embedding 2,价格页写作
gemini-embedding-2,模型页写作gemini-embedding-2-preview,以你项目里能调通的那个为准。 - Gemma 4:只有免费层,付费层一栏反而是“不提供”。
- Gemini Robotics ER 2 Preview 及其 Streaming Preview。
免费层也能用一部分工具:代码执行、网址上下文和文件搜索免费;使用 Google 搜索建立依据在价格页上写的是每天 500 次请求免费,Flash 与 Flash-Lite 共用这一额度,Pro 不提供;Computer use 在免费层不可用。
想了解 3.8 Flash 本身的规格和付费价格,可以看 Gemini 3.8 Flash API 指南;在几个文本模型之间按任务挑选,见 Gemini 文本模型怎么选。
Gemini 2.5 Pro 免费吗:价格行免费,新项目未必能调用
gemini-2.5-pro 在价格页上确实有免费的输入、输出行,但对多数新读者来说这一行用不上。Google 在模型页写明:为保证性能,2.5 代模型只向过去活跃使用过它们的用户开放;这些模型没有弃用,会继续通过 API 提供;新项目应使用 3.5 Flash-Lite 或 3.8 Flash。Google 没有解释“活跃使用过”的具体标准,所以一个新建项目调用 gemini-2.5-pro、gemini-2.5-flash 或 gemini-2.5-flash-lite 被拒绝,并不说明 Key 有问题。
价格行免费而自己未必能用,一共有三种情形:
- 2.5 代模型:受上面这条访问限制约束,老项目可能还能用,新项目按不能用处理。
- Preview 模型:模型页说明 Preview 模型通常需要开通结算,速率限制可能更严格,弃用只提前至少两周通知。
gemini-3-flash-preview和几个 Live、TTS 的 Preview 模型都属于这一类,适合试用,不适合当作长期依赖。 - 只能在 AI Studio 网页里试的模型:见下一节。
Gemini Pro、图片、视频模型:通过 API 只能付费
当前的 Pro 文本模型没有免费的 API 调用途径。价格页免费层一栏写“不提供”的有:
| 类别 | model ID 或模型名 |
|---|---|
| 当前 Pro 文本模型 | gemini-3.1-pro-preview、gemini-3.1-pro-preview-customtools |
| 图片 | gemini-nano-banana-2.1(Nano Banana 2.1)、gemini-3.1-flash-image(Nano Banana 2)、gemini-3.1-flash-lite-image(Nano Banana 2 Lite)、gemini-3-pro-image(Nano Banana Pro)、gemini-2.5-flash-image |
| 视频 | gemini-omni-1.1-flash、gemini-omni-flash-preview、Veo 3.1(标准、fast、lite) |
| 音乐 | Lyria 3.5、Lyria 3 |
| Pro 语音合成 | gemini-2.5-pro-preview-tts |
gemini-3.1-pro-preview、Nano Banana 2 和 Nano Banana Pro 这几行带有脚注“可在 Google AI Studio 中测试”。这指的是在 AI Studio 网页界面里手动试用,不等于用 API Key 免费调用;没有开通结算的项目,用代码调用不了这些模型。
gemini-2.5-flash-image 已弃用但尚未关停:截至 2026 年 10 月 10 日,弃用页写的关停日期是 2027 年 3 月 15 日,替代模型为 gemini-3.1-flash-lite-image;价格页上的警告仍写着 2026 年 10 月 2 日,两处不一致时以专门列关停日期的弃用页为准。更正:此处在 2026 年 10 月 8 日之前写的是“已于 10 月 2 日关停”。
只是想免费出图而不是写代码调用,途径不在 API 这边,见 Gemini 图片免费额度 2026:App 每日上限和 API 现状。
Gemini 应用免费版和 API 免费层是两件事
“Gemini 免费模型”还可能指 Gemini 应用(gemini.google.com 和手机应用)的免费版。它是面向个人的聊天产品,不发 API Key,用量也不计入 API 项目。
Google 的套餐页在 2026 年 10 月 1 日列出的免费版内容是:使用 3.6 Flash,并注明 3.1 Pro 的使用权限可能变动;包含图片生成与编辑、Deep Research、Gemini Live、Canvas 和 Gem。应用的用量按消耗的计算量计,取决于提示的复杂程度、用到的功能和对话长度,每 5 小时重置一次,直到达到每周上限;页面没有给出每天能发多少条。套餐内容和价格因国家或地区而异。
所以在应用里能和 Pro 对话,不代表你的 API 项目能免费调用 Pro;反过来,API 免费层的模型清单也不决定应用里能选哪个模型。
先做地区判断,再创建 Key
Google 维护了一份 Google AI Studio 与 Gemini API 适用地区列表。中国大陆不在列表中。这里的结论不是“换一种网络就能用”,而是官方开发者服务没有为该地区给出可用承诺;涉及团队采购、商业上线或合规评估时,应以官方区域页面和组织的法律意见为准。遇到地区提示时先分清是哪项服务不可用,见 Gemini 目前不支持你所在的地区。开通结算也不改变这一点,付费层同样只在适用地区提供。
即使开发者所在地区受支持,也要继续检查最终用户。Google 当前的 Gemini API 附加服务条款 要求:向欧洲经济区、瑞士或英国用户提供 API 客户端时,只能使用付费服务。这个条件与免费层有没有剩余额度无关。身在这些地区的开发者自己测试则可以用免费层,结算指南的常见问题对此的回答是“可以”。
地区满足条件后,再进入 Google AI Studio 创建或选择项目;新用户首次进入时,AI Studio 会自动创建一个项目和 API Key。API Key 是项目里的凭据,不是独立套餐,它继承项目的层级和结算状态。给同一项目多建几个 Key,不会把免费额度复制几份。
“免费”至少包含三层不同含义
判断时最好把下面三个问题逐一回答:
- 价格页是否给这个模型显示免费输入和输出? 这决定模型是否存在免费计价路径,上面的清单回答的就是这一问。
- AI Studio 是否给当前项目显示有效限额? 这决定你此刻实际能发多少请求。
- 这个工作负载是否适合非付费服务条款? 这决定免费路线是否值得使用。
模型名称和价格行都会随新模型发布而变化。复制一张几个月前的 RPM/RPD 表,看起来更直接,却很容易把别人的账号、旧模型或旧政策当成自己的当前额度。Google 的文档没有公布各模型免费层的固定限额表,而是要求在 AI Studio 查看有效速率限制,这才是项目决策的起点。
在 AI Studio 读懂真实配额
官方速率限制说明 把限制分成三个主要维度:
- RPM:每分钟请求数。短时间并发过高时最先触发。
- TPM:每分钟输入 token 数。长文档或大上下文会比请求次数更早耗尽它。
- RPD:每日请求数。Google 按太平洋时间午夜重置,而不是按北京时间零点。
这些限制按项目计算,不按 API Key 计算。开发脚本、测试环境和演示服务如果共用一个项目,也会共用同一组限额。预览版与实验性模型采用更严格的限制;官方也说明,列出的速率限制不构成实际容量保证。
一个可靠的检查过程很短:
- 在 AI Studio 确认当前 Key 属于哪个项目。
- 打开该项目的有效速率限制页面。
- 找到准备调用的精确 model ID,而不是只看 “Flash” 或 “Pro” 系列名。
- 记录 RPM、TPM、RPD 和项目层级。
- 让开发、定时任务与演示流量分别计数,避免自己消耗掉自己的免费池。
这里得到的数值才适合拿来估算。例如,一个每次请求输入 20,000 token 的文档应用,即便请求不多,也可能先撞到 TPM;一个短提示的并发机器人则更可能先撞 RPM。各层级的限额怎么查、怎么读,在 Gemini API 分层速率限制 里有更完整的说明。
用当前 SDK 发出第一条请求
Google 当前的 Gemini API 入门指南 从 Interactions API 讲起,可以通过 Python、JavaScript SDK 或 REST 调用。先把 Key 放在环境变量里,不要写进仓库:
export GEMINI_API_KEY="YOUR_API_KEY"
pip install -U google-genai然后用价格页显示可走免费层、Google 也建议新项目使用的 gemini-3.8-flash 做一次最小调用:
from google import genai
client = genai.Client()
interaction = client.interactions.create(
model="gemini-3.8-flash",
input="用三句话解释向量数据库。",
)
print(interaction.output_text)想用更轻量的模型,可以把 model 换成 gemini-3.5-flash-lite,其余代码不变。调用成功后,回到 AI Studio 看用量是否计入预期项目。这个动作能同时排除三个常见错误:环境变量没有被读取、Key 属于另一个项目、代码里的 model ID 已经失效。
如果你更关心付费后的 token 单价而非免费额度,可继续查看 Gemini API Token 定价,其中的数字是 2026 年 3 月的,现价以价格页为准。
429 不等于“再等一分钟就好”
429 RESOURCE_EXHAUSTED 只说明某种资源限制被触发,并没有告诉你应该盲目重试。先在 AI Studio 判断是哪一个维度:
| 现象 | 更可能的限制 | 有效动作 |
|---|---|---|
| 突发并发后失败 | RPM | 限制并发,加入带抖动的指数退避 |
| 少量大提示也失败 | TPM | 缩短上下文、分块或降低每分钟输入量 |
| 白天可用、之后全天失败 | RPD | 等待太平洋时间重置,或评估付费层 |
| 多个 Key 同时失败 | 项目共享配额 | 核对项目归属和所有工作负载 |
| 只有预览模型不稳定 | 更严格的预览限制或容量 | 选择合适的稳定模型并重新核对价格页 |
已开通结算,错误里的配额名仍带 free_tier | 请求仍按免费层配额计算 | 不要重试,按下文的排查顺序查项目和结算账号 |
退避只适合短时限制。若 RPD 已耗尽,循环重试只会制造更多失败日志。还要注意,返回 400 或 500 的失败请求不计 token 费用,但仍然计入配额,参数写错后反复重发同样会把免费额度耗掉。需要进一步排查请求错误时,可以转到 Gemini API 错误修复 2026:快速解决 429、400 与 500。
免费层的数据代价
免费不仅是价格选择,也是数据条款选择。根据 Google 的附加条款,非付费服务中的输入和生成回答会用于提供、改进和开发 Google 产品,人工审核员可能阅读、标注和处理这些内容。Google 明确提醒不要向非付费服务提交敏感、机密或个人信息。
因此,下面这些任务不适合因为“还有额度”就继续留在免费层:客户合同、未公开代码、医疗或财务资料、带身份信息的客服记录,以及任何组织规定不得用于模型改进的数据。付费服务的提示和回答不用于改进 Google 产品,但仍应按组织的安全、留存与合规要求评估。API 只有通过关联了有效结算账号的 Cloud 项目访问时,才算付费服务。
什么时候开通结算
免费层最适合失败成本低、流量低且能排队的任务。出现以下任一情况时,付费层通常比继续调参更合理:
- 要通过 API 调用当前 Pro、图片、视频或音乐模型;
- 真实用户会因限额或容量波动直接受影响;
- 输入包含不适合非付费数据条款的内容;
- 目标用户位于条款要求使用付费服务的地区;
- 团队需要明确的成本控制、项目隔离和更高层级限额;
- 为躲避免费上限付出的工程时间已经高于可控 API 成本。
Google 当前的 结算指南 显示,从免费层升级需要关联结算账号,并预付至少 5 美元(或等值的当地货币,具体下限以结算界面对你所在地区的显示为准)。这两步都在 AI Studio 的 “Set up billing” 流程里完成;对默认使用预付款方案的新账号,只在 Google Cloud 控制台关联结算账号而没有预付,还不满足这两个条件。关联后项目进入第 1 层级,通常立即生效。预付的额度 12 个月后过期。
开通之后有两点和免费层不同。预付余额降到 0 时,该结算账号下的请求会以 HTTP 402 失败,项目不会自动退回免费层;想回到免费层,要把项目与结算账号解除关联,做法和后果见下文。另一个常见误区是把 Google Cloud 新用户的 300 美元欢迎赠金当作 Gemini API 额度;Google 说明,2026 年 3 月 2 日之后开立的结算账号不能用这笔赠金支付 Gemini API 与 AI Studio 用量。付费方式和各使用层级的门槛见 Gemini API Key 怎么付费。
开通结算前,先确认项目、模型和支出上限。开通后也不要假设所有问题会消失:继续观察 RPM、TPM、RPD、预付余额和实际费用,才能把“能调用”变成可运营的服务。
已开通结算、显示 Tier 1,仍按免费层配额:按这个顺序查
Gemini API 的层级、速率限制和支出上限都在结算账号这一层决定:关联到同一结算账号的项目继承它的层级,API Key 又没有自己的结算设置,只继承所在项目的层级和结算状态(见结算指南)。所以请求按免费层计,意味着发出请求的那个 Key 所在的项目,在 Google 那边仍被当作免费项目。前两步在自己的账号里就能查完;只有都排除了,才轮到等待和找 Google。
先看错误响应确认是不是这个问题,Gemini API 的 429 会写明触发的是哪个配额:
| 错误里看到的 | 说明什么 | 下一步 |
|---|---|---|
429,配额名带 free_tier,例如 generate_content_free_tier_requests 或 GenerateRequestsPerDayPerProjectPerModel-FreeTier | 这次请求按免费层配额计算 | 按下面第 1~5 步查 |
同样的 free_tier 配额,并且是 limit: 0,模型是 Pro 或图片模型 | 这些模型的免费层配额是 0,所以第一次调用就失败;同一项目调文本模型能成功,只是超过免费层的低限额才报错 | 同上,“文本模型能用”不能证明已经升级 |
402 Payment Required | 预付余额已到 0,这个结算账号下所有项目的 Key 同时停用,项目不会自动退回免费层 | 去 AI Studio 结算页充值,不要重试 |
429,配额名不带 free_tier | 可能已是付费层的限额,包括按支出计的限额:10 分钟滚动窗口内 Tier 1 为 $10、Tier 2 为 $50、Tier 3 为 $200 | 回到上面的 429 一节按维度处理 |
403,“Your project has been denied access”,项目旁显示 “Unavailable” 或 “Restricted” | Google 员工的解释是账号被加了标记 | 看第 4、5 步 |
支出限额出自速率限制页;故障排除指南说明 400、402、403 不应重试。

第 1 步:出错的 API Key 属于哪个项目,那个项目开了结算吗
最先排除的是“付费的是另一个项目”。新用户第一次进入 AI Studio 时会自动得到一个默认项目和 Key;后来为了开结算又新建或导入了项目,代码里却还在用最早那个 Key,请求就仍跑在免费项目上。在 Cloud 控制台“凭据”页给某个项目建的 Key,同样只继承那个项目。
去哪里看:AI Studio 的 API 密钥页列出每个 Key 和所属项目;Projects 页的 “Billing Tier” 一列显示每个项目的层级和结算方案。这一列或 “Status” 列出现下面任何一个提示,说明这个项目还没有进入付费状态,点提示把流程走完:
- “Set up billing”:项目没有关联结算账号。
- “Set up Prepay”:已关联结算账号,但该账号要求使用预付款方案,而预付款还没设置。
- “No credits”:要求购买额度,但预付款账号没设置或余额已用完。
然后确认代码实际用的就是这个项目的 Key:在显示 Tier 1、没有上述提示的项目里新建一个 Key,把环境变量、部署平台的密钥设置等所有地方都换成它,再发一次同样的请求。Google AI 开发者论坛上,Google 员工在 2026 年 8 月 11 日和 8 月 21 日给出的处理都是这一步:确认用来创建 Key 的项目已关联有效的结算账号,并在 Tier 1 项目里新建 Key 使用。另一例中(2026 年 7 月 7 日),员工检查对方项目后没有发现任何 429,判断是“调用时用的项目和 Key 搞混了”。
通过条件:新 Key 来自显示 Tier 1 的项目,请求仍返回带 free_tier 的 429,这一步就可以排除。
第 2 步:结算账号是不是免费试用、已关闭或欠费
Projects 页显示 Tier 1,不代表结算账号本身合格。到 Google Cloud 控制台的结算页面查看这个账号,依次排除:
- 账号仍处于 Google Cloud 免费试用(Free Trial)状态。 这是 Google Cloud 的 300 美元试用,和 Gemini API 的免费层不是一回事。结算指南说,AI Studio 结算页出现 “The billing account type is inactive or unsupported” 时,说明账号类型或状态不符合付费层要求,免费试用账号就是一例;已关闭(Closed)的账号则要重新开启。2026 年 9 月 8 日,一位 Google 员工在论坛回复一例“已关联预付款账号、仍是免费层、Gemini 3.6 Flash 只有 5 RPM”的情况,给出的原因正是结算账号仍在免费试用状态:先在 Cloud 控制台完成升级、退出试用,再到 AI Studio 结算页预付。同一条回复说明,Google 没有手动同步结算状态的机制。
- 只在 Cloud 控制台关联了结算,打算用赠金付费。 结算指南把升级定义为两件事:关联结算账号,并在 AI Studio 预付至少 5 美元。2026 年 3 月 2 日之后开立的账号,300 美元欢迎赠金不能支付 Gemini API;使用预付款方案时,要先买预付额度,符合条件的 Cloud 赠金才会被扣用。GitHub 上 2026 年 3 月 4 日的一份报告就是这种做法:在 Cloud 控制台建项目、关联有额度的结算账号、启用 API、在凭据页建 Key,调用
gemini-3-flash-preview仍按免费层每天 20 次计。那份报告早于预付款方案生效(2026 年 3 月 23 日),Google 也一直没有回复,当时的原因无从确认;按现在的规则推断,同样的配置既缺 AI Studio 里的预付,赠金本身也付不了 Gemini API。 - 欠费、扣款失败或付款方式失效。 结算账号只要有逾期余额、付款被拒、付款方式无效或过期,Gemini API 就会被暂停,不管预付余额还剩多少;欠的也可能是同一账号下其他 Cloud 服务的后付费账单。这只能在 Cloud 控制台的结算页处理。
- 预付款设置做到一半取消了。 给已有的后付费(Postpay)账号加预付功能时,确认对话框之后放弃,账号会停在无法扣款的状态,挂在它下面的所有项目都会受影响。办法是回 AI Studio 重新走完预付流程,或者请 Cloud 结算支持手动重置。
- 后付费账号付款记录少。 这一条结算指南里没有写,只来自 Google 员工对个案的回复。2026 年 7 月 29 日,一个 Tier 1 后付费项目调用图片模型按免费层计,员工给出的原因是该结算账号“历史付款记录太少”,办法是预付或提前付款以建立付款记录,或者换一个已有付款记录的结算账号。2026 年 8 月 12 日,另一位员工提醒:在后付费账号上预付时,账号仍须达到升级门槛,与预付金额无关。两条回复都很简短,Google 没有公布具体门槛。
通过条件:Cloud 控制台里账号不是试用、没有关闭、没有欠费或付款提示,AI Studio 结算页能看到正的预付余额,或正常的后付费方案。
第 3 步:Tier 升级多久生效
按 Google 的说法,从免费层升到 Tier 1 通常立即生效,之后的层级升级在 10 分钟内生效(速率限制页);结算指南也写着,付款成功或达到条件后,层级变化通常在 10 分钟内反映出来。例外是付款确认:多数银行卡付款即时完成,银行转账等方式可能要几天,确认之前服务不会升级或恢复。AI Studio 的费用图表最多要 24 小时才更新,不能拿它判断升级有没有生效。
通过条件:用银行卡付款已经过去 10 分钟以上,请求仍按免费层计,就不用再等了。
第 4 步:用的是不是 Google Workspace 账号
“Workspace 账号没有免费层”有用户报告,但 Google 的文档里没有这条规定。
- 报告:2026 年 2 月 12 日,一位开发者在 note.com 上记录,Workspace 账号下新建的 Key 第一次调用
gemini-2.5-flash就返回 429,AI Studio 里未开结算的项目层级显示 “Unavailable”;同样的步骤换成个人 @gmail.com 账号就正常。作者的结论是 Workspace 组织下的项目不分配免费层,同时注明官方文档没有写。2026 年 9 月,官方论坛也有 Workspace(包括教育版)项目显示 “Billing Tier: Unavailable”“Status: Restricted”、调用返回 403 的帖子。 - 官方:AI Studio 的 Workspace 说明只写了 AI Studio 对所有 Workspace 版本默认开启、管理员可以按组织部门关闭、教育版中未满 18 岁的用户不能使用。Google 员工把 “Unavailable” 解释为账号被自动标记,2026 年 8 月也有个人 Gmail 账号出现同样的状态。
用来排查时要分清两种情况。Workspace 账号下未开结算的项目显示 “Unavailable”、返回 403 或首次请求就 429,更接近“拿不到免费层”,不是“付费没生效”。对照方法是用个人 Google 账号建一个项目和 Key,发同样的请求:个人账号正常、Workspace 账号不行,问题就在账号这一侧;报告中走通的办法是给 Workspace 项目开结算,之后就不再是免费使用。反过来,Workspace 项目已经显示 Tier 1、仍报带 free_tier 的 429 时,这些报告解释不了:它们说的都是未开结算的项目,应回到第 1、2 步。
第 5 步:都排除后,可能是账号标记或 Google 后端
- 账号被自动标记。 2026 年 7 月 20 日,一位 Google 员工回复一例“已是 Tier 1、后来掉回免费层、48 小时没恢复”的情况,认为很可能是账号上的自动标记。这类标记通常会在 AI Studio 的 Projects 页或结算页出现横幅或错误提示,附带后续步骤或申诉链接,项目关联的邮箱也可能收到说明。项目旁显示 “Unavailable”、请求返回 403 时,员工给的步骤是:在 AI Studio 的速率限制页确认模型在当前方案下可用,完成 Google 账号的年龄验证、手机验证和两步验证,然后重试或新建 Key。
- Google 后端的临时故障。 一个 Tier 1 预付款项目的所有请求都返回 429,到 2026 年 9 月 1 日发帖时已持续 48 小时以上;Google 员工 9 月 2 日确认是“临时的后端错误,已修复”。2026 年 4 月另一例图片模型
free_tier、limit: 0的报告,第二天未做任何改动就恢复了。 - 少数情况下升级会被拒绝。 速率限制页写明,满足条件通常足以升级,但在少数情况下,升级可能因审核中发现的其他因素被拒。Google 没有公布这些因素,也没有自助的重新同步入口。
这时该找 Google,而不是继续重试。Python SDK 默认就会对 429 自动重试最多 4 次,配额被判为免费层时,重试只会多攒失败日志。求助渠道有两个:Cloud 结算支持(所有 Google Cloud 账号都可以免费获得结算支持;非结算管理员可以请管理员代为联系),以及 Google AI 开发者论坛。准备好项目编号、结算账号 ID(员工通常要求私信发送)、完整的错误响应和请求时间。不要贴 API Key,贴出错误或代码前先把 Key 删掉。
怎样退回 Gemini API 免费层:逐个项目停用结算
结算指南给出的办法是:对每个想降级的项目停用结算,也就是在 Google Cloud 控制台把项目与结算账号解除关联,解除后该项目回到免费层。余额用完不会帮你自动降级:预付余额到 0 时请求返回 402,项目仍留在付费层,直到充值或解除关联。

动手之前,先弄清这几件事:
- 已买的预付额度留在结算账号上。 额度 12 个月后过期,一般不退款(结算指南只在预付款改为后付费的情况下退回余额);关闭结算账号会让剩余额度作废。只想让某个项目回到免费层时,解除这个项目的关联即可,不要关闭结算账号。
- 同一结算账号下的其他项目不受影响。 层级属于结算账号,其余项目仍是付费层;以后把项目重新关联到这个账号,它会按该账号的层级计。
- 数据条款跟着变。 免费层项目的 API 用量属于非付费服务,输入和输出可能用于改进 Google 产品,也可能被人工审核(见上文“免费层的数据代价”)。另外,只要还有至少一个 API 项目开着结算,AI Studio 里的提示就按付费服务条款处理;反过来推断,全部项目都停用结算后,AI Studio 里的使用会回到非付费条款,Google 没有单独写明这一点。
- 能用的模型变少。 退回后,Pro、图片、视频、音乐模型的 API 调用会因免费层配额为 0 而失败,2.5 代不对新项目开放的限制也照旧。
- Workspace 账号可能退不回可用的免费层。 按上面第 4 步的报告,未开结算的 Workspace 项目可能显示 “Unavailable”。
很多时候不必降级。结算指南说明,可以按需使用各自的 Key 在付费层项目和免费层项目之间切换:测试用免费项目的 Key,生产用付费项目的 Key。只是想控制花费的话,AI Studio 支持按项目设置每月支出上限(实验性功能,结算数据约有 10 分钟延迟,可能略超),开了自动充值的也可以设每月自动扣款上限。
一条足够稳妥的结论
截至 2026 年 10 月 10 日,Gemini API 免费层仍然真实存在,覆盖从 gemini-3.1-flash-lite 到 gemini-3.8-flash 的 Flash 与 Flash-Lite 文本模型,以及 Live、转写、语音合成、嵌入和 Gemma 4,足够完成学习、提示验证和很多低流量原型。它不包含当前的 Pro、图片、视频和音乐模型,也不是一张永久固定的额度表,更不是生产 SLA。
最可靠的做法是:先核对地区与数据边界,在官方价格页确认要用的 model ID 当前有免费价格,再到 AI Studio 读取该项目的有效限额,发出最小请求并观察真实用量。只要可靠性、隐私、最终用户地区或工程成本成为主要约束,就应把付费层当作正常的生产选择,而不是免费层失败后的临时补丁。开通之后若仍按免费层配额被拒,先查 Key 所属项目,再查结算账号,这两步通常不需要等 Google 回复。



