Gemini CLI

Gemini CLI è l'agente open source di Google per il terminale. Bastano due variabili d'ambiente per indirizzarlo a Synthorai: da quel momento chiama l'endpoint nativo Gemini del gateway con la tua chiave Synthorai.

Prima di iniziare

Crea una chiave API nella pagina Chiavi API della console. Copiala subito: viene mostrata una sola volta.

Passo 1 - Imposta le variabili d'ambiente

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

⚠

Indica solo l'host, senza /v1: il percorso lo aggiunge Gemini CLI.

Quando Gemini CLI chiede come autenticarti, scegli Use Gemini API key. La chiave viene inviata nell'header x-goog-api-key, che il gateway accetta sul suo endpoint nativo Gemini: /v1beta/models/{model}:generateContent e :streamGenerateContent.

Passo 2 - Scegli un modello

Passa a -m un modello Gemini che la tua chiave può chiamare. La pagina dei modelli li elenca.

Su questo percorso sono serviti solo generateContent e streamGenerateContent. Gli altri metodi, come countTokens ed embedContent, rispondono 404 e non vengono addebitati.

Salva le impostazioni in un file

Invece di esportare le variabili in ogni shell, puoi metterle in ~/.gemini/.env:

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

Risoluzione dei problemi

401 La chiave è sbagliata oppure non è impostata nella shell in cui esegui gemini.

404 su un modello Il modello non è abilitato per la tua chiave. Scegline uno che la chiave può chiamare.

/v1/v1beta in un URL Togli /v1 da GOOGLE_GEMINI_BASE_URL.

Per confrontare il prezzo dei modelli Gemini, consulta il confronto prezzi dei modelli.