截至 2026 年 8 月 15 日，Gemini Developer API 仍然提供免费层。你可以在 Google AI Studio 创建项目和 API Key，并让部分模型以免费价格处理输入与输出。不过，“有免费层”只回答了最容易的那个问题。真正决定项目能否跑起来的是：所在地区是否支持、所选模型是否有免费价格、这个项目当前获得了多少配额，以及输入的数据能不能接受非付费服务条款。
如果只是学习、验证提示词或做一个可容忍中断的内部原型，免费层依然很有价值。如果要服务真实用户、处理敏感资料或承诺稳定可用，就不应把“token 单价为 0”理解成生产级服务保证。
先做地区判断，再创建 Key
Google 维护了一份 Google AI Studio 与 Gemini API 适用地区列表。截至本文更新日，中国大陆不在列表中。这里的结论不是“换一种网络就能用”，而是官方开发者服务没有为该地区给出可用承诺；涉及团队采购、商业上线或合规评估时，应以官方区域页面和组织的法律意见为准。
即使开发者所在地区受支持，也要继续检查最终用户。Google 当前的 Gemini API 附加服务条款 要求：向欧洲经济区、瑞士或英国用户提供 API 客户端时，只能使用付费服务。这个条件与免费层有没有剩余额度无关。
地区满足条件后，再进入 Google AI Studio 创建或选择项目。API Key 是项目里的凭据，不是独立套餐。给同一项目多建几个 Key，不会把免费额度复制几份。
“免费”至少包含三层不同含义
判断时最好把下面三个问题逐一回答：
- 价格页是否给这个模型显示免费输入和输出？ 这决定模型是否存在免费计价路径。
- AI Studio 是否给当前项目显示有效限额？ 这决定你此刻实际能发多少请求。
- 这个工作负载是否适合非付费服务条款？ 这决定免费路线是否值得使用。
Google 的 Gemini Developer API 价格页 在 2026 年 8 月列出了多种带免费输入、输出价格的文本模型，包括 gemini-3.6-flash、gemini-3.5-flash、gemini-3.5-flash-lite 和 gemini-3.1-flash-lite。同一页面也有仅付费可用的模型，因此不能从“Gemini 有免费层”推出“任意 Gemini 模型都免费”。
模型名称和价格行都可能变化。复制一张几个月前的 RPM/RPD 表，看起来更直接，却很容易把别人的账号、旧模型或旧政策当成自己的当前额度。Google 现在明确要求在 AI Studio 查看有效速率限制，这才是项目决策的起点。
在 AI Studio 读懂真实配额
官方速率限制说明 把限制分成三个主要维度：
- RPM：每分钟请求数。短时间并发过高时最先触发。
- TPM：每分钟输入 token 数。长文档或大上下文会比请求次数更早耗尽它。
- RPD：每日请求数。Google 按太平洋时间午夜重置，而不是按北京时间零点。
这些限制按项目计算，不按 API Key 计算。开发脚本、测试环境和演示服务如果共用一个项目，也会共用同一组限额。预览版与实验性模型还可能采用更严格的限制；官方也说明，列出的速率限制不构成实际容量保证。
一个可靠的检查过程很短：
- 在 AI Studio 确认当前 Key 属于哪个项目。
- 打开该项目的有效速率限制页面。
- 找到准备调用的精确模型 ID，而不是只看 “Flash” 或 “Pro” 家族名。
- 记录 RPM、TPM、RPD 和项目层级。
- 让开发、定时任务与演示流量分别计数，避免自己消耗掉自己的免费池。
这里得到的数值才适合拿来估算。例如，一个每次请求输入 20,000 token 的文档应用，即便请求不多，也可能先撞到 TPM；一个短提示的并发机器人则更可能先撞 RPM。
用当前 SDK 发出第一条请求
Google 当前的 Gemini API 入门指南 推荐 GA 的 Interactions API 和 google-genai SDK。先把 Key 放在环境变量里，不要写进仓库：
bashexport GEMINI_API_KEY="YOUR_API_KEY" pip install -U google-genai
然后用价格页显示可走免费层、且官方入门示例正在使用的 gemini-3.6-flash 做一次最小调用：
pythonfrom google import genai client = genai.Client() interaction = client.interactions.create( model="gemini-3.6-flash", input="用三句话解释向量数据库。", ) print(interaction.output_text)
调用成功后，回到 AI Studio 看用量是否计入预期项目。这个动作能同时排除三个常见错误：环境变量没有被读取、Key 属于另一个项目、代码里的模型 ID 已经失效。
如果你更关心现行 token 单价而非免费额度，可继续查看同语种的 Gemini API token 价格说明。
429 不等于“再等一分钟就好”
429 RESOURCE_EXHAUSTED 只说明某种资源限制被触发，并没有告诉你应该盲目重试。先在 AI Studio 判断是哪一个维度：
| 现象 | 更可能的限制 | 有效动作 |
|---|---|---|
| 突发并发后失败 | RPM | 限制并发，加入带抖动的指数退避 |
| 少量大提示也失败 | TPM | 缩短上下文、分块或降低每分钟输入量 |
| 白天可用、之后全天失败 | RPD | 等待太平洋时间重置，或评估付费层 |
| 多个 Key 同时失败 | 项目共享配额 | 核对项目归属和所有工作负载 |
| 只有预览模型不稳定 | 更严格的预览限制或容量 | 选择合适的稳定模型并重新核对价格页 |
退避只适合短时限制。若 RPD 已耗尽，循环重试只会制造更多失败日志。需要进一步排查请求错误时，可以转到 Gemini API 429、400 与 500 排障指南。
免费层的数据代价
免费不仅是价格选择，也是数据条款选择。根据 Google 的附加条款，非付费服务中的输入和生成回答可能用于提供、改进和开发 Google 产品，并可能由人工审核员处理。Google 明确提醒不要向非付费服务提交敏感、机密或个人信息。
因此，下面这些任务不适合因为“还有额度”就继续留在免费层：客户合同、未公开代码、医疗或财务资料、带身份信息的客服记录，以及任何组织规定不得用于模型改进的数据。付费服务的提示和回答不用于改进 Google 产品，但仍应按组织的安全、留存与合规要求评估。
什么时候开通结算
免费层最适合失败成本低、流量低且能排队的任务。出现以下任一情况时，付费层通常比继续调参更合理：
- 真实用户会因限额或容量波动直接受影响；
- 输入包含不适合非付费数据条款的内容；
- 目标用户位于条款要求使用付费服务的地区；
- 团队需要明确的成本控制、项目隔离和更高层级限额；
- 为躲避免费上限付出的工程时间已经高于可控 API 成本。
Google 当前的 结算指南 显示，从免费层升级需要关联 Cloud Billing。当前预付路径至少要购买 10 美元付费额度。另一个常见误区是把 Google Cloud 新用户的 300 美元欢迎赠金当作 Gemini API 额度；Google 说明，2026 年 3 月 2 日之后开立的账号不能用这笔欢迎赠金支付 Gemini API 与 AI Studio 用量。
开通结算前，先确认项目、模型和支出上限。开通后也不要假设所有问题会消失：继续观察 RPM、TPM、RPD、预付余额和实际费用，才能把“能调用”变成可运营的服务。
一条足够稳妥的结论
Gemini API 免费层在 2026 年 8 月仍然真实存在，也足够完成学习、提示验证和很多低流量原型。它不是一张永久固定的额度表，更不是生产 SLA。
最可靠的做法是：先核对地区与数据边界，在官方价格页选一个当前有免费价格的模型，再到 AI Studio 读取该项目的有效限额，发出最小请求并观察真实用量。只要可靠性、隐私、最终用户地区或工程成本成为主要约束，就应把付费层当作正常的生产选择，而不是免费层失败后的临时补丁。
