Gemini API 接入教程：Gemini API Key 配置、Gemini CLI 与 OpenAI 兼容调用
更新于
通过 API 快连可以用三种方式调用 Google Gemini 模型：Gemini CLI 命令行工具、Gemini 原生接口（google-genai SDK 或 REST），以及 OpenAI 兼容接口。这篇讲清楚每种方式的地址怎么填、怎么验证，以及模型怎么选、报错怎么查。
📌
一句话答案：先建一把 Gemini 分组的密钥。Gemini CLI 和原生接口的地址填
https://apikl.ai（不要带 /v1beta，工具会自己拼）；用 OpenAI 格式调用时填 https://apikl.ai/v1，模型名例如 gemini-3.8-flash。| 调用方式 | 地址 | 认证 |
|---|---|---|
| Gemini CLI | GOOGLE_GEMINI_BASE_URL=https://apikl.ai | GEMINI_API_KEY |
| 原生 REST / google-genai SDK | https://apikl.ai/v1beta/models/模型名:generateContent | 请求头 x-goog-api-key |
| OpenAI 兼容（SDK、Cline 等） | https://apikl.ai/v1 | Authorization: Bearer |
准备：创建 Gemini 分组的密钥
在 控制台 新建密钥时选择 Gemini 类分组。密钥绑定分组：GPT 或 Claude 分组的密钥调不了 Gemini 模型，调用原生接口时会返回「API key group platform is not gemini」。
选哪个模型
| 模型 | 特点 | 适合 |
|---|---|---|
gemini-3.8-flash | 新一代 Flash，速度快、单价低 | 日常对话、批量处理、大多数程序调用 |
gemini-3.1-pro | Pro 档，推理更强 | 复杂分析、长文档、代码 |
gemini-2.5-flash-lite | 更便宜的轻量档 | 分类、提取、摘要等简单任务 |
完整模型列表和价格看 模型广场。带 image 字样的生图模型（如 gemini-3-pro-image-preview）在单独的生图分组里。
方式一：Gemini CLI
安装
BASH
npm install -g @google/gemini-cligemini --version
需要先装好 Node.js，看 Node.js 安装教程。
设置地址和密钥
macOS / Linux
export GEMINI_API_KEY="sk-你的密钥"export GOOGLE_GEMINI_BASE_URL="https://apikl.ai"gemini
Windows · PowerShell
$env:GEMINI_API_KEY="sk-你的密钥"$env:GOOGLE_GEMINI_BASE_URL="https://apikl.ai"gemini
想长期生效，把这两行写进 ~/.gemini/.env（不带 export），或写进 ~/.zshrc / 用 Windows 的 setx。
~/.gemini/.env
GEMINI_API_KEY=sk-你的密钥GOOGLE_GEMINI_BASE_URL=https://apikl.ai
注意这三点
- 不要带 /v1beta：CLI 会自动拼接
/v1beta/models/...，地址只填到https://apikl.ai，否则路径重复会 404。 - 认证方式选 API Key：首次启动或输入
/auth时选择「Use Gemini API Key」。如果之前用 Google 账号登录过，CLI 可能沿用旧的登录状态而不走自定义地址，需要切换回 API Key 方式。 - 地址必须是 https：Gemini CLI 不接受非 https 的自定义地址（本机地址除外），API 快连本身就是 https。
启动后随便问一句，能正常回复就接通了。
方式二：Gemini 原生接口
curl
BASH
curl "https://apikl.ai/v1beta/models/gemini-3.8-flash:generateContent" \ -H "x-goog-api-key: $GEMINI_API_KEY" \ -H "Content-Type: application/json" \ -d '{"contents":[{"parts":[{"text":"你好"}]}]}'
流式输出把路径里的 :generateContent 换成 :streamGenerateContent?alt=sse。原生接口也接受网址参数 ?key=，但密钥会出现在网址和日志里，不推荐。
Python（google-genai SDK）
先安装：pip install google-genai。
Python
import osfrom google import genai client = genai.Client( api_key=os.environ["GEMINI_API_KEY"], http_options={"base_url": "https://apikl.ai"}, # 不带 /v1beta)resp = client.models.generate_content(model="gemini-3.8-flash", contents="你好")print(resp.text)
方式三：OpenAI 兼容接口
已经在用 OpenAI SDK、Cline、Cursor 等工具的话，最省事：Base URL 填 https://apikl.ai/v1，密钥换成 Gemini 分组的，模型填 gemini-3.8-flash 即可。代码写法和 GPT 完全一样，看 OpenAI 兼容接入指南。
BASH
curl https://apikl.ai/v1/chat/completions \ -H "Authorization: Bearer $GEMINI_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"gemini-3.8-flash","messages":[{"role":"user","content":"你好"}]}'