如何获取 Google Gemini API 密钥（2026）：创建、测试与生产环境安全配置
要获取 Google Gemini API 密钥，请使用 Google 账号登录 Google AI Studio，接受条款，打开 API 密钥页面，然后点击“创建 API 密钥”；新用户会自动获得一个默认的 Google Cloud 项目和密钥。 创建密钥免费，多个 Gemini 模型也提供免费层级，包括 Gemini 3.8 Flash 和 Gemini 3.5 Flash-Lite。自 2026 年 5 月 28 日起，在 AI Studio 中创建的所有新密钥都是绑定到服务账号的“授权密钥”，而 Gemini API 会拒绝未设置限制的旧密钥，因此去年还能用的密钥现在可能需要更换（Google API 密钥文档，核查于 2026 年 10 月 27 日）。
本指南面向独立开发者和小型团队，帮助你在几分钟内用上 Gemini 密钥，并安全地投入生产环境。内容涵盖操作步骤、新密钥类型、免费层级、使用 curl、Python 和 Node.js 发起首次请求、常见错误，以及生产环境检查清单。如果你正在比较成本，我们的 Gemini API 定价指南提供了完整价目表。
分步获取 Gemini API 密钥
- 打开 Google AI Studio。 前往 aistudio.google.com/apikey，使用你希望用于结算或拥有该项目的 Google 账号登录。
- 接受条款。 如果你是新用户，接受服务条款后，AI Studio 会创建一个默认的 Google Cloud 项目和 API 密钥。之后可以在项目视图中重命名项目。
- 选择或导入项目。 如果你已经在使用 Google Cloud，AI Studio 不会创建默认项目。打开“控制台 → 项目 → 导入项目”，选择所需的 Cloud 项目。
- 创建密钥。 在 API 密钥页面，点击创建 API 密钥并选择项目。新密钥默认为授权密钥。
- 复制密钥并立即保存。 直接存入环境变量或密钥管理服务，不要放在代码仓库中的文件里。
- 设置限制。 如果密钥只用于调用 Gemini，请将其限制为仅可访问 Gemini API（Generative Language API）。如果从固定服务器使用，请在 Google Cloud 控制台中添加 IP 限制。
- 测试密钥，使用下方任一请求即可。
以上步骤依据 Google AI for Developers 的使用 Gemini API 密钥文档，该文档最后更新于 2026 年 10 月 27 日。
之后在哪里可以找到我的 Google API 密钥？
在 Google AI Studio 中，打开控制台 → API 密钥。AI Studio 最多显示 100 个密钥和 50 个项目，且仅列出未设置限制或限制为仅可访问 Gemini API 的密钥。限制为仅可访问其他 Google API 的密钥，只会显示在 Google Cloud 控制台的凭据页面。如果找不到某个项目，请先将其导入。
标准密钥与授权密钥：2026 年有哪些变化
Google 正在将 Gemini API 从标准 API 密钥迁移到授权（auth）密钥。根据官方文档（2026 年 10 月 27 日）：
| 标准 API 密钥 | 授权密钥 | |
|---|---|---|
| 绑定对象 | Google Cloud 项目，用于结算和配额管理 | Google Cloud 服务账号 |
| 是否标识调用方 | 否 | 是，请求以绑定的服务账号身份执行 |
| 默认访问范围 | 取决于你添加的限制 | 默认限制为仅可访问 Gemini API |
| 密钥泄露处理 | 手动处理 | Google 检测到密钥泄露后，会迅速采取措施阻止其继续使用 |
| AI Studio 创建时间 | 2026 年 5 月 28 日之前 | 自 2026 年 5 月 28 日起 |
| 是否仍可使用？ | 仅在显式设置限制后可用 | 是 |
这些变化对实际使用的影响：
- 未设置限制的标准密钥会被拒绝。 如果旧密钥没有 API 限制，Gemini 请求会失败。可在 AI Studio 中修复：将鼠标悬停在密钥的警告标签上，选择限制为仅可访问 Gemini API。你需要拥有
apikeys.keys.update权限。 - 长期闲置且未设置限制的密钥会被封禁。 自 2026 年 5 月 7 日起，长时间未使用、且未设置限制的密钥会显示已封禁标签。请创建新密钥，并让应用切换到新密钥。
- 新密钥前缀。 有开发者反馈，新的授权密钥不再以熟悉的
AIza为前缀（相关说明示例）。如果第三方工具根据前缀校验密钥，可能会拒绝有效的新密钥。应更新工具，而不是退回使用标准密钥。 - 创建密钥所需的权限。 如果“创建”按钮提示权限不足，你的 Cloud 管理员需要为你授予包含
apikeys.keys.create、serviceusage.services.enable、iam.serviceAccounts.create和iam.serviceAccountApiKeyBindings.create等权限的角色。如果没有管理员权限，可以创建一个不属于任何组织的新项目。
将密钥设为环境变量
Google 客户端库会自动读取 GEMINI_API_KEY 或 GOOGLE_API_KEY。如果两者都已设置，GOOGLE_API_KEY 优先，这是“新密钥没有生效”的常见原因。
# macOS / Linux (add to ~/.zshrc or ~/.bashrc, then open a new terminal)
export GEMINI_API_KEY="paste-your-key-here"
# Make sure an old key is not overriding it
unset GOOGLE_API_KEY
在 Windows 上，请在“系统属性 → 环境变量”中添加 GEMINI_API_KEY，然后打开一个新的终端。
测试 Gemini API 密钥
curl（Interactions API）
Google 当前的快速入门指南使用 Interactions 端点，并通过 x-goog-api-key 请求头传入密钥：
curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-d '{
"model": "gemini-3.8-flash",
"input": "Reply with the single word: ok"
}'
如果收到包含输出文本的 JSON 响应，说明密钥、项目和模型访问权限都正常。403 通常表示密钥被限制为仅可访问其他 API，或已被封禁；429 表示触发了速率限制（见下文）。
Python（google-genai SDK）
# pip install google-genai
from google import genai
client = genai.Client() # reads GEMINI_API_KEY from the environment
interaction = client.interactions.create(
model="gemini-3.8-flash",
input="Explain what an API key is in one sentence.",
)
print(interaction.output_text)
Node.js（@google/genai）
// npm install @google/genai
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });
const interaction = await ai.interactions.create({
model: "gemini-3.8-flash",
input: "Explain what an API key is in one sentence.",
});
console.log(interaction.output_text);
在 OpenAI SDK 中使用同一个密钥
Gemini 还提供了兼容 OpenAI 的端点。对于只接受 OpenAI 基础 URL 的工具，例如许多编程智能体和聊天应用，这种方式很实用：
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["GEMINI_API_KEY"],
base_url="https://generativelanguage.googleapis.com/v1beta/openai/",
)
resp = client.chat.completions.create(
model="gemini-3.8-flash",
messages=[{"role": "user", "content": "Say ok"}],
)
print(resp.choices[0].message.content)
如需了解如何通过统一网关配置各类工具，请参阅通过兼容 OpenAI 的路由服务使用 Gemini API。
Gemini API 密钥是免费的吗？
密钥免费，也有额度有限的免费层级。Google 的定价页面（核查于 2026 年 10 月 27 日）列出了三种方案：免费、付费和企业。免费层级为部分模型提供免费的输入和输出 token，但通过免费层级发送的内容会用于改进 Google 产品。付费层级则不会。不要通过免费层级的密钥发送客户数据。
| 模型 | 免费层级 | 付费输入 / 输出价格，每 1M token（标准） |
|---|---|---|
| Gemini 4 Argon | 不提供 | 截至 2026 年 11 月 30 日为 $2.00 / $10.00；自 2026 年 12 月 1 日起为 $4.00 / $20.00 |
| Gemini 3.8 Flash | 提供 | 截至 2026 年 12 月 31 日为 $0.75 / $3.75；自 2027 年 1 月 1 日起为 $1.50 / $7.50 |
| Gemini 3.5 Flash-Lite | 提供 | $0.30 / $2.50 |
| Gemini 3.1 Flash-Lite | 提供 | $0.25 / $1.50（文本、图像、视频） |
来源：Gemini Developer API 定价，2026 年 10 月 27 日。请留意已公布的涨价安排：如果应用会在这些日期之后继续运行，请按涨价后的费率编制预算。
如何免费使用 Gemini API
- 在 AI Studio 中创建密钥，不关联结算账号。项目会保持在免费层级。
- 使用提供免费层级的模型，例如
gemini-3.8-flash或gemini-3.5-flash-lite。Gemini 4 Argon 仅提供付费使用。 - 不要超出 AI Studio 中显示的免费层级速率限制。限制按项目计算，而不是按密钥计算，因此在同一项目中创建更多密钥并不会增加配额。
- 仅使用测试数据或公开数据，因为免费层级的内容可能用于改进 Google 产品。
速率限制与层级
Gemini 的速率限制按每分钟请求数（RPM）、每分钟输入 token 数（TPM）和每日请求数（RPD）衡量。超出其中任一限制都会返回错误，RPD 在太平洋时间午夜重置（速率限制，2026 年 10 月 27 日）。Google 还会在滚动的 10 分钟窗口内实施基于消费金额的限制，触发后返回 429 RESOURCE_EXHAUSTED。
| 层级 | 达到条件 | 结算层级上限 |
|---|---|---|
| 免费 | 活跃项目或免费试用 | 不适用 |
| 层级 1 | 关联有效的结算账号 | $250 |
| 层级 2 | 已支付 $100，且距首次成功付款已满 3 天 | $2,000 |
| 层级 3 | 已支付 $1,000，且距首次成功付款已满 30 天 | $20,000 至 $100,000+ |
来源：Gemini API 速率限制，2026 年 10 月 27 日。请在 AI Studio 中查看各模型的具体限制；Google 表示，所列限制并非保证值。
别人拿到你的 API 密钥后能做什么？
任何持有 Gemini 密钥的人都可以发送请求，费用计入你的项目，同时消耗你的配额。Google 文档提醒，密钥泄露可能造成“意外的账单费用”，并导致项目中的私有数据被访问。如果泄露的是授权密钥，攻击者会以绑定的服务账号身份操作，可以访问该账号有权访问的所有资源（Google Cloud API 密钥最佳实践）。因此，你应将服务账号的权限控制在最低必要范围内。
如果怀疑密钥已泄露：
- 在 AI Studio 中创建替代密钥。
- 将新密钥部署到应用中，并确认其正常工作。
- 在 Cloud 控制台中停用旧密钥。不要在新密钥上线前删除旧密钥，否则会造成服务中断。
- 在 Cloud 控制台中检查结算和 API 使用情况，查找不明流量。AI Studio 的“使用情况”页面会将无法匹配到具名密钥的流量归为“（未知密钥）”。
故障排查：为什么 Gemini API 密钥无法使用
| 现象 | 可能原因 | 解决方法 |
|---|---|---|
使用旧密钥时返回 403 或“API 密钥无效” |
标准密钥未设置限制，现已被拒绝 | 将其限制为仅可访问 Gemini API，或创建新的授权密钥 |
| 密钥在 AI Studio 中显示为已封禁 | 长期闲置且未设置限制，自 2026 年 5 月 7 日起被封禁 | 创建新密钥并更新应用 |
| 代码未使用新密钥 | 同时设置了 GOOGLE_API_KEY，且其优先级更高 |
取消设置该变量，或将其设为新密钥 |
| 第三方工具提示密钥格式错误 | 工具要求使用旧前缀 | 更新工具，或通过兼容 OpenAI 的网关转发请求 |
| “你没有创建密钥的权限” | 缺少 Cloud 项目中的 IAM 权限 | 联系管理员，或使用组织之外的项目 |
429 RESOURCE_EXHAUSTED |
达到了 RPM、TPM、RPD 或基于消费金额的限制 | 退避重试、缩小请求规模，或提升层级 |
| 找不到模型或模型不可用 | 模型不提供免费层级（例如 Gemini 4 Argon） | 关联结算账号，或选择提供免费层级的模型 |
关于跨提供商的错误处理方式，请参阅我们的 LLM 网关错误分类指南。
Gemini API 密钥生产环境检查清单
密钥在 notebook 中能用，并不意味着已经可以面向用户上线。上线前请检查：
- 将密钥保存在服务端。 绝不要将其打包进 Web 或移动应用；Google 表示，客户端代码中的密钥可以被提取。在客户端与 Gemini 之间部署一个轻量的后端代理。
- 每个环境、每个应用分别使用独立密钥。 将开发、预发布和生产环境的密钥分开，这样就能单独撤销某个密钥，而不影响其他环境。为密钥起清晰的名称。
- 存入密钥管理服务。 Google 建议在生产环境中使用 Secret Manager。在运行时加载密钥。
- 设置 API 限制，并尽可能添加 IP 限制。 授权密钥默认仅可访问 Gemini；对于固定后端，请添加 IP 限制。
- 将服务账号权限降至最低。 不要向绑定的服务账号授予其不需要的宽泛角色。
- 开启结算提醒，在 Google Cloud 控制台中设置，让你在收到账单之前就能发现费用激增。
- 固定模型 ID。 在配置中使用
gemini-3.8-flash这样的精确 ID，并提前应对 2026 年 12 月 1 日和 2027 年 1 月 1 日的价格调整。 - 处理用户数据时使用付费层级。 免费层级的内容可能用于改进 Google 产品。
- 规划限流处理。 对
429添加指数退避，并决定触及限制时的处理方式：排队、降级到更小的模型，或进行故障切换。 - 扫描仓库，查找泄露的密钥。 启用 GitHub 密钥扫描和推送保护。
- 定期轮换密钥。 创建新密钥、部署、验证，然后停用旧密钥。
如需更深入的检查，请使用我们的 Gemini API 生产就绪检查清单和 API 密钥安全管理指南。
什么时候用一个 Flatkey 密钥更省事
如果应用还调用 Claude、GPT、DeepSeek 或 Qwen，为每家提供商分别管理密钥、结算账号和速率限制层级会增加工作量。Flatkey 提供一个兼容 OpenAI 的密钥和基础 URL（https://router.flatkey.ai/v1），即可访问 Gemini 及其他模型，并支持按密钥查看使用日志（Flatkey 文档）。价格上的取舍需要如实评估，因为不同模型的情况不同。2026 年 10 月 27 日，Flatkey 模型页面列出的价格如下：
| 模型 | Google 标价（标准） | Flatkey |
|---|---|---|
| Gemini 4 Argon | $2.00 / $10.00 | $1.60 / $8.00 |
| Gemini 3.5 Flash-Lite | $0.30 / $2.50 | $0.24 / $2.00 |
| Gemini 3.8 Flash | $0.75 / $3.75（优惠截至 2026 年 12 月 31 日） | $1.20 / $6.00 |
对于 Gemini 3.8 Flash，Google 的优惠价格在 2026 年 12 月 31 日之前低于 Flatkey，因此只使用 Flash 的应用在此之前直接调用 Google 更便宜。对于使用 Argon、Flash-Lite 或混合使用多家提供商的应用，Flatkey 更有吸引力。
from openai import OpenAI
import os
client = OpenAI(api_key=os.environ["FLATKEY_API_KEY"], base_url="https://router.flatkey.ai/v1")
resp = client.chat.completions.create(
model="gemini-4-argon",
messages=[{"role": "user", "content": "Summarize this stack trace in one line."}],
)
print(resp.choices[0].message.content)
常见问题
如何获取 Google Gemini API 密钥？
登录 aistudio.google.com/apikey，接受条款，选择或导入 Google Cloud 项目，然后点击“创建 API 密钥”。新用户会自动获得默认项目和密钥。密钥会显示在 AI Studio 的 API 密钥页面中。
Gemini API 密钥是免费的吗？
是的。创建密钥不收费，Gemini 3.8 Flash 和 Gemini 3.5 Flash-Lite 等模型提供有速率限制的免费层级。免费层级的内容可能用于改进 Google 产品，而 Gemini 4 Argon 不提供免费使用。
如何免费使用 Gemini API？
创建密钥时不关联结算账号，调用 gemini-3.8-flash 等提供免费层级的模型，并将用量控制在 AI Studio 显示的限制内。限制按项目计算，因此同一项目中增加密钥不会增加配额。
在哪里可以找到我的 Google API 密钥？
在 Google AI Studio 的“控制台 → API 密钥”中。限制为仅可访问 Gemini 以外的 Google API 的密钥，只会列在 Google Cloud 控制台的凭据页面中。
别人拿到我的 API 密钥后能做什么？
他们可以发送请求，费用计入你的项目，消耗你的配额；如果持有的是授权密钥，还可以以绑定的服务账号身份操作。如果怀疑发生泄露，请更换密钥、部署新密钥、停用旧密钥，并检查使用情况。
为什么我的旧 Gemini API 密钥无法使用了？
自 2026 年起，Gemini API 会拒绝未设置限制的标准密钥；自 2026 年 5 月 7 日起，还会封禁长期闲置且未设置限制的密钥。请将密钥限制为仅可访问 Gemini API，或创建新的授权密钥。
可以在 OpenAI SDK 中使用 Gemini API 密钥吗？
可以。将基础 URL 设为 https://generativelanguage.googleapis.com/v1beta/openai/，并将 Gemini 密钥作为 API 密钥传入。
总结
在 AI Studio 中获取 Gemini 密钥只需两分钟；要保障密钥安全，还需要多做一些配置。请使用授权密钥，通过密钥管理服务将其保存在服务端，设置访问限制和结算提醒，用付费层级处理真实用户数据，并留意已公布的价格调整。如果你使用多家提供商，一个网关密钥就能替代多套提供商密钥。可在 Flatkey 模型目录中比较模型，并参阅 Gemini 与 Claude 路由指南，了解何时应将流量发送给哪一方。
