主题
语言

Gemini CLI

将 Gemini CLI 连接到 GetVibe API:使用 GOOGLE_GEMINI_BASE_URL 和 GEMINI_API_KEY,通过原生 Gemini API(generateContent、streamGenerateContent)使用目录中的任意模型。

Gemini CLI 使用原生 Gemini API(/v1beta/models/…:streamGenerateContent,密钥位于 x-goog-api-key 中)。该 API 接受此协议,并通过与 /v1/chat/completions 相同的处理流水线运行:Gemini CLI 可使用目录中的任意模型,而不仅限于 Gemini,且采用相同的计费、限额和生成历史记录。

安装

npm install -g @google/gemini-cli

设置

在 ~/.gemini/settings.json 中选择 API 密钥登录——否则,处于 -p 模式的 Gemini CLI 会返回“选择的身份验证方法无效”:

{
  "security": { "auth": { "selectedType": "gemini-api-key" } }
}

地址和密钥通过环境变量设置。基础 URL 不包含 /v1beta:客户端会自行追加路径。

export GOOGLE_GEMINI_BASE_URL="https://getvibeapi.com"
export GEMINI_API_KEY="sk-pv-…"

检查

gemini -m deepseek-v4.1-flash -p "Reply: ready"

使用 -m 或 settings.json 中的 model.name 选择模型——目录中的任意 ID 均可使用,包括渠道 :suffix。工具调用(读取文件、Shell、编辑)照常工作。在受信任文件夹之外自动运行时,请添加 GEMINI_CLI_TRUST_WORKSPACE=true。

支持的功能

参数类型描述
:generateContent / :streamGenerateContentPOST文本、图像(inlineData)、systemInstruction、tools/functionDeclarations、toolConfig、responseSchema、thinkingConfig
:countTokensPOST估算值(每个 token 约 4 个字符);确切数量见响应中的 usageMetadata
/v1beta/modelsGETGemini 格式的目录模型列表
Keyheaderx-goog-api-key、?key= 或 Authorization: Bearer — 你的 sk-pv-… 密钥
usageMetadata 包含 cachedContentTokenCount 和 thoughtsTokenCount。不支持 Google 内置工具(googleSearch、codeExecution)、Files API、embedContent 和缓存内容:内置工具会被静默跳过,嵌入服务通过 /v1/embeddings 提供。

同一地址也适用于 @google/genai 和 google-genai SDK:传入 httpOptions: { baseUrl: 'https://getvibeapi.com' }(Python:http_options={'base_url': 'https://getvibeapi.com'}),并将你的 sk-pv-… 密钥作为 apiKey 传入。

Gemini CLI + GetVibe API — 原生 Gemini API | GetVibe API