Home / Gidsen / Gemini CLI met een eigen eindpunt en gratis modellen

Gemini CLI met een eigen eindpunt en gratis modellen

Gemini CLI is de open-source coderingsagent van Google voor de terminal. Het kan zijn aanvragen naar een eigen basis-URL sturen. Deze gids richt Gemini CLI op FreeLLMAPI, dat de native Gemini API op /v1beta aanbiedt. Uw aanvragen gaan dan naar uw pool van gratis aanbieders, die ook gratis Gemini API-sleutels kan bevatten.

Code, modelnamen en labels uit de live catalogus worden in het Engels getoond.

De wijziging van 2026 voor het gratis niveau van Gemini CLI

Lees dit eerst. Google heeft het gratis gebruik van Gemini CLI in 2026 gewijzigd. De quotapagina van Gemini CLI zegt: "Unpaid tier en Google One-gebruikers: Gemini CLI is op 18 juni 2026 vervangen door Antigravity CLI."

De aankondiging van Google zegt dat Gemini CLI beschikbaar blijft via betaalde Gemini API-sleutels en voor zakelijke klanten.

  • Google-login op het gratis niveau: wordt niet meer aangeboden door Gemini CLI voor consumentenaccounts.
  • Gemini API-sleutel met een eigen basis-URL: de configuratiereferentie van Gemini CLI documenteert nog steeds GOOGLE_GEMINI_BASE_URL. Met deze variabele stuurt Gemini CLI zijn aanvragen naar de URL die u instelt, niet naar Google.
  • Gratis Gemini API-sleutels: Google AI Studio vermeldt nog steeds een gratis niveau voor de Gemini API. FreeLLMAPI kan die sleutels gebruiken, samen met sleutels van andere aanbieders.

Deze gids gebruikt de tweede methode. FreeLLMAPI beantwoordt de aanvragen en stuurt elke aanvraag naar een gratis model in uw pool.

Stap 1: FreeLLMAPI en Gemini CLI installeren

Installeer beide

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

Open http://localhost:3001. Voeg op de pagina Keys minstens twee sleutels van gratis aanbieders toe. Een gratis Google AI Studio-sleutel is een goede eerste sleutel. Kopieer uw gecombineerde sleutel van dezelfde pagina.

Stap 2: Gemini CLI naar de gateway laten wijzen

Stel twee omgevingsvariabelen in en start Gemini CLI. De basis-URL is de oorsprong van de server, zonder /v1beta. Gemini CLI voegt het API-pad zelf toe.

macOS of 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

Wanneer Gemini CLI om een authenticatiemethode vraagt, selecteert u Use Gemini API key. Om de keuze op te slaan, stelt u die in in ~/.gemini/settings.json:

~/.gemini/settings.json

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
Belangrijk: gebruik GEMINI_API_KEY. Een probleem in Gemini CLI meldt dat versie 0.44.x faalt met "Invalid auth method selected" wanneer GOOGLE_API_KEY wordt gebruikt met GOOGLE_GEMINI_BASE_URL. Als GOOGLE_API_KEY is ingesteld, verwijdert u die met unset GOOGLE_API_KEY.

Stap 3: Gemini-modelnamen koppelen aan gratis modellen

Gemini CLI vraagt om Gemini-modelnamen, bijvoorbeeld gemini-2.5-flash. FreeLLMAPI stuurt deze namen niet rechtstreeks naar Google. Het zet ze om via de Gemini-familiekaart op het tabblad Keys, Agents. Koppel elke familie (Pro, Flash en Flash-Lite) aan Auto of aan een vastgezet model uit de catalogus.

  • Met Auto kiest de router voor elke aanvraag een gratis model. Wanneer één aanbieder een 429-fout stuurt, probeert de router de volgende.
  • Model-ID's uit de catalogus werken ook als modelnamen. Start Gemini CLI met gemini -m <catalog-id>, of stel GEMINI_MODEL in.
  • Gemini CLI is een agent met tools. Koppel de families aan modellen met tool-aanroepen en een groot contextvenster.

De eerste tabel toont de gratis Gemini-modellen in de catalogus van nu. De tweede tabel toont andere gratis modellen die u aan een Gemini-familie kunt koppelen.

Gratis Gemini API-modellen met tool-aanroepen (Google AI Studio)
ModelGratis opContextGratis limieten (beste aanbod)ToolsVision
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaJaJa
Gemini Flash (latest alias)Google AI Studio-10 aanvragen/min
20 aanvragen/dag
250,000 tokens/min
~3M
JaJa
Gemini 3.7 FlashGoogle AI Studio1M10 aanvragen/min
20 aanvragen/dag
250,000 tokens/min
~3M
JaJa
Gemini 3.6 FlashGoogle AI Studio1M10 aanvragen/min
20 aanvragen/dag
250,000 tokens/min
~3M
JaJa
Gemini 3.5 FlashGoogle AI Studio1M10 aanvragen/min
20 aanvragen/dag
250,000 tokens/min
~3M
JaJa
Gemini 3.8 LiveGoogle AI Studio-10 aanvragen/min
20 aanvragen/dag
250,000 tokens/min
~3M
JaJa
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 aanvragen/min
20 aanvragen/dag
250,000 tokens/min
~3M
JaJa
Gemini 3.5 Flash LiteGoogle AI Studio1M15 aanvragen/min
20 aanvragen/dag
250,000 tokens/min
~3M
JaJa

Toont 8 van 14 overeenkomende gratis modellen. Bekijk alle modellen.

Actuele gegevens uit de FreeLLMAPI-catalogus (versie 2026.11.19, gecontroleerd 2026-11-19). Gratis limieten veranderen vaak. De catalogus wordt elke dag gecontroleerd.

Andere gratis modellen voor Gemini CLI: tool-aanroepen en 128K+ context
ModelGratis opContextGratis limieten (beste aanbod)ToolsVision
GLM 5.3UnoRouter1M1 aanvragen/min
1 req/min per model
JaNee
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 aanvragen/min
40 RPM
JaJa
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceJaNee
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditJaJa
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditJaJa
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 aanvragen/min
50 aanvragen/dag
50 req/day account-wide (1,000 after a $10 purchase)
JaJa
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 aanvragen/min
50 aanvragen/dag
Shared rate limit
JaNee
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 aanvragen/min
250 aanvragen/dag
70,000 tokens/min
~6M
JaJa

Toont 8 van 104 overeenkomende gratis modellen. Bekijk alle modellen.

Actuele gegevens uit de FreeLLMAPI-catalogus (versie 2026.11.19, gecontroleerd 2026-11-19). Gratis limieten veranderen vaak. De catalogus wordt elke dag gecontroleerd.

Limieten van het gratis niveau van Gemini

De pagina over snelheidslimieten van Google zegt dat limieten gelden per project, niet per API-sleutel. Meer sleutels in één project geven geen extra quota. Google zegt ook dat limieten niet gegarandeerd zijn, en dat u uw huidige limieten kunt zien in Google AI Studio. Previewmodellen hebben lagere limieten.

Een gratis Gemini Flash-sleutel staat weinig aanvragen per dag toe. Eén taak in Gemini CLI kan veel aanvragen sturen. Voeg sleutels van andere aanbieders toe, zodat de router kan doorgaan wanneer het Gemini-quota stopt. Het native oppervlak ondersteunt generateContent, streamGenerateContent met ?alt=sse, countTokens en de lijst met modellen.

FreeLLMAPI accepteert de sleutel in de header x-goog-api-key, als Bearer-token of in de queryparameter ?key= van Gemini. Gebruik bij voorkeur een header, omdat een sleutel in een URL in de shellgeschiedenis en in proxylogboeken kan terechtkomen.

Probleemoplossing

ProbleemOorzaakOplossing
Gemini CLI opent een Google-loginHet authenticatietype staat niet op Gemini API-sleutelSelecteer Use Gemini API key, of stel security.auth.selectedType in
"Invalid auth method selected"GOOGLE_API_KEY wordt gebruikt met een eigen basis-URLGebruik GEMINI_API_KEY en verwijder GOOGLE_API_KEY met unset
Aanvragen gaan naar Google, niet naar de gatewayGOOGLE_GEMINI_BASE_URL is niet ingesteld in deze shellExporteer de variabele en start gemini opnieuw
404 bij modelaanroepenDe basis-URL bevat /v1betaGebruik alleen de oorsprong http://localhost:3001
Toolaanroepen mislukkenDe Gemini-familie is gekoppeld aan een model met zwakke tool-aanroepenKoppel de familie aan een model uit de tabellen hierboven
"Alle modellen hebben de snelheidslimiet bereikt na N pogingen"Alle sleutels hebben hun limiet bereiktVoeg sleutels van meer aanbieders toe, of wacht tot de cooldowns voorbij zijn
Gebruik elk van deze met één sleutel. FreeLLMAPI is een open-source router die u zelf host. Die zet al deze gratis tarieven achter één eindpunt dat compatibel is met OpenAI. Bij een snelheidslimiet schakelt de router automatisch over. Bekijk de catalogus of live gaan.

Veelgestelde vragen

Is Gemini CLI nog steeds gratis?

Google heeft het gratis gebruik van Gemini CLI met een Google-login beëindigd voor unpaid- en Google One-gebruikers, op 18 juni 2026. De CLI ondersteunt nog steeds een eigen basis-URL, dus hij kan draaien op een gratis gateway zoals FreeLLMAPI.

Hoe gebruik ik Gemini CLI met een eigen eindpunt?

Stel GOOGLE_GEMINI_BASE_URL in op de oorsprong van het eindpunt en GEMINI_API_KEY op de sleutel ervan. Selecteer daarna Use Gemini API key. Het eindpunt moet de native Gemini API op /v1beta spreken.

Kan Gemini CLI modellen gebruiken die geen Gemini-modellen zijn?

Ja, via FreeLLMAPI. De gateway koppelt de familienamen Gemini Pro, Flash en Flash-Lite aan Auto of aan elk model uit de catalogus, bijvoorbeeld een Qwen- of GLM-model.

Wat zijn de limieten van het gratis niveau van de Gemini API?

Google stelt de limieten in per project, niet per sleutel, en toont de huidige waarden in Google AI Studio. De tabel op deze pagina toont de gratis Gemini-modellen van nu en hun limieten uit de FreeLLMAPI-catalogus.

Waarom krijg ik 'Invalid auth method selected'?

Een probleem in Gemini CLI meldt deze fout in versie 0.44.x wanneer GOOGLE_API_KEY wordt gebruikt met GOOGLE_GEMINI_BASE_URL. Gebruik GEMINI_API_KEY en verwijder GOOGLE_API_KEY met unset.

Gerelateerde gidsen

Bronnen

Alle gidsen · Bekijk alle gratis modellen