Gemini API 可以免费开始，但“免费”不是由一把 key 单独决定。只有实际所在地在官方支持范围内、账号和项目满足条件、目标模型或功能提供 Free Tier（免费层级），并且项目仍有可用限额时，免费调用才可能成立。Google AI Studio 提供创建或管理 API key 的入口；key 只是调用凭据，不是“免费次数包”，更不代表不限量使用。
如果你在中国大陆，先停在地区核验这一步：截至 2026 年 8 月 15 日，Google 公布的 Google AI Studio 和 Gemini API 适用区域名单中未列出中国大陆。这个事实只说明当前官方名单未列出该地区，不能据此推断网络、账号或其他情况；本文也不提供绕过方式。
如果你的实际所在地在官方支持名单中，接下来再确认四件事；任一项无法确认，都不应把“拿到 key”当作已经可以免费调用：
- 你的账号能否在 AI Studio 中关联或创建 Google Cloud 项目；
- 你准备使用的模型或功能是否标注为 Free Tier；
- 该项目当前显示的 RPM、TPM、RPD 等限额是多少；
- 密钥是否会被安全地保存在服务端，而不是暴露在网页或代码仓库中。
先拆开三个问题：密钥、免费层和项目限额
“Gemini API 免费密钥”这个说法把三种东西混到了一起：
| 你在找什么 | 它实际回答的问题 | 应查看的官方入口 |
|---|---|---|
| API key | 请求用什么凭据认证、归属哪个 Cloud 项目 | API 密钥文档 |
| Free Tier | 哪些模型或功能当前可以免费使用 | Gemini Developer API 价格表 |
| 项目限额 | 你的项目当前允许多少 RPM、TPM、RPD | 速率限制文档与 AI Studio 中的有效限额 |
API key 与 Google Cloud 项目关联。Google 的限额按项目生效，而不是按 key 生效，所以给同一个项目多建几个 key，不会得到多份免费额度。免费资格又是按模型和功能区分的：一个模型有 Free Tier，不代表所有模型、所有功能都免费。
这也是为什么网上流传的“每天固定免费多少次”不适合作为你的判断依据。限额会受模型、使用层级和项目状态影响，官方页面展示的数字也不等于容量保证。真正可用的答案应来自你自己的 AI Studio 项目页面。
第一步：核验地区，决定继续还是停止
打开官方适用区域列表，查找你的实际所在地，不要只根据浏览器语言、中文界面或搜索结果推断资格。
- 找到所在地：可以继续核验账号、项目和模型。
- 没有找到所在地：在这里停止本文后续的官方调用路径；不要把第三方教程中的成功截图当成你的官方资格证明。
- 账号由组织管理：即使地区受支持，组织权限也可能影响项目与密钥管理，需要由管理员确认。
本文没有登录任何 Google 账号，也没有查看读者的项目、结算资料或配额页面，因此不能判断某个具体账号是否合格。
第二步：在 AI Studio 创建或选择与项目关联的密钥
地区前提成立后，按照 Google 的 Gemini API 密钥指南进入 AI Studio。你可能会看到创建新项目、导入现有 Cloud 项目，或选择已有项目的不同流程；具体界面取决于账号权限和项目状态。
在继续前，至少确认：
- 密钥关联的是哪个 Google Cloud 项目；
- 你是否有权管理这个项目；
- 测试、开发和生产是否需要分开的项目与密钥管理策略；
- 页面显示的密钥类型与限制是否适合你的部署环境。
不要把真实 key 粘贴到文章、截图、聊天记录或公开仓库。Google 要求开发者把 API key 当作密码处理，优先使用环境变量或服务端密钥机制，并避免在生产客户端代码中直接暴露它。
本地开发时，环境变量名可使用官方快速入门中的：
bashexport GEMINI_API_KEY="你的密钥"
这行示例只说明变量名，不建议把真实值写进会提交到版本控制的脚本。生产环境应使用部署平台的 secret 管理能力。
第三步：逐模型确认 Free Tier，而不是猜免费次数
打开当前的 Gemini Developer API 价格表，找到你准备调用的模型，再检查对应功能是否有 Free Tier。模型可用性、价格和免费资格都会变化，所以本文不固化一个“永远免费”的模型名单。
做决定时，至少看清三类边界：
- 模型边界：免费资格属于具体模型或功能，不属于 key 本身；
- 结算边界：升级付费层需要 Cloud Billing，付款方式与流程可能因账号和地区而异；
- 数据边界：Google 当前价格页说明，Free Tier 内容可能被用于改进 Google 产品；Paid Tier 内容则描述为不用于产品改进。处理敏感数据前，还需要核对最新条款和你自己的合规义务。
如果你打算用 Google Cloud 欢迎金或免费试用金抵扣，别默认它一定适用。Google 当前的结算文档说明，2026 年 3 月之后政策下发放的 Cloud 欢迎或免费试用额度不能支付 Gemini API 或 AI Studio 用量；旧账号或特定额度可能有例外，应以自己的结算条款为准。
第四步：在项目里看实时限额
Google 使用 RPM（每分钟请求数）、TPM（每分钟 token 数）和 RPD（每天请求数）等维度限制 Gemini API。最重要的关系是：限额归项目，不归密钥。
因此，下面几种做法都不能替代项目页面的实时核验：
- 从旧教程复制一个固定次数；
- 用同一项目创建多个 key 后把次数相加；
- 只看价格表，不看速率限制；
- 把公开文档中的示例值当成自己账号的保证值。
在 AI Studio 中选择实际项目，查看当前显示的模型、层级与有效限额。如果页面与教程不同，以你当下看到的官方项目状态为准。公开文档只能解释限额维度，不能证明你的账号已经获得某个数字。
第五步：用当前官方快速入门验证首次调用
前四步都通过后，再打开 Google 的 Gemini API 快速入门，选择 Python、JavaScript 或 REST 中与你项目一致的示例。
这里不直接复制模型 ID、SDK 版本和完整请求代码，因为这些内容会变化。更稳妥的做法是：
- 从当前快速入门复制最新示例；
- 确认示例读取的是
GEMINI_API_KEY，而不是把真实 key 写进源码； - 使用价格表中已确认符合预期层级的模型；
- 发出最小测试请求，并记录返回的成功结果或错误类型；
- 回到 AI Studio 查看项目用量与限额变化。
如果请求失败，不要第一时间重建多个 key。先按顺序检查地区资格、项目关联、模型名称、Free Tier 资格、项目限额和账号权限。只有真实项目页面和实际响应，才能证明你的账号完成了首次调用；本文没有替你执行这一步。
一分钟判断清单
准备开始前，用下面六个问题做最后核对：
- 我的实际所在地在当前官方支持地区名单里吗？
- 这个 key 关联的是我确认过的 Cloud 项目吗？
- 目标模型和功能当前明确标注了 Free Tier 吗？
- 我查看的是该项目在 AI Studio 中的实时限额吗？
- key 是否只保存在环境变量或服务端 secret 中？
- 我是否接受当前免费层的数据使用边界，并知道何时需要付费层？
六项都能回答后，再按当前官方快速入门发出最小请求。只要其中任何一项仍是“不知道”，就先回到对应官方页面核验；这比寻找一个所谓“永久免费 key”更快，也更不容易在额度、安全或地区边界上踩坑。
