Tema
Idioma

Gemini CLI

Conecta Gemini CLI a GetVibe API: GOOGLE_GEMINI_BASE_URL y GEMINI_API_KEY, cualquier modelo del catálogo a través de la API nativa de Gemini (generateContent, streamGenerateContent).

Gemini CLI usa la API nativa de Gemini (/v1beta/models/…:streamGenerateContent, con la clave en x-goog-api-key). La API acepta ese protocolo y lo procesa mediante el mismo flujo que /v1/chat/completions: cualquier modelo del catálogo funciona desde Gemini CLI, no solo Gemini, con la misma facturación, los mismos límites y el mismo historial de generaciones.

Instalación

npm install -g @google/gemini-cli

Configuración

Selecciona el inicio de sesión con clave de API en ~/.gemini/settings.json; sin él, Gemini CLI en modo -p responde «Método de autenticación seleccionado no válido»:

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

La dirección y la clave se configuran en variables de entorno. La URL base no lleva /v1beta: el cliente añade la ruta por su cuenta.

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

Comprobación

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

Elige el modelo con -m o model.name en settings.json: funciona cualquier ID del catálogo, incluido un canal :suffix. Las llamadas a herramientas (lectura de archivos, shell, ediciones) funcionan como siempre. Para ejecuciones automatizadas fuera de una carpeta de confianza, añade GEMINI_CLI_TRUST_WORKSPACE=true.

Qué es compatible

ParámetroTipoDescripción
:generateContent / :streamGenerateContentPOSTtexto, imágenes (inlineData), systemInstruction, tools/functionDeclarations, toolConfig, responseSchema, thinkingConfig
:countTokensPOSTuna estimación (~4 caracteres por token); el recuento exacto está en usageMetadata de la respuesta
/v1beta/modelsGETla lista de modelos del catálogo en formato Gemini
Keyheaderx-goog-api-key, ?key= o Authorization: Bearer — tu clave sk-pv-…
usageMetadata incluye cachedContentTokenCount y thoughtsTokenCount. Las herramientas integradas de Google (googleSearch, codeExecution), la API Files, embedContent y los contenidos en caché no son compatibles: las herramientas integradas se omiten sin aviso y los embeddings se sirven en /v1/embeddings.

La misma dirección funciona para los SDK de @google/genai y google-genai: pasa httpOptions: { baseUrl: 'https://getvibeapi.com' } (Python: http_options={'base_url': 'https://getvibeapi.com'}) y tu clave sk-pv-… como apiKey.

Gemini CLI + GetVibe API — API nativa de Gemini | GetVibe API