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

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 可用地区。截至 2026 年 10 月 8 日，这份官方列表里没有中国大陆，也没有香港；页面同时写明 18 岁以上和年龄验证要求。如果不符合官方直连接入条件，应在这里停止，不使用虚假地区、账单地址、他人身份或来路不明的 Google Key 绕过。

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

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

不需要购买。Gemini API Key 在 Google AI Studio 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 购买前先看：中国大陆的地区、付费与凭据路线。

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

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

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

Google 当前的 Gemini 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。

图中“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 但请求没变”经常由这个优先级造成。

export GEMINI_API_KEY="YOUR_API_KEY"

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

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

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

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

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

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 能用不等于容量够，项目付费不等于正在使用正确 Key，AI Studio 能看到某模型也不等于同一 API 接口可以免费调用。

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

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

创建 Key 不收“Key 费用”，费用只来自调用：项目在免费层时只能用免费层开放的模型，关联结算后按模型价格计费。截至 2026 年 10 月 8 日，Google Gemini API 价格页的免费层情况如下：

• 免费层可调用：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。

Gemini API Key 免费额度在哪看

Google 没有公开按模型列出的免费层 RPM、TPM、RPD 表，当前限额要在 AI Studio 的速率限制页面查看，按项目和模型分别显示。限额按项目计算，同一项目多建几枚 Key 不会多出一份免费额度，所有 Key 共用一个池子。各模型的免费资格和限额怎么读，见 Gemini API Key 免费额度与速率限制 2026：哪些还免费、去哪看限额。

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

Google Gemini API 速率限制文档里的用量层级如下，可在 AI Studio 的 Projects 页面查看项目当前所在层级：

从 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 购买前先看：中国大陆的地区、付费与凭据路线，并在使用当天核对 Google 的实时价格页。

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