Home / Guide / Gemini CLI con endpoint personalizzato e modelli gratuiti

Gemini CLI con endpoint personalizzato e modelli gratuiti

Gemini CLI è l'agente di programmazione open source di Google per il terminale. Può inviare le sue richieste a un URL base personalizzato. Questa guida punta Gemini CLI a FreeLLMAPI, che serve l'API Gemini nativa su /v1beta. Le tue richieste vanno poi al tuo pool di piani gratuiti dei provider, che può includere chiavi gratuite dell'API Gemini.

Codice, nomi dei modelli ed etichette del catalogo in tempo reale sono mostrati in inglese.

La modifica del 2026 al piano gratuito di Gemini CLI

Leggi prima questo. Google ha cambiato l'uso gratuito di Gemini CLI nel 2026. La pagina delle quote di Gemini CLI dice: «Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI on June 18th, 2026.»

L'annuncio di Google dice che Gemini CLI resta disponibile tramite chiavi API Gemini a pagamento e per i clienti enterprise.

  • Accesso Google nel piano gratuito: non più servito da Gemini CLI per gli account consumer.
  • Chiave API Gemini con URL base personalizzato: il riferimento di configurazione di Gemini CLI documenta ancora GOOGLE_GEMINI_BASE_URL. Con questa variabile, Gemini CLI invia le sue richieste all'URL che imposti, non a Google.
  • Chiavi API Gemini gratuite: Google AI Studio elenca ancora un piano gratuito per l'API Gemini. FreeLLMAPI può usare queste chiavi, insieme alle chiavi di altri provider.

Questa guida usa il secondo metodo. FreeLLMAPI risponde alle richieste e invia ciascuna a un modello gratuito del tuo pool.

Passo 1: installa FreeLLMAPI e Gemini CLI

Installa entrambi

curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @google/gemini-cli

Apri http://localhost:3001. Aggiungi almeno due chiavi di provider gratuiti nella pagina Keys. Una chiave gratuita di Google AI Studio è una buona prima chiave. Copia la tua chiave unificata dalla stessa pagina.

Passo 2: punta Gemini CLI al gateway

Imposta due variabili d'ambiente e avvia Gemini CLI. L'URL base è l'origine del server, senza /v1beta. Gemini CLI aggiunge da solo il percorso dell'API.

macOS o Linux

export GOOGLE_GEMINI_BASE_URL=http://localhost:3001
export GEMINI_API_KEY=<unified-key>
gemini

Windows PowerShell

$env:GOOGLE_GEMINI_BASE_URL="http://localhost:3001"
$env:GEMINI_API_KEY="<unified-key>"
gemini

Quando Gemini CLI chiede un metodo di autenticazione, seleziona Use Gemini API key. Per salvare la scelta, impostala in ~/.gemini/settings.json:

~/.gemini/settings.json

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
Importante: usa GEMINI_API_KEY. Una segnalazione su Gemini CLI riporta che la versione 0.44.x fallisce con «Invalid auth method selected» quando si usa GOOGLE_API_KEY con GOOGLE_GEMINI_BASE_URL. Se GOOGLE_API_KEY è impostata, rimuovila con unset GOOGLE_API_KEY.

Passo 3: mappa i nomi dei modelli Gemini su modelli gratuiti

Gemini CLI chiede nomi di modelli Gemini, per esempio gemini-2.5-flash. FreeLLMAPI non invia questi nomi direttamente a Google. Li risolve tramite la mappa delle famiglie Gemini nella scheda Keys, Agents. Mappa ogni famiglia (Pro, Flash e Flash-Lite) su Auto o su un modello fisso del catalogo.

  • Con Auto, il router sceglie un modello gratuito per ogni richiesta. Quando un provider invia un errore 429, prova il successivo.
  • Anche gli ID del catalogo funzionano come nomi di modelli. Avvia Gemini CLI con gemini -m <catalog-id>, oppure imposta GEMINI_MODEL.
  • Gemini CLI è un agente con strumenti. Mappa le famiglie su modelli con chiamate di strumenti e una finestra di contesto ampia.

La prima tabella mostra i modelli Gemini gratuiti del catalogo di oggi. La seconda tabella mostra altri modelli gratuiti che puoi mappare su una famiglia Gemini.

Modelli API Gemini gratuiti con chiamate di strumenti (Google AI Studio)
ModelloGratis suContestoLimiti gratuiti (offerta migliore)StrumentiVisione
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaSìSì
Gemini Flash (latest alias)Google AI Studio-10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
Gemini 3.7 FlashGoogle AI Studio1M10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
Gemini 3.6 FlashGoogle AI Studio1M10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
Gemini 3.5 FlashGoogle AI Studio1M10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
Gemini 3.8 LiveGoogle AI Studio-10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì
Gemini 3.5 Flash LiteGoogle AI Studio1M15 richieste/min
20 richieste/giorno
250,000 token/min
~3M
SìSì

Mostrati 8 di 14 modelli gratuiti corrispondenti. Vedi tutti i modelli.

Dati in tempo reale dal catalogo FreeLLMAPI (versione 2026.11.19, verificato il 2026-11-19). I limiti gratuiti cambiano spesso. Il catalogo viene verificato ogni giorno.

Altri modelli gratuiti per Gemini CLI: chiamate di strumenti e contesto da 128K+
ModelloGratis suContestoLimiti gratuiti (offerta migliore)StrumentiVisione
GLM 5.3UnoRouter1M1 richieste/min
1 req/min per model
SìNo
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 richieste/min
40 RPM
SìSì
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceSìNo
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditSìSì
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditSìSì
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 richieste/min
50 richieste/giorno
50 req/day account-wide (1,000 after a $10 purchase)
SìSì
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 richieste/min
50 richieste/giorno
Shared rate limit
SìNo
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 richieste/min
250 richieste/giorno
70,000 token/min
~6M
SìSì

Mostrati 8 di 104 modelli gratuiti corrispondenti. Vedi tutti i modelli.

Dati in tempo reale dal catalogo FreeLLMAPI (versione 2026.11.19, verificato il 2026-11-19). I limiti gratuiti cambiano spesso. Il catalogo viene verificato ogni giorno.

Limiti del piano gratuito di Gemini

La pagina dei limiti di frequenza di Google dice che i limiti si applicano per progetto, non per chiave API. Più chiavi nello stesso progetto non danno più quota. Google dice anche che i limiti non sono garantiti e che puoi vedere i limiti attuali in Google AI Studio. I modelli in anteprima hanno limiti più bassi.

Una chiave gratuita di Gemini Flash consente poche richieste al giorno. Un singolo task di Gemini CLI può inviare molte richieste. Aggiungi chiavi di altri provider, così il router può continuare quando la quota Gemini si esaurisce. La superficie nativa supporta generateContent, streamGenerateContent con ?alt=sse, countTokens e l'elenco dei modelli.

FreeLLMAPI accetta la chiave nell'intestazione x-goog-api-key, come token Bearer o nel parametro di query ?key= di Gemini. Preferisci un'intestazione, perché una chiave in un URL può finire nella cronologia della shell e nei log dei proxy.

Risoluzione dei problemi

ProblemaCausaSoluzione
Gemini CLI apre un login GoogleIl tipo di autenticazione non è impostato su Gemini API keySeleziona Use Gemini API key, oppure imposta security.auth.selectedType
«Invalid auth method selected»GOOGLE_API_KEY è usata con un URL base personalizzatoUsa GEMINI_API_KEY e rimuovi GOOGLE_API_KEY
Le richieste vanno a Google, non al gatewayGOOGLE_GEMINI_BASE_URL non è impostata in questa shellEsporta la variabile, poi avvia di nuovo gemini
404 sulle chiamate ai modelliL'URL base include /v1betaUsa solo l'origine http://localhost:3001
Le chiamate di strumenti fallisconoLa famiglia Gemini è mappata su un modello con chiamate di strumenti deboliMappa la famiglia su un modello delle tabelle sopra
«All models rate-limited after N attempts»Tutte le chiavi sono al limiteAggiungi chiavi di altri provider, oppure attendi i cooldown
Usa ognuno di questi modelli con una sola chiave. FreeLLMAPI è un router open source self-hosted che mette tutti questi piani gratuiti dietro un unico endpoint compatibile con OpenAI e passa al successivo quando uno raggiunge il limite di frequenza. Sfoglia il catalogo oppure inizia.

Domande frequenti

Gemini CLI è ancora gratuito?

Google ha terminato l'uso gratuito di Gemini CLI con login Google per gli utenti non a pagamento e per gli utenti Google One il 18 giugno 2026. La CLI supporta ancora un URL base personalizzato, quindi può funzionare su un gateway gratuito come FreeLLMAPI.

Come uso Gemini CLI con un endpoint personalizzato?

Imposta GOOGLE_GEMINI_BASE_URL sull'origine dell'endpoint e GEMINI_API_KEY sulla sua chiave, poi seleziona Use Gemini API key. L'endpoint deve parlare l'API Gemini nativa su /v1beta.

Gemini CLI può usare modelli che non sono Gemini?

Sì, tramite FreeLLMAPI. Il gateway mappa i nomi di famiglia Gemini Pro, Flash e Flash-Lite su Auto o su qualsiasi modello del catalogo, per esempio un modello Qwen o GLM.

Quali sono i limiti del piano gratuito dell'API Gemini?

Google fissa i limiti per progetto, non per chiave, e mostra i valori attuali in Google AI Studio. La tabella di questa pagina mostra i modelli Gemini gratuiti di oggi e i loro limiti dal catalogo FreeLLMAPI.

Perché ottengo «Invalid auth method selected»?

Una segnalazione su Gemini CLI riporta questo errore nella versione 0.44.x quando si usa GOOGLE_API_KEY con GOOGLE_GEMINI_BASE_URL. Usa GEMINI_API_KEY e rimuovi GOOGLE_API_KEY.

Guide correlate

Fonti

Tutte le guide · Sfoglia tutti i modelli gratuiti