Acasă / Ghiduri / Gemini CLI cu endpoint personalizat și modele gratuite

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-cli

Deschideț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>
gemini

Windows PowerShell

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

Câ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"
    }
  }
}
Important: folosiți 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ți GEMINI_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.

Modele gratuite API Gemini cu apelare de instrumente (Google AI Studio)
ModelGratuit peContextLimite gratuite (cea mai bună ofertă)InstrumenteViziune
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaDaDa
Gemini Flash (latest alias)Google AI Studio-10 cereri/min
20 cereri/zi
250,000 tokeni/min
~3M
DaDa
Gemini 3.7 FlashGoogle AI Studio1M10 cereri/min
20 cereri/zi
250,000 tokeni/min
~3M
DaDa
Gemini 3.6 FlashGoogle AI Studio1M10 cereri/min
20 cereri/zi
250,000 tokeni/min
~3M
DaDa
Gemini 3.5 FlashGoogle AI Studio1M10 cereri/min
20 cereri/zi
250,000 tokeni/min
~3M
DaDa
Gemini 3.8 LiveGoogle AI Studio-10 cereri/min
20 cereri/zi
250,000 tokeni/min
~3M
DaDa
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 cereri/min
20 cereri/zi
250,000 tokeni/min
~3M
DaDa
Gemini 3.5 Flash LiteGoogle AI Studio1M15 cereri/min
20 cereri/zi
250,000 tokeni/min
~3M
DaDa

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.

Alte modele gratuite pentru Gemini CLI: apelare de instrumente și context de 128K+
ModelGratuit peContextLimite gratuite (cea mai bună ofertă)InstrumenteViziune
GLM 5.3UnoRouter1M1 cereri/min
1 req/min per model
DaNu
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 cereri/min
40 RPM
DaDa
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceDaNu
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditDaDa
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditDaDa
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 cereri/min
50 cereri/zi
50 req/day account-wide (1,000 after a $10 purchase)
DaDa
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 cereri/min
50 cereri/zi
Shared rate limit
DaNu
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 cereri/min
250 cereri/zi
70,000 tokeni/min
~6M
DaDa

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 GoogleTipul de autentificare nu este setat la Gemini API keySelectaț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ă personalizatFolosiți GEMINI_API_KEY și faceți unset la GOOGLE_API_KEY
Cererile merg la Google, nu la gatewayGOOGLE_GEMINI_BASE_URL nu este setată în acest shellExportați variabila, apoi porniți din nou gemini
404 la apelurile de modelURL-ul de bază include /v1betaFolosiți doar originea http://localhost:3001
Apelurile de instrumente eșueazăFamilia Gemini este corelată cu un model cu apelare slabă de instrumenteCorelaț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ă
Folosiți fiecare dintre aceste modele printr-o singură cheie. FreeLLMAPI este un router open-source, găzduit de dumneavoastră, care pune toate aceste niveluri gratuite în spatele unui singur endpoint compatibil cu OpenAI și trece la alt furnizor când un furnizor este limitat la rată. Vezi catalogul sau trece live.

Î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

Surse

Toate ghidurile · Vezi toate modelele gratuite