Gemini API Key 获取教程：AI Studio、配额与国内接入（2026）

Gemini 是 Google 的多模态模型系列，支持文本、图片、音频、视频等输入。很多开发者第一次用 Gemini API 时，会卡在三个地方：Key 在哪里创建、免费额度怎么算、国内怎么稳定调用。

本文从中商起航 AI 网关的角度，讲清楚 Gemini API Key 的获取、配置、调用和常见报错。

本文以 2026 年 10 月的常见版本为例。Google AI Studio 的界面和配额会调整，具体以官方控制台为准。

一、Gemini API 能做什么

常见用途：

长文档总结、翻译、改写。
图片/视频理解与内容审核。
多模态问答、OCR、表格抽取。
代码生成与代码解释。
Agent 工作流中的推理节点。

Gemini 常见模型分 Pro、Flash 等档位。Pro 能力更强，Flash 更快更便宜。具体模型名、上下文长度和价格，以模型价格页面为准。

二、获取 Gemini API Key 的两条路

路线 A：Google AI Studio 官方 Key

打开 Google AI Studio。
用 Google 账号登录。
进入 API Key 页面，创建 Key。
复制 Key，保存到密码管理器。
在项目里绑定结算账号（如果需要更高配额）。

官方 Key 适合：能稳定访问 Google、需要官方直连、用量不大的场景。

路线 B：通过中商起航网关获取 Key

打开中商起航 AI 网关注册并登录。
进入「API 密钥」页面，新建 Key。
设置额度上限和过期时间。
在钱包充值。
复制 Key。

网关适合：国内访问不稳定、需要统一账单、同时用多家模型的团队。

三、Base URL 怎么填

官方 Gemini API

Gemini 原生接口的 Base URL 是：

https://generativelanguage.googleapis.com

官方也提供 OpenAI 兼容入口：

https://generativelanguage.googleapis.com/v1beta/openai/

中商起航网关

使用 OpenAI 兼容接口时，Base URL 填：

https://ai.zhongshangqihang.com/v1

注意不要混用：官方 Key 配官方地址，网关 Key 配网关地址。混用通常会返回 401 或 404。

四、curl 测试

export GEMINI_API_KEY="sk-你的密钥"

curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
  -H "Authorization: Bearer $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-flash",
    "messages": [
      {"role": "user", "content": "用三句话解释什么是多模态模型"}
    ]
  }'

模型名以模型价格当前展示为准。如果返回 model not found，先检查模型名，而不是先怀疑 Key。

五、Python 调用

pip install openai

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["GEMINI_API_KEY"],
    base_url="https://ai.zhongshangqihang.com/v1",
)

response = client.chat.completions.create(
    model="gemini-2.5-flash",
    messages=[
        {"role": "user", "content": "总结一下这段文字的要点：" + "..."}
    ],
)

print(response.choices[0].message.content)

如果你用 Google 官方 SDK，则需要按官方文档安装 google-genai，并改用官方端点。两条路不要混用。

六、配额和限流

Gemini 的配额通常按模型、项目、地区和时间窗口计算。常见限制包括：

每分钟请求数（RPM）。
每分钟 Token 数（TPM）。
每日请求数（RPD）。
免费层与付费层不同。

实际配额以 Google 官方控制台或网关控制台为准。生产环境建议：

给 Key 设置额度上限。
对 429 做指数退避。
关键业务准备备用模型。
监控错误率和首 Token 延迟。

七、国内访问常见问题

现象	可能原因	处理
连接超时	网络无法访问 Google	使用可用的网关/代理
401	Key 错或 Base URL 混用	检查 Key 与地址是否匹配
404	路径多写/少写 `/v1`	官方和网关地址分开核对
429	配额/频率超限	降并发、重试、升级配额
模型不可用	地区或账号未开通	换模型或换通道
返回内容被截断	输出上限/上下文限制	调整参数或分段

八、成本怎么估算

Gemini 的成本通常由输入 Token、输出 Token、图片/视频等多模态输入共同决定。估算步骤：

统计每次请求的平均输入/输出 Token。
查当前模型的单价（以模型价格为准）。
乘以日均请求数，得到日成本。
加上重试、缓存和多模态输入的额外消耗。

不要只看“每百万 Token”单价，长上下文和多模态输入往往才是成本大头。

九、安全建议

不要把 Key 写进前端代码。
一人一 Key，团队按项目拆分。
设置额度上限和过期时间。
定期轮换 Key。
生产环境用环境变量或密钥管理服务。

常见问题

Gemini API Key 可以免费用吗？

通常有免费层，但有配额和地区限制。长期或商用建议使用付费层，具体以官方政策为准。

一个 Key 能调用 Claude 吗？

在网关里，一个 Key 可以调用已开通的多个模型；模型在请求参数里指定。官方 Gemini Key 只能调用 Google 的模型。

为什么同一个模型有时很慢？

可能受上游负载、地区网络、上下文长度和并发影响。生产环境建议做超时、重试和备用通道。

下一步

如果你需要国内稳定访问或多模型统一入口，可以先注册中商起航 AI 网关，创建测试 Key，用 curl 跑通，再接入应用。模型和价格以模型价格为准。