# Gemini API 免费层还能用吗？先检查模型、项目和地区

> Gemini API 免费层仍在：gemini-3.8-flash 等 Flash 模型免费，Pro、图片、视频须开通结算；开通后仍按免费层配额，先查 API Key 所属项目和结算账号状态。

- Source: https://www.aifreeapi.com/zh/posts/google-gemini-api-free-tier
- Language: zh
- Published: 2026-01-16
- Updated: 2026-10-10
- Publisher: AI Free API (https://www.aifreeapi.com)

截至 **2026 年 10 月 10 日**，Gemini Developer API 仍然提供免费层。在 Google 的 [Gemini Developer API 价格页](https://ai.google.dev/gemini-api/docs/pricing)上，输入和输出都标为免费的文本模型有 `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 一侧的问题。完整顺序见[开通结算后仍按免费层配额的排查](#已开通结算-显示-tier-1-仍按免费层配额-按这个顺序查)；想从付费层回到免费层，见[退回免费层](#怎样退回-gemini-api-免费层-逐个项目停用结算)。

“有免费层”只回答了最容易的那个问题。项目能否跑起来还取决于：所在地区是否支持、这个项目当前拿到多少配额，以及输入的数据能不能接受非付费服务条款。学习、验证提示词或做一个可容忍中断的内部原型，免费层依然很有价值；要服务真实用户、处理敏感资料或承诺稳定可用，就不应把“token 单价为 0”理解成生产级服务保证。

![API Key 落在免费层还是 Tier 1 付费层，取决于所属项目关联的结算账号](https://www.aifreeapi.com/posts/zh/google-gemini-api-free-tier/img/cover.webp)

## Gemini API 免费模型清单：哪些 model ID 能免费调用

下表是截至 2026 年 10 月 10 日，价格页“免费层级”一栏输入、输出都为免费的文本模型，状态取自 Google 的[模型页](https://ai.google.dev/gemini-api/docs/models)。请求里要填的是左列的 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 的[弃用页](https://ai.google.dev/gemini-api/docs/deprecations)写明，发往这两个 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 指南](/zh/posts/gemini-3-8-flash)；在几个文本模型之间按任务挑选，见 [Gemini 文本模型怎么选](/zh/posts/gemini-3-0-api)。

## 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 有问题。

价格行免费而自己未必能用，一共有三种情形：

1. **2.5 代模型**：受上面这条访问限制约束，老项目可能还能用，新项目按不能用处理。
2. **Preview 模型**：模型页说明 Preview 模型通常需要开通结算，速率限制可能更严格，弃用只提前至少两周通知。`gemini-3-flash-preview` 和几个 Live、TTS 的 Preview 模型都属于这一类，适合试用，不适合当作长期依赖。
3. **只能在 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 现状](/zh/posts/gemini-image-free-tier-2026)。

## Gemini 应用免费版和 API 免费层是两件事

“Gemini 免费模型”还可能指 Gemini 应用（gemini.google.com 和手机应用）的免费版。它是面向个人的聊天产品，不发 API Key，用量也不计入 API 项目。

[Google 的套餐页](https://gemini.google/subscriptions/)在 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 适用地区列表](https://ai.google.dev/gemini-api/docs/available-regions)。中国大陆不在列表中。这里的结论不是“换一种网络就能用”，而是官方开发者服务没有为该地区给出可用承诺；涉及团队采购、商业上线或合规评估时，应以官方区域页面和组织的法律意见为准。遇到地区提示时先分清是哪项服务不可用，见 [Gemini 目前不支持你所在的地区](/zh/posts/gemini-not-available-in-your-region)。开通结算也不改变这一点，付费层同样只在适用地区提供。

即使开发者所在地区受支持，也要继续检查最终用户。Google 当前的 [Gemini API 附加服务条款](https://ai.google.dev/gemini-api/terms) 要求：向欧洲经济区、瑞士或英国用户提供 API 客户端时，只能使用付费服务。这个条件与免费层有没有剩余额度无关。身在这些地区的开发者自己测试则可以用免费层，[结算指南](https://ai.google.dev/gemini-api/docs/billing)的常见问题对此的回答是“可以”。

地区满足条件后，再进入 [Google AI Studio](https://aistudio.google.com/) 创建或选择项目；新用户首次进入时，AI Studio 会自动创建一个项目和 API Key。API Key 是项目里的凭据，不是独立套餐，它继承项目的层级和结算状态。给同一项目多建几个 Key，不会把免费额度复制几份。

## “免费”至少包含三层不同含义

判断时最好把下面三个问题逐一回答：

1. **价格页是否给这个模型显示免费输入和输出？** 这决定模型是否存在免费计价路径，上面的清单回答的就是这一问。
2. **AI Studio 是否给当前项目显示有效限额？** 这决定你此刻实际能发多少请求。
3. **这个工作负载是否适合非付费服务条款？** 这决定免费路线是否值得使用。

模型名称和价格行都会随新模型发布而变化。复制一张几个月前的 RPM/RPD 表，看起来更直接，却很容易把别人的账号、旧模型或旧政策当成自己的当前额度。Google 的文档没有公布各模型免费层的固定限额表，而是要求在 AI Studio 查看有效速率限制，这才是项目决策的起点。

## 在 AI Studio 读懂真实配额

[官方速率限制说明](https://ai.google.dev/gemini-api/docs/rate-limits) 把限制分成三个主要维度：

- **RPM**：每分钟请求数。短时间并发过高时最先触发。
- **TPM**：每分钟输入 token 数。长文档或大上下文会比请求次数更早耗尽它。
- **RPD**：每日请求数。Google 按太平洋时间午夜重置，而不是按北京时间零点。

这些限制按**项目**计算，不按 API Key 计算。开发脚本、测试环境和演示服务如果共用一个项目，也会共用同一组限额。预览版与实验性模型采用更严格的限制；官方也说明，列出的速率限制不构成实际容量保证。

一个可靠的检查过程很短：

1. 在 AI Studio 确认当前 Key 属于哪个项目。
2. 打开该项目的有效速率限制页面。
3. 找到准备调用的精确 model ID，而不是只看 “Flash” 或 “Pro” 系列名。
4. 记录 RPM、TPM、RPD 和项目层级。
5. 让开发、定时任务与演示流量分别计数，避免自己消耗掉自己的免费池。

这里得到的数值才适合拿来估算。例如，一个每次请求输入 20,000 token 的文档应用，即便请求不多，也可能先撞到 TPM；一个短提示的并发机器人则更可能先撞 RPM。各层级的限额怎么查、怎么读，在 [Gemini API 分层速率限制](/zh/posts/gemini-api-rate-limits-per-tier) 里有更完整的说明。

## 用当前 SDK 发出第一条请求

Google 当前的 [Gemini API 入门指南](https://ai.google.dev/gemini-api/docs/get-started) 从 Interactions API 讲起，可以通过 Python、JavaScript SDK 或 REST 调用。先把 Key 放在环境变量里，不要写进仓库：

```bash
export GEMINI_API_KEY="YOUR_API_KEY"
pip install -U google-genai
```

然后用价格页显示可走免费层、Google 也建议新项目使用的 `gemini-3.8-flash` 做一次最小调用：

```python
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 定价](/zh/posts/gemini-api-token-pricing)，其中的数字是 2026 年 3 月的，现价以价格页为准。

## 429 不等于“再等一分钟就好”

`429 RESOURCE_EXHAUSTED` 只说明某种资源限制被触发，并没有告诉你应该盲目重试。先在 AI Studio 判断是哪一个维度：

| 现象 | 更可能的限制 | 有效动作 |
|---|---|---|
| 突发并发后失败 | RPM | 限制并发，加入带抖动的指数退避 |
| 少量大提示也失败 | TPM | 缩短上下文、分块或降低每分钟输入量 |
| 白天可用、之后全天失败 | RPD | 等待太平洋时间重置，或评估付费层 |
| 多个 Key 同时失败 | 项目共享配额 | 核对项目归属和所有工作负载 |
| 只有预览模型不稳定 | 更严格的预览限制或容量 | 选择合适的稳定模型并重新核对价格页 |
| 已开通结算，错误里的配额名仍带 `free_tier` | 请求仍按免费层配额计算 | 不要重试，按[下文的排查顺序](#已开通结算-显示-tier-1-仍按免费层配额-按这个顺序查)查项目和结算账号 |

退避只适合短时限制。若 RPD 已耗尽，循环重试只会制造更多失败日志。还要注意，返回 400 或 500 的失败请求不计 token 费用，但仍然计入配额，参数写错后反复重发同样会把免费额度耗掉。需要进一步排查请求错误时，可以转到 [Gemini API 错误修复 2026：快速解决 429、400 与 500](/zh/posts/gemini-api-error-fix-2026-429-400-500)。

## 免费层的数据代价

免费不仅是价格选择，也是数据条款选择。根据 Google 的附加条款，非付费服务中的输入和生成回答会用于提供、改进和开发 Google 产品，人工审核员可能阅读、标注和处理这些内容。Google 明确提醒不要向非付费服务提交敏感、机密或个人信息。

因此，下面这些任务不适合因为“还有额度”就继续留在免费层：客户合同、未公开代码、医疗或财务资料、带身份信息的客服记录，以及任何组织规定不得用于模型改进的数据。付费服务的提示和回答不用于改进 Google 产品，但仍应按组织的安全、留存与合规要求评估。API 只有通过关联了有效结算账号的 Cloud 项目访问时，才算付费服务。

## 什么时候开通结算

免费层最适合失败成本低、流量低且能排队的任务。出现以下任一情况时，付费层通常比继续调参更合理：

- 要通过 API 调用当前 Pro、图片、视频或音乐模型；
- 真实用户会因限额或容量波动直接受影响；
- 输入包含不适合非付费数据条款的内容；
- 目标用户位于条款要求使用付费服务的地区；
- 团队需要明确的成本控制、项目隔离和更高层级限额；
- 为躲避免费上限付出的工程时间已经高于可控 API 成本。

Google 当前的 [结算指南](https://ai.google.dev/gemini-api/docs/billing) 显示，从免费层升级需要关联结算账号，并预付至少 **5 美元**（或等值的当地货币，具体下限以结算界面对你所在地区的显示为准）。这两步都在 AI Studio 的 “Set up billing” 流程里完成；对默认使用预付款方案的新账号，只在 Google Cloud 控制台关联结算账号而没有预付，还不满足这两个条件。关联后项目进入第 1 层级，通常立即生效。预付的额度 12 个月后过期。

开通之后有两点和免费层不同。预付余额降到 0 时，该结算账号下的请求会以 HTTP 402 失败，项目不会自动退回免费层；想回到免费层，要把项目与结算账号解除关联，做法和后果见[下文](#怎样退回-gemini-api-免费层-逐个项目停用结算)。另一个常见误区是把 Google Cloud 新用户的 300 美元欢迎赠金当作 Gemini API 额度；Google 说明，2026 年 3 月 2 日之后开立的结算账号不能用这笔赠金支付 Gemini API 与 AI Studio 用量。付费方式和各使用层级的门槛见 [Gemini API Key 怎么付费](/zh/posts/gemini-api-key-tiers)。

开通结算前，先确认项目、模型和支出上限。开通后也不要假设所有问题会消失：继续观察 RPM、TPM、RPD、预付余额和实际费用，才能把“能调用”变成可运营的服务。

## 已开通结算、显示 Tier 1，仍按免费层配额：按这个顺序查

Gemini API 的层级、速率限制和支出上限都在**结算账号**这一层决定：关联到同一结算账号的项目继承它的层级，API Key 又没有自己的结算设置，只继承所在项目的层级和结算状态（见[结算指南](https://ai.google.dev/gemini-api/docs/billing)）。所以请求按免费层计，意味着发出请求的那个 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 步 |

支出限额出自[速率限制页](https://ai.google.dev/gemini-api/docs/rate-limits)；[故障排除指南](https://ai.google.dev/gemini-api/docs/troubleshooting)说明 400、402、403 不应重试。

![开了结算仍按免费层时的五步排查：Key 所属项目、结算账号状态、升级生效时间、Workspace 账号、找 Google，每步写明去哪里看和排除条件](https://www.aifreeapi.com/posts/zh/google-gemini-api-free-tier/img/billing-check-order.webp)

### 第 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 控制台的[结算页面](https://console.cloud.google.com/billing)查看这个账号，依次排除：

- **账号仍处于 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 分钟内生效（[速率限制页](https://ai.google.dev/gemini-api/docs/rate-limits)）；结算指南也写着，付款成功或达到条件后，层级变化通常在 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 说明](https://ai.google.dev/gemini-api/docs/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 结算支持](https://docs.cloud.google.com/billing/docs/support)（所有 Google Cloud 账号都可以免费获得结算支持；非结算管理员可以请管理员代为联系），以及 Google AI 开发者论坛。准备好项目编号、结算账号 ID（员工通常要求私信发送）、完整的错误响应和请求时间。**不要贴 API Key**，贴出错误或代码前先把 Key 删掉。

## 怎样退回 Gemini API 免费层：逐个项目停用结算

结算指南给出的办法是：对每个想降级的项目停用结算，也就是在 Google Cloud 控制台把项目与结算账号解除关联，解除后该项目回到免费层。余额用完不会帮你自动降级：预付余额到 0 时请求返回 402，项目仍留在付费层，直到充值或解除关联。

![结算账号下项目 A 保持 Tier 1，项目 B 解除关联后回到免费层：Flash 系列可用，Pro、图片、视频失败，数据按非付费条款处理](https://www.aifreeapi.com/posts/zh/google-gemini-api-free-tier/img/back-to-free-tier.webp)

动手之前，先弄清这几件事：

- **已买的预付额度留在结算账号上。** 额度 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 回复。