Gemini CLI

Gemini CLI es el agente de código abierto de Google para la terminal. Con dos variables de entorno lo apuntas a Synthorai, y a partir de ahí llama al endpoint nativo de Gemini de la pasarela con tu clave de Synthorai.

Antes de empezar

Crea una clave de API en la página Claves API de la consola. Cópiala en el momento: solo se muestra una vez.

Paso 1 - Configurar las variables de entorno

export GOOGLE_GEMINI_BASE_URL="https://synthorai.io"
export GEMINI_API_KEY="sk-..."
gemini -m gemini-3-pro

⚠

Pon solo el host, sin /v1: Gemini CLI añade su propia ruta.

Cuando Gemini CLI pregunte cómo autenticarse, elige Use Gemini API key. La clave se envía en la cabecera x-goog-api-key, que la pasarela acepta en su endpoint nativo de Gemini: /v1beta/models/{model}:generateContent y :streamGenerateContent.

Paso 2 - Elegir un modelo

Pasa a -m un modelo Gemini que tu clave pueda llamar. La página de modelos los muestra.

En esta ruta solo se sirven generateContent y streamGenerateContent. Los demás métodos, como countTokens y embedContent, responden 404 y no se cobran.

Guardar la configuración en un archivo

En lugar de exportar las variables en cada shell, puedes ponerlas en ~/.gemini/.env:

# ~/.gemini/.env
GOOGLE_GEMINI_BASE_URL="https://synthorai.io"
GEMINI_API_KEY="sk-..."

Solución de problemas

401 La clave es incorrecta o no está definida en la shell desde la que ejecutas gemini.

404 en un modelo Ese modelo no está habilitado para tu clave. Elige uno que tu clave pueda llamar.

/v1/v1beta en una URL Quita /v1 de GOOGLE_GEMINI_BASE_URL.

Para comparar lo que cuestan los modelos Gemini, consulta la comparativa de precios de modelos.