← 免费学 AI

如何获取免费的 Gemini API 密钥

如何获取免费的 Gemini API 密钥

耗时 5 分钟 你需要 Google 账号 · 年满 18 岁 · 所在国家/地区可使用 Google AI Studio 最后检查:2026 年 10 月 20 日

Google 的 Gemini Developer API 有免费层级:在 Google AI Studio 中创建密钥,无需添加结算信息即可调用 Flash 模型、Gemini 2.5 Pro 和 Gemma 4。本指南涵盖设置、免费层级包含的内容,以及继续使用免费层级所接受的取舍。

可获得内容

  • Google 列为有免费层级的每个模型均提供免费输入和输出 token,包括 gemini-3.8-flash、gemini-3.6-flash、gemini-3.5-flash-lite、gemini-3.1-flash-lite、gemini-3-flash-preview、gemini-2.5-pro、gemini-2.5-flash、gemini-2.5-flash-lite、Gemma 4、gemini-embedding-2,以及若干 Live、Transcribe 和 TTS 模型。较旧模型如 Gemini 3.5 Flash、3.7 Flash 和 2.0 Flash 已不在定价页上。
  • 按模型计量的速率限制,单位为每分钟请求数(RPM)、每分钟输入 token 数(TPM)和每天请求数(RPD)。Google 不公布固定的免费层级表格;你的当前限制显示在 AI Studio 中。每日限制在太平洋时间午夜重置。
  • 在 gemini-2.5-flash 和 gemini-2.5-flash-lite 上,Google Search grounding 每天最多免费 500 次请求(两者共享)。Gemini 2.5 Pro 或任何 Gemini 3 及更新模型的免费层级不提供 grounding;这些模型上的“每月 5,000 次免费搜索请求”仅适用于付费层级。
  • 无需信用卡,且无到期日。完整详情见 [Gemini Developer API 免费层级](/offer/google-gemini-developer-api-free-tier/) 页面。

步骤

  • 前往 aistudio.google.com 的 Google AI Studio,并用 Google 账号登录。你必须年满 18 岁,且所在国家/地区受支持。
  • 接受服务条款。对于新用户,AI Studio 会自动创建默认 Google Cloud 项目和 API 密钥。
  • 打开 API Keys 页面(aistudio.google.com/apikey)。如需新密钥,点击 Create API key。如果你已使用 Google Cloud,请先在 Dashboard > Projects > Import projects 下导入项目。
  • 复制密钥并保存为环境变量,例如在 ~/.zshrc 或 ~/.bashrc 中 export GEMINI_API_KEY=your_key。官方 SDK 会读取 GEMINI_API_KEY 或 GOOGLE_API_KEY(两者都设置时后者优先)。
  • 安装 Google Gen AI SDK(pip install google-genai),并向免费模型(如 gemini-2.5-flash 或 gemini-3.8-flash)发送测试提示。
  • 在构建任何依赖调用量的东西之前,先在 AI Studio 中检查当前限制。切勿将密钥提交到代码仓库,或将其放入客户端代码中发布。

限制与代价

  • 你的数据会被使用。Google 定价页将免费层级内容标记为“用于改进我们的产品”,API 条款称人工审核员可能阅读并标注免费层级的输入和输出。不要发送敏感、机密或个人信息。付费层级内容不会这样使用。
  • 并非所有模型都免费。Gemini 4 Argon、gemini-3.1-pro-preview、Gemini Omni Flash 模型、图像模型(Nano Banana 和 Flash Image 模型)、Veo、Lyria 和 gemini-2.5-pro-preview-tts 没有免费层级。
  • 地区规则。Gemini API 条款对欧洲经济区(EEA)、瑞士和英国有具体规则,包括在向 EEA 用户提供应用时只能使用付费服务。如果你面向当地用户发布,请阅读条款。
  • 升级需要付费。离开免费层级意味着要在 AI Studio 中设置结算,并预充至少 5 美元额度。

如果不起作用

  • 429 或速率限制错误:你触发了 RPM、TPM 或 RPD 限制。降低速度、加入带退避的重试,或等待太平洋时间午夜每日重置。
  • “You do not have permission to create a key in this project”:向项目管理员申请 Project Editor 等角色,或创建一个不绑定组织的新 Cloud 项目。
  • 你的密钥未出现在 AI Studio:导入包含这些密钥的 Cloud 项目。
  • 密钥被拒绝:API 会拒绝无限制的标准密钥。在 AI Studio 中,找到标为 Unrestricted 的密钥,点击 Add restrictions,选择 Restrict to Gemini API only,然后点击 Restrict key。长期未使用的无限制密钥可能显示 Blocked 标签;请改为创建新密钥。
  • AI Studio 打不开:通常是地区限制、18+ 年龄要求或账号验证。
  • 免费密钥调用模型失败:检查该模型是否在定价页中列为有免费层级。

本指南中的优惠

  • [Google Gemini Developer API 免费层级](/offer/google-gemini-developer-api-free-tier/) · 免费层级 · 无需信用卡 免费 Gemini API 层级,可速率受限地访问 Flash 模型和 Gemini 2.5 Pro

了解它

几分钟跟练,无需注册。

  • [为什么免费的是 mini 或 flash 模型?](/explain/distillation/) · 知识蒸馏(教师和学生模型) · 5 分钟
  • [为什么它忘了我 20 条消息前说的话?](/explain/context-window/) · 上下文窗口 · 3 分钟

常见问题

Gemini API 真的免费吗?是的,对 Google 列出免费层级的模型免费,例如 Gemini 2.5 Pro、Gemini 2.5 Flash 和 Gemini 3.8 Flash。使用量受按模型速率限制约束,且无需信用卡。

Google 会使用我的免费层级提示吗?会。Google 定价页称免费层级内容用于改进其产品,条款称人工审核员可能阅读输入和输出。付费层级内容不会这样使用。

免费层级的具体速率限制是多少?它们因模型而异,并显示在你项目的 Google AI Studio 中。限制包括每分钟请求数、每分钟输入 token 数和每天请求数;每日限制在太平洋时间午夜重置。

我可以免费使用 Gemini 3.1 Pro 或图像生成吗?不能。Gemini

本文提到的免费福利

Google Gemini Developer API Free Tier — 免费 Gemini API 层级:可访问受速率限制的 Flash 模型和 Gemini 2.5 Pro

相关官方链接

译自 aifree.dev 指南栏目 · 具体政策以厂商官网为准