逐步获取 Google 密钥
- 打开 Google AI Studio，地址为 aistudio.google.com/apikey，然后使用 Google 账号登录。
- 点击创建 API 密钥。每个密钥都属于一个 Google Cloud 项目。系统会为新用户创建默认项目；如果你已经在使用 Google Cloud，可以选择现有项目或创建新项目。
- 复制密钥并妥善保存。自 2026 年 5 月 28 日起，新建密钥均为身份验证密钥：绑定服务账号，并默认限制为仅可调用 Gemini API。
- 将其设为环境变量。Google SDK 会读取
GEMINI_API_KEY或GOOGLE_API_KEY；如果两者都已设置，则优先使用GOOGLE_API_KEY。
还在用旧密钥？Gemini API 不接受未设限制的标准密钥。在 AI Studio 中，将鼠标悬停在密钥的不受限制标签上，选择添加限制，将其限制为仅可调用 Gemini API。
测试密钥
Gemini 也支持 OpenAI 格式的请求，方便快速测试。原生请求则通过 x-goog-api-key 请求头传递密钥。
export GEMINI_API_KEY="your-key"curl https://generativelanguage.googleapis.com/v1beta/openai/chat/completions \ -H "Authorization: Bearer $GEMINI_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model": "gemini-3.8-flash", "messages": [{"role": "user", "content": "Say hello"}]}'免费层级及其代价
新密钥无需绑定银行卡即可使用免费层级。免费层级支持 Flash 和 Flash-Lite 模型、Gemini 2.5 Pro、文本转语音模型、Live 模型及嵌入模型，但速率限制比付费层级更低。Gemini 4 Argon、Gemini 3.1 Pro 和图像模型需要启用计费。
代价是：在免费层级，Google 会使用你发送的内容和返回的结果来改进产品，人工审核员也可能查看这些内容。付费层级则不会。请勿通过免费密钥发送个人或机密数据。
启用计费
在 AI Studio 中，选择项目的设置计费，关联 Cloud 结算账号，并预充值至少 $5。支出上限会随已付款金额提高:
| 档位 | 达标条件 | 支出上限 |
|---|---|---|
| 免费 | 有一个有效项目 | 仅限免费模型 |
| 等级 1 | 已关联结算账号 | $250 |
| 已付款 $100，且距首次付款已满 3 天 | 累计支付 $100, 且距首次付款已满 3 天 | $2,000 |
| 等级 3 | 累计支付 $1,000, 且已满 30 天 | $20,000 及以上 |
之后，每次请求按 token 计费。以下为每 1M tokens 的官方标价:
| 模型 | 输入 | 输出 | Zurelay 价格（输入 / 输出） |
|---|---|---|---|
| Gemini 4 Argon | $2.00 | $10.00 | $0.80 / $4.00 |
| Gemini 3.1 Pro | $2.00 | $12.00 | $0.50 / $3.45 |
| Gemini 3.8 Flash | $0.75 | $3.75 | $0.22 / $1.10 |
| Gemini 3.5 Flash-Lite | $0.30 | $2.50 | $0.12 / $1.04 |
Google AI Pro 或 Ultra 包含 API 吗?
不包含。Google AI 套餐权益仅适用于 AI Studio 网站内；使用密钥调用 Gemini API 需通过 Google Cloud 单独计费。
妥善保管密钥
- 请将密钥保存在服务端。放在网页或应用中的密钥可能被复制，产生的费用会记在你的账单账户上。
- 将每个密钥限制为仅可调用 Gemini API，并为每个应用使用独立项目。
- 在 Google Cloud 结算中设置预算提醒，因为付费调用产生的费用会记入你的账户。
另一种方式：用同一个密钥调用 Gemini、Claude 和 GPT
在 Zurelay 上，Gemini 只是同一个 OpenAI 兼容密钥下的另一个模型名称，费用从预付余额中扣除，无需 Cloud 结算账户 (Gemini 3.8 Flash 比 Google 官方标价低 71%):
from openai import OpenAIclient = OpenAI(base_url="https://api.zurelay.com/v1", api_key="YOUR_ZURELAY_KEY")reply = client.chat.completions.create( model="gemini-3.8-flash", messages=[{"role": "user", "content": "Say hello"}],)print(reply.choices[0].message.content)Zurelay 不提供免费额度；充值 $10 起。如果免费额度已能满足你的需求，直接使用 Google 的密钥起步更省钱。各模型价格请参阅 Gemini API 定价。
操作步骤、免费额度及计费信息均于 2026年10月28日 查阅自 Google 的 API 密钥、pricing、速率限制、terms 和 Google AI 套餐 页面。