9 分钟阅读发布于：2026-07-29更新于：2026-09-03

Gemini API Key 获取指南：Google AI Studio 官方入口（2026）

通过 Google AI Studio 创建并管理 Gemini API Key，了解当前免费与付费层级、Auth key 迁移要求，并安全完成第一次请求。

作者 Heizi· 创始人 & 编辑· 发布于: 2026-07-29· 更新于: 2026-09-03

Gemini API Key 官方入口

请在 Google AI Studio 官方 API Keys 页面创建和管理密钥：https://aistudio.google.com/app/apikey。新用户接受条款后，系统会自动创建默认 Google Cloud 项目和 API Key；你也可以创建新 Key 并关联项目。

Google 将 AI Studio 当前新建的密钥称为 Auth key。它默认仅用于 Gemini API，并带有泄漏密钥阻断机制。不要把 Key 写进公开代码仓库或浏览器端 JavaScript。

登录 Google AI Studio
接受 Gemini API 条款
打开 API Keys 页面
复制 Auth key，并保存为 GEMINI_API_KEY 环境变量

重要：在 2026 年 9 月前迁移 Standard key

Google 官方说明，Gemini API 将在 2026 年 9 月拒绝 Standard key。AI Studio 当前新建的 Key 已默认是 Auth key。如果旧项目仍使用 Standard key，应在截止日期前到 AI Studio 完成迁移，避免服务中断。

在当前过渡规则下，显式配置了 API 限制的 Standard key 仍可工作；但官方推荐且更稳妥的方式，是在 AI Studio 中迁移为 Auth key。

Gemini 免费层实际包含什么

新账户从免费层开始。部分 Gemini 模型的输入和输出可在免费层内免费使用，但必须遵守 AI Studio 中该项目显示的实时限额。Google 并未承诺统一的 RPM 或每日请求数；限额会随模型、项目层级、账户状态和可用容量变化。

升级付费层需要关联结算账户。Google 当前结算文档说明，部分账户需要至少预付 10 美元。付费层具有更高限额、更多模型和功能，并采用不同的数据使用条款。自 2026 年 3 月起，Gemini API 用量不再适用 Google Cloud 300 美元免费试用金。

限额按项目计算，而不是按单个 API Key 计算。上线前应在 AI Studio 查看实时 RPM、TPM 与 RPD。

使用当前 Google Gen AI SDK 测试 Key

安装 Google 当前 SDK，把密钥放在环境变量中，并先发送最小请求，再接入业务逻辑。模型 ID 应以你的 AI Studio 项目实际可用列表为准。

python

from google import genai
import os

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
response = client.models.generate_content(
    model="gemini-3.5-flash",
    contents="Reply with exactly: KEY_WORKS",
)
print(response.text)

服务端 Python Key 检查

bash

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -X POST \
  -d '{"contents":[{"parts":[{"text":"Reply with exactly: KEY_WORKS"}]}]}'

最小 cURL 请求