# Google AI Studio API Key 怎么创建：先确认地区，再完成首个请求

> Gemini API Key 在 AI Studio 免费创建；免费层可调用 Gemini 3.8 Flash 等模型，图片模型和 3.1 Pro 需先关联结算账号。

- URL: https://blog.laozhang.ai/zh/posts/google-ai-studio-api-key
- Published: 2026-08-29
- Updated: 2026-10-08
- Author: LaoZhang AI Team (https://blog.laozhang.ai/zh/about)
- Topic: API 接入指南
- Tags: Google AI Studio, Gemini API, API Key, Google Cloud, API 安全

---
Google AI Studio API Key，也就是 Gemini API Key，是调用 Gemini Developer API 的凭据。它本身不收费，也不需要购买；它不是付费套餐，不附带一份独立额度，也不能替代地区、年龄、项目权限或账单条件。会不会产生费用，取决于 Key 所属的 Cloud 项目有没有关联结算账号，以及你调用的是哪个模型。

截至 2026 年 10 月 8 日，Google 文档里有两处变化直接影响新手：AI Studio 从 2026 年 5 月 28 日起新建的 Key 都是 auth key，Gemini API 会拒绝未加限制的 standard key；免费层可以调用 Gemini 3.8 Flash、2.5 Pro 等模型，但所有图片生成模型和 Gemini 3.1 Pro Preview 都不在免费层。

对中国大陆读者来说，第一步不是找“隐藏入口”或购买别人生成的 Key，而是查看 Google 当前的 [AI Studio 与 Gemini API 可用地区](https://ai.google.dev/gemini-api/docs/available-regions)。截至 2026 年 10 月 8 日，这份官方列表里没有中国大陆，也没有香港；页面同时写明 18 岁以上和年龄验证要求。如果不符合官方直连接入条件，应在这里停止，不使用虚假地区、账单地址、他人身份或来路不明的 Google Key 绕过。

如果你在官方支持地区实际使用、账号也符合条款，下面这条路径能把“拿到一串字符”变成可管理、可验证的接入。

## Gemini API Key 怎么获取，需要购买吗

不需要购买。Gemini API Key 在 [Google AI Studio API Keys 页面](https://aistudio.google.com/api-keys)免费创建，获取方式分两种情况：

1. 新用户用 Google 账号登录 AI Studio 并接受服务条款后，AI Studio 会自动建立一个默认 Cloud 项目和一枚 API Key，在 API Keys 页面直接复制即可。
2. 已经有 Google Cloud 项目的用户，先把目标项目导入 AI Studio，再在 API Keys 页面点 **Create API key**。

想“购买 Gemini API Key”时，真正要买的通常是更多用量或免费层没有的模型。做法是在 AI Studio 里为 Key 所在的项目设置并关联结算账号，项目升到 Tier 1 后按模型价格计费，原来的 Key 照常使用，不用换。第三方出售的 Key 是别人项目里的凭据，用量、账单和撤销权都在对方手里，泄漏后随时可能失效。中国大陆读者的付费与凭据选择，见 [Gemini API Key 购买前先看：中国大陆的地区、付费与凭据路线](https://blog.laozhang.ai/zh/posts/gemini-api-pricing)。

## 先确定 Key 归谁，而不是先复制

每枚 Gemini API Key 都属于一个 Google Cloud 项目。项目承载成员、权限、用量与账单关系；Key 只是请求携带的秘密凭据。

打开 API Keys 页面时，使用真正应该管理该项目的账号登录。个人实验可以使用 AI Studio 自动建立的默认项目；团队或公司接入应先确定组织账号、项目管理员、账单负责人和轮换责任，避免把生产 Key 留在离职后无人控制的个人账号中。

Google 当前的 [Gemini API Key 文档](https://ai.google.dev/gemini-api/docs/api-key)区分了两类常见状态：

- 新用户接受条款后，AI Studio 自动建立默认 Cloud 项目和 API Key；
- 已有 Google Cloud 项目的用户，需要在 **Dashboard → Projects** 导入目标项目，再到 API Keys 页面创建 Key。

创建前记下项目 ID。它比展示名称更适合以后核对账单、限额、日志和部署环境。若 **Create API key** 不可用并提示没有权限，问题属于项目导入或身份与访问管理（IAM），不是多点几次按钮就会恢复。Google 文档列出的创建权限有五项：`resourcemanager.projects.get`、`apikeys.keys.create`、`serviceusage.services.enable`、`iam.serviceAccounts.create` 和 `iam.serviceAccountApiKeyBindings.create`，缺哪项就请项目管理员补哪项。

## 新建密钥要看类型与迁移要求

从 2026 年 5 月 28 日起，AI Studio 新建的 Key 一律是 authorization key（auth key）。它直接绑定到一个 Google Cloud 服务账号，默认只能调用 Gemini API，Key 泄漏后 Google 的封禁处理也更快。

旧的 standard key 分两种情况：

- 未加任何限制的 standard key：Gemini API 直接拒绝它发来的请求；另外从 2026 年 5 月 7 日起，长期闲置的无限制 Key 也会被阻止。
- 已经设置了明确限制的 standard key：目前仍可使用。

所以从旧视频、旧教程或旧项目里拿到的 Key 请求被拒，先看 AI Studio 列表里的 **Key Type** 列。与其继续折腾无限制的旧 Key，不如在同一项目里新建一枚 auth key 替换；暂时不能换的，就给旧 Key 加上明确限制。无论哪种状态，都不要在客户端分发 standard 或 blocked 的 Key。

![从地区资格、项目归属和当前 Auth Key 创建，到后端保存、最小请求与失败边界的操作图](https://blog.laozhang.ai/posts/zh/google-ai-studio-api-key/img/setup-and-canary.webp)

*图中“2026 年 9 月拒绝 standard key”和 `gemini-3.7-flash` 示例早于 2026 年 10 月 8 日的更新，以正文为准。*

## 把密钥放进环境，不放进仓库和浏览器

密钥应像密码一样处理。泄漏者可以消耗项目额度，启用付费后还可能造成意外账单。以下位置都不安全：

- Git 仓库、示例代码和提交历史；
- 前端 JavaScript、浏览器扩展或移动 App 包；
- issue、聊天截图、终端录屏和完整环境变量导出；
- 带 `?key=` 的公开 URL、分析日志或错误上报。

本地开发时，Google SDK 能读取 `GEMINI_API_KEY` 或 `GOOGLE_API_KEY`。两者同时存在时，`GOOGLE_API_KEY` 优先；“明明换了 Key 但请求没变”经常由这个优先级造成。

```bash
export GEMINI_API_KEY="YOUR_API_KEY"
```

示例里的值只是占位符。真实服务应在后端读取密钥管理服务中保存的值，让浏览器调用自己的后端，而不是直接获得长期 Key。你可以只检查变量是否存在，不打印内容：

```bash
if [ -n "${GEMINI_API_KEY:-}" ]; then
  echo "GEMINI_API_KEY 已设置"
else
  echo "GEMINI_API_KEY 未设置"
fi
```

如果 Key 已经进了公开仓库或截图，删掉那次提交并不能让它重新安全。应在 API Keys 页面删除这枚 Key，新建一枚替换部署环境里的值，再查看项目近期的用量和账单有没有异常调用。

## 按官方快速入门完成一次小型请求

Google 当前的 [Gemini API 快速开始](https://ai.google.dev/gemini-api/docs/get-started)使用 Interactions 接口和 `gemini-3.8-flash`。截至 2026 年 10 月 8 日，Gemini 3.8 Flash 在免费层可用，所以还没关联结算账号的项目也能用它做这次验证。下面的请求把 Key 放在请求头中，不把它写进 URL：

```bash
curl -sS -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-3.8-flash",
    "input": "请用一句短句确认连接成功。"
  }'
```

成功标志不是模型必须返回某句固定文案，而是请求到达预期主机，使用目标项目的凭据通过鉴权，并返回带完成状态和模型输出的结构化对象。模型 ID 与 API 接口会变化；若官方快速入门已更新，就同步修改验证请求，不从旧博客猜名称。不要拿图片模型或 Gemini 3.1 Pro Preview 做第一次验证：它们在免费层不可用，失败了也分不清是 Key 的问题还是层级的问题。

## 失败时只保留能诊断的证据

一次同时更换密钥、项目、接口地址和模型，会让原始问题消失在变量里。先保存这些信息：HTTP 状态、脱敏后的错误正文、项目 ID、主机名、模型、UTC 时间和请求 ID；绝不保存完整 Key。

| 可观察结果 | 应查的责任边界 | 最小下一步 |
|---|---|---|
| 还没进入 Key 页面就被拦截 | 地区、年龄、账号验证、组织策略 | 复核官方地区与账号提示；不符合官方直连条件就停止 |
| 创建按钮不可用 | 项目导入与 IAM | 核对项目 ID，让管理员补上五项创建权限中缺的那项 |
| 从旧教程或旧项目拿到的 Key 被拒 | 未加限制的 standard key，或长期闲置被阻止 | 查看 Key Type，在同一项目新建 auth key 替换 |
| `403 PERMISSION_DENIED` | 实际生效的 Key、项目、限制或调用动作 | 固定配置，按 [Gemini API Key 403 排障](https://blog.laozhang.ai/zh/posts/gemini-api-key-permission-denied)检查 |
| 免费层项目调用图片模型或 3.1 Pro Preview 失败 | 该模型不在免费层 | 关联结算账号后再试；图片模型的报错见 [Gemini 图片生成 429 速率限制](https://blog.laozhang.ai/zh/posts/gemini-image-429-rate-limit) |
| `429 RESOURCE_EXHAUSTED` | 该项目、模型和用量层级的实际限额 | 到 AI Studio 查看实际限额，再用 [Gemini API 速率限制指南](https://blog.laozhang.ai/zh/posts/gemini-api-rate-limits-guide)诊断 |
| 模型或接口路径不存在 | 当前模型 ID 与 API 版本 | 按官方快速入门核对模型和接口，修正配置后再试 |
| 暂时性服务端错误 | 服务状态和重试策略 | 有上限的指数退避，不创建新 Key |

这张表也说明：Key 能用不等于容量够，项目付费不等于正在使用正确 Key，AI Studio 能看到某模型也不等于同一 API 接口可以免费调用。

![API Key 上线前的项目负责人、密钥类型、秘密信息保存、诊断记录、实际限额、账单与轮换检查图](https://blog.laozhang.ai/posts/zh/google-ai-studio-api-key/img/operations-and-guardrails.webp)

*图中“standard key 将在 2026 年 9 月被拒绝”和 `gemini-3.7-flash` 示例早于 2026 年 10 月 8 日的更新，以正文为准。*

## 最后再判断免费层和付费层

创建 Key 不收“Key 费用”，费用只来自调用：项目在免费层时只能用免费层开放的模型，关联结算后按模型价格计费。截至 2026 年 10 月 8 日，Google [Gemini API 价格页](https://ai.google.dev/gemini-api/docs/pricing)的免费层情况如下：

- **免费层可调用**：Gemini 3.8 Flash、3.7 Flash、3.6 Flash、3.5 Flash、3.5 Flash-Lite、3.1 Flash-Lite、3 Flash Preview、2.5 Pro、2.5 Flash、2.5 Flash-Lite，Live 实时、转写与翻译模型，多款 TTS 模型，以及 Gemma 4。
- **免费层不可用**：Gemini 3.1 Pro Preview、Gemini Omni Flash，全部图片生成模型（Nano Banana 2.1、Nano Banana 2、Nano Banana Pro、Gemini 2.5 Flash Image 等），以及 Batch、Flex 和“使用 Google 搜索建立依据”。
- **数据用途**：免费层的内容会被用于改进 Google 的产品，付费层不会。处理客户数据或敏感内容时，这一条往往比额度更早决定要不要付费。

图片生成在 API 里没有免费额度，各图片模型的价格见 [Gemini 图片生成 API 免费吗：已无免费层，标准价最低每张 $0.0336](https://blog.laozhang.ai/zh/posts/gemini-image-api-free)。

### Gemini API Key 免费额度在哪看

Google 没有公开按模型列出的免费层 RPM、TPM、RPD 表，当前限额要在 AI Studio 的[速率限制页面](https://aistudio.google.com/rate-limit)查看，按项目和模型分别显示。限额按项目计算，同一项目多建几枚 Key 不会多出一份免费额度，所有 Key 共用一个池子。各模型的免费资格和限额怎么读，见 [Gemini API Key 免费额度与速率限制 2026：哪些还免费、去哪看限额](https://blog.laozhang.ai/zh/posts/gemini-api-free-tier)。

### 从免费层升到付费层要满足什么

Google [Gemini API 速率限制文档](https://ai.google.dev/gemini-api/docs/rate-limits)里的用量层级如下，可在 AI Studio 的 Projects 页面查看项目当前所在层级：

| 层级 | 进入条件 | 每月花费上限 | 每 10 分钟花费上限 |
|---|---|---|---|
| Free | 有效项目或免费试用 | 不适用 | — |
| Tier 1 | 在 AI Studio 设置并关联有效结算账号 | $250 | $10 |
| Tier 2 | 已付费 $100，且距首次成功付款满 3 天 | $2,000 | $50 |
| Tier 3 | 已付费 $1,000，且满 30 天 | $20,000 至 $100,000 以上 | $200 |

从 Free 升到 Tier 1 通常立即生效，之后的升级在 10 分钟内生效；Key 不用重新创建。付费价格以模型为准，例如 Gemini 3.8 Flash 每 100 万输入 token $0.75、输出 $3.75，这个价格持续到 2026 年 12 月 31 日，2027 年 1 月 1 日起为 $1.50 和 $7.50。

首个请求成功后，再根据真实工作负载决定是否关联结算账号、是否采用预付费（Prepay），以及选择哪种模型。价格和账单的完整判断见 [Gemini API Key 购买前先看：中国大陆的地区、付费与凭据路线](https://blog.laozhang.ai/zh/posts/gemini-api-pricing)，并在使用当天核对 Google 的[实时价格页](https://ai.google.dev/gemini-api/docs/pricing)。

准备投入服务前，至少记录项目 ID、凭据负责人、密钥类型、密钥保存位置、轮换负责人、允许调用的后端、当前模型、AI Studio 实际限额与结算状态。这样即使人员、模型或额度变化，也能知道应该撤销哪枚 Key、检查哪个项目，而不是重新到处“找 Key”。

## 参考来源

本文引用的外部页面，按正文出现顺序排列。最后更新于 2026-10-08。

- [AI Studio 与 Gemini API 可用地区](https://ai.google.dev/gemini-api/docs/available-regions) (ai.google.dev)
- [Google AI Studio API Keys 页面](https://aistudio.google.com/api-keys) (aistudio.google.com)
- [Gemini API Key 文档](https://ai.google.dev/gemini-api/docs/api-key) (ai.google.dev)
- [Gemini API 快速开始](https://ai.google.dev/gemini-api/docs/get-started) (ai.google.dev)
- [Gemini API 价格页](https://ai.google.dev/gemini-api/docs/pricing) (ai.google.dev)
- [速率限制页面](https://aistudio.google.com/rate-limit) (aistudio.google.com)
- [Gemini API 速率限制文档](https://ai.google.dev/gemini-api/docs/rate-limits) (ai.google.dev)