【实战教程】Google Gemini CLI 与 Gemini API 中转接入、兼容路径及防伪装实测指南
Google 官方提供原生的 v1beta 接口与 /v1beta/openai 兼容接口,而绝大多数第三方中转站统一在 /v1/chat/completions 暴露 Gemini 模型。接入前需分清路径格式,并用 Gemini 协议探针检验工具调用与流式一致性。
一、分清 Google 官方端点与第三方中转端点
如果你使用的是 Google AI Studio 签发的 AIza 开头官方密钥,OpenAI 兼容根路径需要填写 https://generativelanguage.googleapis.com/v1beta/openai。
如果你使用的是第三方中转站签发的 sk- 开头密钥,根路径通常填写 https://api.example.com/v1(或站点根域名),网关会在后台转发或转换请求。
# 使用 OpenAI SDK 调用中转站 Gemini 模型示例
export OPENAI_BASE_URL=https://api.example.com/v1
export OPENAI_API_KEY=sk-your-temp-relay-key
二、如何用明镜Test 检查 Gemini 中转线路质量
- 打开明镜Test 首页切到「Gemini」选项卡,或直接访问 /gemini 专页,填入 Base URL 与临时测试 Key。
- 点击「获取模型」查看当前分组实际暴露的 gemini-2.5 / gemini-3 / gemini-4 系列模型 ID。
- 运行「标准」或「深度」检测,重点核对 Function Calling 结构、JSON Schema 结构化输出及 usage 用量字段是否合规。