Gemini API Key 怎么获取？Google AI Studio 免费申请步骤、auth key 与安全设置（2026）

推荐链接（推广）：数字严选2026/10/25大约 5 分钟GeminiGemini API KeyGemini APIGoogle AI StudioAPI Key

一句话结论

Gemini API Key 在 Google AI Studio 里创建，不收费。 新用户第一次打开 AI Studio、接受服务条款后，会自动生成一个默认 Google Cloud 项目和一把 API key；之后在 AI Studio 的 API Keys 页面点「Create API key」即可再建。2026-05-28 起，AI Studio 新建的 key 都是更安全的 auth key（授权 key）；不受限的旧式标准 key 会被 Gemini API 拒绝。

阅读说明

官方信息查阅日期：2026-10-25。来源：Gemini API 官方文档 Using Gemini API keys（页面标注 2026-10-06 更新）等，见文末。
创建 key 不收费；调用是否收费取决于免费层还是付费层，见 Gemini API 免费吗。
Google AI Studio 和 Gemini API 有地区限制：官方列表有台湾，没有中国大陆、香港和澳门，见 Gemini 支持哪些国家和地区。本站不提供任何绕过地区限制的方法。

获取步骤

用个人 Google 账号登录 Google AI Studio（https://aistudio.google.com）。官方说明 AI Studio 只对 18 岁以上用户开放；
新用户：接受服务条款后，AI Studio 会自动创建一个默认的 Google Cloud 项目和 API key，可以在 Projects 页面给项目改名；
左侧打开 Dashboard → API Keys，点 Create API key 新建；
复制 key，按下文「设置环境变量」保存，不要发给别人、不要提交到 Git。

已经有 Google Cloud 账号的情况

官方文档说明：已有 Google Cloud 账号的用户，AI Studio 不会自动建默认项目，要先导入：

在 AI Studio 打开 Dashboard → Projects；
点 Import projects；
搜索并选中要用的 Google Cloud 项目，点 Import；
回到 API Keys 页面，在这个项目下创建 key。

「Create API key」按钮是灰的

如果提示「You do not have permission to create a key in this project」，说明你在这个项目里缺少 IAM 权限。官方给的办法：

请项目或组织管理员给你一个包含以下权限的角色（例如 Project Editor）：resourcemanager.projects.get、apikeys.keys.create、serviceusage.services.enable、iam.serviceAccounts.create、iam.serviceAccountApiKeyBindings.create；
拿不到管理员权限时，新建一个不属于任何组织的 Google Cloud 项目来生成 key。

标准 key 和 auth key 有什么区别

	标准 API key（Standard）	授权 key（Authorization / auth key）
绑定对象	Google Cloud 项目（用于计费和配额）	Google Cloud 服务账号
能否识别调用者	不能	能，按服务账号身份处理请求，可做细粒度权限控制
默认限制	视设置而定	默认只能调用 Generative Language API（Gemini API）
泄露处理	—	系统发现泄露后能快速停用

官方时间线：

2026-05-07 起：长期闲置的不受限 key 会被封锁，AI Studio 里显示 Blocked 标签，要新建 key 或改用已受限的 key；
2026-05-28 起：AI Studio 里新建的 key 默认都是 auth key；
不受限的标准 key 会被拒绝；已经加了明确限制的标准 key 仍可继续用。

旧 key 被拒绝怎么办

方法 A（只给 Gemini API 用）：在 AI Studio 的 API Keys 页找到带 Unrestricted 标签的 key，悬停后点 Add restrictions → Restrict to Gemini API only → Restrict key。需要项目上的 apikeys.keys.update 权限。

方法 B（换成 auth key，官方推荐的迁移）：

在 API Keys 页看 Key Type 列，找出标为 Standard 的 key；
点 Create API key 新建（新 key 自动是 auth key）；
把代码、环境变量和部署配置换成新 key，测试通过；
确认没问题后删除或撤销旧 key。

设置环境变量

官方推荐用环境变量 GEMINI_API_KEY 或 GOOGLE_API_KEY，官方 SDK 会自动读取；两个都设置时 GOOGLE_API_KEY 优先。

macOS / Linux（以 zsh 为例，bash 改成 ~/.bashrc）：

echo 'export GEMINI_API_KEY=<你的 API key>' >> ~/.zshrc
source ~/.zshrc

Windows：在系统搜索「环境变量」→ 环境变量 → 用户变量里点「新建」，变量名 GEMINI_API_KEY，值填 key，保存后重新打开终端。

验证（Python，官方示例写法）：

from google import genai

client = genai.Client()  # 自动读取 GEMINI_API_KEY
interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="Explain how AI works in a few words",
)
print(interaction.output_text)

只有在没法用环境变量时，才在代码里显式传 api_key。

安全规则（官方）

把 key 当密码：泄露后别人可以用你项目的配额、产生费用；
不要提交到 Git 等代码仓库；
不要写进网页或手机 App 的前端代码，要在后端代理里调用；
生产环境放进 Google Cloud Secret Manager 这类密钥管理工具；
在 Google Cloud 控制台设置账单提醒；
可以在 Cloud 控制台凭据页给 key 加来源限制（IP、网站或 App）。

key 泄露了怎么办

在 AI Studio 或 Cloud 控制台新建一把 key；
应用换成新 key 并上线；
新 key 确认可用后，停用并删除旧 key（官方提醒先别急着删，避免服务中断）；
在 Cloud 控制台查账单和 API 用量，排查有没有异常调用。

如果已经看到「API key was reported as leaked」，见 Gemini API 报错 403 PERMISSION_DENIED。

官方限制

AI Studio 的 Projects 页面同时最多创建 10 个项目；
API Keys 和 Projects 页面最多显示 100 个 key、50 个项目；
AI Studio 只显示不受限或只限 Gemini API 的 key，其他 key 要去 Cloud 控制台凭据页管理。

拿到 key 之后

想知道免费层能用哪些模型、付费层多少钱：Gemini API 免费吗
用 API 生成图片：Nano Banana 是什么、怎么用
遇到配额报错：Gemini API 报错 429 RESOURCE_EXHAUSTED
遇到权限报错：Gemini API 报错 403 PERMISSION_DENIED

参考来源（官方）

Gemini API · Using Gemini API keys：https://ai.google.dev/gemini-api/docs/api-key（查阅日期：2026-10-25；页面标注 2026-10-06 更新）
Gemini API · Pricing：https://ai.google.dev/gemini-api/docs/pricing（查阅日期：2026-10-25）