一句话重点
到 aistudio.google.com 用 Google 账号登录、接受服务条款，新用户就会自动拿到一个免费的 Gemini API key，复制下来就能用。照官方快速入门的说明，第一次调用 API 不到一分钟就能完成。免费额度可以用 Gemini 4 Hydrogen，代价是免费方案的内容 Google 会拿来改进产品。
如果你还不熟悉 AI Studio 本身，可以先看 Google AI Studio 完整教程。这篇只讲 API key。
免费吗？
免费。Google 的定价页写得很清楚，免费方案的输入和输出 token（AI 计算文字量的单位）都不收费，AI Studio 本身在所有支持地区也都免费。台湾在官方支持地区名单里，可以直接申请。
免费方案有两个限制：
- 速率限制比较低：每分钟请求数（RPM）、每分钟输入 token 数（TPM）、每天请求数（RPD）都有上限，超过任何一项就会返回错误。每天的额度在美国太平洋时间午夜重置。
- 只开放部分模型：Gemini 4 Hydrogen、Gemini 3.8 Flash 等有免费额度，Gemini 4 Argon、Gemini 4 Carbon 和 Nano Banana 图片模型就只有付费方案能用。
另外，使用 API 必须年满 18 岁。
怎么申请？
- 打开 aistudio.google.com，用 Google 账号登录。
- 第一次使用会看到服务条款，接受之后，AI Studio 会自动帮你创建一个 Google Cloud 项目和一个 API key。
- 到 API Keys 页面，把这个 key 复制下来。
- 想多要一个，点 Create API key，按对话框选好项目就会生成新的 key。
- 把 key 设成环境变量（下一节有命令），不要贴在代码里。
本来就有 Google Cloud 账号的人，AI Studio 不会自动创建项目。做法是从左侧栏打开 Dashboard，选 Projects，点 Import projects，选好项目再按 Import，接着到 API Keys 页面创建 key。
从 Google Cloud 导入的项目或额外新建的项目，有时要先做手机验证才能用免费额度。验证方式是用手机扫二维码，不用提供手机号，也不用装 app。
申请好之后怎么测试？
先把 key 存进环境变量。macOS、Linux 用这一行：
export GEMINI_API_KEY="YOUR_API_KEY"Windows PowerShell 用这一行：
$env:GEMINI_API_KEY="YOUR_API_KEY"官方的 SDK（软件开发工具包）会自己读取 GEMINI_API_KEY 或 GOOGLE_API_KEY，两个都设的话，以 GOOGLE_API_KEY 为准。
接着用官方快速入门的 curl 命令试一次：
curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-H "Api-Revision: 2026-05-20" \
-d '{
"model": "gemini-4-hydrogen",
"input": "Explain how AI works in a few words"
}'返回一段 JSON 回答，就说明 key 可以用了。习惯写 Python 的人，先运行 pip install -U google-genai，再用 genai.Client() 创建 client，它会自己读取环境变量里的 key。
免费和付费差在哪？
| 免费方案 | 付费方案 | |
|---|---|---|
| 费用 | 输入、输出 token 都免费 | 按 token 计费，Hydrogen 每百万 token 输入 1.5 美元、输出 7.5 美元 |
| 速率限制 | 较低 | 较高，批量处理（Batch API）打五折 |
| 可用模型 | 部分模型 | 包含 Argon、Carbon 等旗舰模型 |
| 你的数据 | Google 会用来改进产品 | 不会用来改进产品 |
数据用途是最大的区别。免费方案发送的内容和回复，Google 会拿来改进产品，人工审阅员也可能看到。服务条款直接写明，不要把敏感、机密或个人数据发进免费方案。
升级的方式是在 API Keys 页面点 Set up billing，关联结算账户并预付至少 5 美元的额度。开了结算的项目，API 调用就算付费服务，数据不会被拿去改进产品。
Key 怎么保管、泄露了怎么办？
官方建议把 API key 当成密码保管。保管原则有四个：
- 不要把 key 推上 Git 之类的版本控制。
- 不要把 key 写死在网页或手机 app 里，前端代码用户拆得出来，要通过自己的后端代为调用。
- 从环境变量读取 key。正式上线的服务，改放 Google Cloud Secret Manager。
- 在 Google Cloud console 设置账单提醒，用量突然暴增时会通知你。
2026 年 5 月 28 日起，AI Studio 创建的新 key 都是 auth key，默认只能调用 Gemini API，Google 检测到泄露时也能很快把它拦下。
怀疑 key 泄露时，按这个顺序处理：
- 到 AI Studio 的 API Keys 页面新建一个 key。
- 把应用换上新 key 并部署。
- 确认新 key 能用之后，到 Google Cloud console 停用或删除泄露的 key。
- 检查账单记录和 API 用量，看有没有被盗用。
顺序很重要。新 key 还没上线就先删旧 key，服务会中断。
常见错误怎么处理？
- 429 RESOURCE_EXHAUSTED：官方文档写明，碰到以花费计算的速率限制时，API 会返回这个错误。速率限制是算在整个项目上的，多建几个 key 不会多出额度。官方建议用指数退避重试，也就是第一次等一会儿，之后每次等得更久。Python SDK 默认会自动重试最多 4 次。用量本来就大，就升级付费方案。
- 403 FREE_TIER_VERIFICATION_REQUIRED：免费方案的项目还没做手机验证。打开错误信息里的验证链接，点 Verify device，用手机相机扫二维码，看到 Project verified 后再重试。同一个项目重建 key 解决不了，因为验证是看项目的。不想验证的话，也可以直接开通结算改用付费方案。
- 其他 403 PERMISSION_DENIED：错误信息是 Your project has been denied access，项目状态可能显示 Restricted、Free tier unavailable、Payment needed 或 Unavailable。显示 Free tier unavailable 代表这个项目不能用免费方案，要关联结算账户改用付费方案，重建 key 也一样不能用。
- Create API key 按钮不能点，显示 You do not have permission to create a key in this project：你在这个项目里没有创建 key 的权限。请项目管理员帮你开权限，或自己新建一个不属于任何组织的项目。
- 旧 key 显示 Unrestricted 标签：Gemini API 会拒绝没设限制的旧式 key（standard key）。到 API Keys 页面把鼠标移到 Unrestricted 标签上，点 Add restrictions，选 Restrict to Gemini API only，再按 Restrict key。
- 旧 key 出现 Blocked 标签：没设限制的旧 key 放太久没用，会被封锁。改用一个设了限制的 key，或在 API Keys 页面点 Create API key 新建。
- 打不开 AI Studio：先确认所在地区。台湾在支持名单里，香港和中国大陆不在。
小企鹅的总结
申请 Gemini API key 比大多数人想的简单，新用户登录 AI Studio、接受条款，key 就已经在 API Keys 页面等你。免费额度可以直接试 Hydrogen。要记住的只有两件事：key 放环境变量，不要进 Git 或前端代码，还有免费方案的内容会被 Google 拿去改进产品，敏感、机密或个人数据不要发进免费方案。更多 Gemini 的用法，可以回到 Gemini 系列总览。
本文为 AI 模型 API 计费的消费信息，不涉及证券或投资建议。本文信息截至 2026 年 11 月 14 日。