Gemini CLI cu endpoint personalizat și modele gratuite
Gemini CLI este agentul open-source de programare al Google, pentru terminal. Poate trimite cererile către un URL de bază personalizat. Acest ghid trimite Gemini CLI către FreeLLMAPI, care servește API-ul nativ Gemini pe /v1beta. Cererile dumneavoastră ajung apoi la grupul dumneavoastră de furnizori gratuiți, care pot include chei gratuite pentru API-ul Gemini.
Codul, numele modelelor și etichetele live din catalog sunt afișate în engleză.
Schimbarea din 2026 a nivelului gratuit Gemini CLI
Citiți mai întâi aceasta. Google a schimbat uzul gratuit al Gemini CLI în 2026. Pagina de cote Gemini CLI spune: "Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI on June 18th, 2026."
Anunțul Google spune că Gemini CLI rămâne disponibil prin chei API Gemini plătite și pentru clienții enterprise.
- Autentificare Google la nivelul gratuit: nu mai este servită de Gemini CLI pentru conturile de consum.
- Cheie API Gemini cu URL de bază personalizat: documentația de configurare Gemini CLI încă descrie
GOOGLE_GEMINI_BASE_URL. Cu această variabilă, Gemini CLI trimite cererile la URL-ul pe care îl setați, nu la Google. - Chei API Gemini gratuite: Google AI Studio încă listează un nivel gratuit pentru API-ul Gemini. FreeLLMAPI poate folosi aceste chei, împreună cu chei de la alți furnizori.
Acest ghid folosește a doua metodă. FreeLLMAPI răspunde la cereri și trimite fiecare cerere la un model gratuit din grupul dumneavoastră.
Pasul 1: Instalați FreeLLMAPI și Gemini CLI
Instalați ambele
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @google/gemini-cliDeschideți http://localhost:3001. Adăugați cel puțin două chei de furnizori gratuiți pe pagina Keys. O cheie gratuită Google AI Studio este o primă cheie bună. Copiați cheia unificată de pe aceeași pagină.
Pasul 2: Trimiteți Gemini CLI către gateway
Setați două variabile de mediu și porniți Gemini CLI. URL-ul de bază este originea serverului, fără /v1beta. Gemini CLI adaugă singur calea API.
macOS sau Linux
export GOOGLE_GEMINI_BASE_URL=http://localhost:3001
export GEMINI_API_KEY=<unified-key>
geminiWindows PowerShell
$env:GOOGLE_GEMINI_BASE_URL="http://localhost:3001"
$env:GEMINI_API_KEY="<unified-key>"
geminiCând Gemini CLI cere o metodă de autentificare, selectați Use Gemini API key. Pentru a salva alegerea, setați-o în ~/.gemini/settings.json:
~/.gemini/settings.json
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}GEMINI_API_KEY. Un raport despre Gemini CLI arată că versiunea 0.44.x eșuează cu "Invalid auth method selected" când se folosește GOOGLE_API_KEY împreună cu GOOGLE_GEMINI_BASE_URL. Dacă GOOGLE_API_KEY este setată, eliminați-o cu unset GOOGLE_API_KEY.Pasul 3: Corelați numele modelelor Gemini cu modele gratuite
Gemini CLI cere nume de modele Gemini, de exemplu gemini-2.5-flash. FreeLLMAPI nu trimite aceste nume direct la Google. Le rezolvă prin harta familiilor Gemini din fila Keys, Agents. Corelați fiecare familie (Pro, Flash și Flash-Lite) cu Auto sau cu un model fixat din catalog.
- Cu Auto, routerul alege un model gratuit pentru fiecare cerere. Când un furnizor trimite eroarea 429, încearcă următorul.
- ID-urile din catalog funcționează și ca nume de model. Porniți Gemini CLI cu
gemini -m <catalog-id>sau setațiGEMINI_MODEL. - Gemini CLI este un agent cu instrumente. Corelați familiile cu modele care acceptă apelarea de instrumente și au o fereastră mare de context.
Primul tabel arată modelele gratuite Gemini din catalog astăzi. Al doilea tabel arată alte modele gratuite pe care le puteți corela cu o familie Gemini.
| Model | Gratuit pe | Context | Limite gratuite (cea mai bună ofertă) | Instrumente | Viziune |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Da | Da |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
| Gemini 3.8 Live | Google AI Studio | - | 10 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 cereri/min 20 cereri/zi 250,000 tokeni/min ~3M | Da | Da |
Se afișează 8 din 14 modele gratuite care se potrivesc. Vezi toate modelele.
Date live din catalogul FreeLLMAPI (versiunea 2026.11.19, verificat 2026-11-19). Limitele gratuite se schimbă des. Catalogul este verificat în fiecare zi.
| Model | Gratuit pe | Context | Limite gratuite (cea mai bună ofertă) | Instrumente | Viziune |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 cereri/min 1 req/min per model | Da | Nu |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 cereri/min 40 RPM | Da | Da |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Da | Nu |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Da | Da |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Da | Da |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 cereri/min 50 cereri/zi 50 req/day account-wide (1,000 after a $10 purchase) | Da | Da |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 cereri/min 50 cereri/zi Shared rate limit | Da | Nu |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 cereri/min 250 cereri/zi 70,000 tokeni/min ~6M | Da | Da |
Se afișează 8 din 104 modele gratuite care se potrivesc. Vezi toate modelele.
Date live din catalogul FreeLLMAPI (versiunea 2026.11.19, verificat 2026-11-19). Limitele gratuite se schimbă des. Catalogul este verificat în fiecare zi.
Limitele nivelului gratuit Gemini
Pagina Google cu limitele de rată spune că limitele se aplică pe proiect, nu pe cheie API. Mai multe chei în același proiect nu dau mai multă cotă. Google mai spune că limitele nu sunt garantate și că puteți vedea limitele actuale în Google AI Studio. Modelele în previzualizare au limite mai mici.
O cheie gratuită Gemini Flash permite puține cereri pe zi. O sarcină Gemini CLI poate trimite multe cereri. Adăugați chei de la alți furnizori, astfel încât routerul să poată continua când cota Gemini se epuizează. Suprafața nativă acceptă generateContent, streamGenerateContent cu ?alt=sse, countTokens și lista de modele.
FreeLLMAPI acceptă cheia în antetul x-goog-api-key, ca token Bearer sau în parametrul de interogare ?key= al Gemini. Preferați un antet, deoarece o cheie dintr-un URL poate ajunge în istoricul shell-ului și în jurnalele proxy.
Depanare
| Problemă | Cauză | Soluție |
|---|---|---|
| Gemini CLI deschide o autentificare Google | Tipul de autentificare nu este setat la Gemini API key | Selectați Use Gemini API key sau setați security.auth.selectedType |
| "Invalid auth method selected" | GOOGLE_API_KEY este folosită cu un URL de bază personalizat | Folosiți GEMINI_API_KEY și faceți unset la GOOGLE_API_KEY |
| Cererile merg la Google, nu la gateway | GOOGLE_GEMINI_BASE_URL nu este setată în acest shell | Exportați variabila, apoi porniți din nou gemini |
404 la apelurile de model | URL-ul de bază include /v1beta | Folosiți doar originea http://localhost:3001 |
| Apelurile de instrumente eșuează | Familia Gemini este corelată cu un model cu apelare slabă de instrumente | Corelați familia cu un model din tabelele de mai sus |
| "Toate modelele au atins limita după N încercări" | Toate cheile sunt la limită | Adăugați chei de la mai mulți furnizori sau așteptați perioadele de pauză |
Întrebări frecvente
Mai este Gemini CLI gratuit?
Google a încheiat uzul gratuit al Gemini CLI cu autentificare Google pentru utilizatorii neplătitori și Google One, la 18 iunie 2026. CLI încă acceptă un URL de bază personalizat, deci poate rula pe un gateway gratuit, precum FreeLLMAPI.
Cum folosesc Gemini CLI cu un endpoint personalizat?
Setați GOOGLE_GEMINI_BASE_URL la originea endpoint-ului și GEMINI_API_KEY la cheia sa, apoi selectați Use Gemini API key. Endpoint-ul trebuie să vorbească API-ul nativ Gemini pe /v1beta.
Poate Gemini CLI să folosească modele care nu sunt Gemini?
Da, prin FreeLLMAPI. Gateway-ul corelează numele familiilor Gemini Pro, Flash și Flash-Lite cu Auto sau cu orice model din catalog, de exemplu un model Qwen sau GLM.
Care sunt limitele nivelului gratuit al API-ului Gemini?
Google stabilește limitele pe proiect, nu pe cheie, și afișează valorile actuale în Google AI Studio. Tabelul de pe această pagină arată modelele Gemini gratuite de astăzi și limitele lor din catalogul FreeLLMAPI.
De ce primesc "Invalid auth method selected"?
Un raport despre Gemini CLI arată această eroare în versiunea 0.44.x, când se folosește GOOGLE_API_KEY împreună cu GOOGLE_GEMINI_BASE_URL. Folosiți GEMINI_API_KEY și faceți unset la GOOGLE_API_KEY.
Ghiduri înrudite
- free gemini api
- Cotă Gemini API depășită (429 RESOURCE_EXHAUSTED)
- Cum folosiți Claude Code gratuit
- Folosiți Codex CLI cu modele gratuite
- Cele mai bune API-uri gratuite pentru modele de cod
Surse
- Gemini CLI docs: configuration reference (verificat 20 November 2026)
- Gemini CLI docs: authentication (verificat 20 November 2026)
- Gemini CLI docs: quota and pricing (verificat 20 November 2026)
- Google Developers Blog: transitioning Gemini CLI to Antigravity CLI (verificat 20 November 2026)
- Gemini CLI issue 27550: auth with a custom base URL (verificat 20 November 2026)
- Google AI Studio: rate limits (verificat 20 November 2026)
- FreeLLMAPI docs: native Gemini API (verificat 20 November 2026)