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-cliOpen 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>
geminiWindows PowerShell
$env:GOOGLE_GEMINI_BASE_URL="http://localhost:3001"
$env:GEMINI_API_KEY="<unified-key>"
geminiWanneer 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"
}
}
}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 stelGEMINI_MODELin. - 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.
| Model | Gratis op | Context | Gratis limieten (beste aanbod) | Tools | Vision |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Ja | Ja |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 aanvragen/min 20 aanvragen/dag 250,000 tokens/min ~3M | Ja | Ja |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 aanvragen/min 20 aanvragen/dag 250,000 tokens/min ~3M | Ja | Ja |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 aanvragen/min 20 aanvragen/dag 250,000 tokens/min ~3M | Ja | Ja |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 aanvragen/min 20 aanvragen/dag 250,000 tokens/min ~3M | Ja | Ja |
| Gemini 3.8 Live | Google AI Studio | - | 10 aanvragen/min 20 aanvragen/dag 250,000 tokens/min ~3M | Ja | Ja |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 aanvragen/min 20 aanvragen/dag 250,000 tokens/min ~3M | Ja | Ja |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 aanvragen/min 20 aanvragen/dag 250,000 tokens/min ~3M | Ja | Ja |
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.
| Model | Gratis op | Context | Gratis limieten (beste aanbod) | Tools | Vision |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 aanvragen/min 1 req/min per model | Ja | Nee |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 aanvragen/min 40 RPM | Ja | Ja |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Ja | Nee |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Ja | Ja |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Ja | Ja |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 aanvragen/min 50 aanvragen/dag 50 req/day account-wide (1,000 after a $10 purchase) | Ja | Ja |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 aanvragen/min 50 aanvragen/dag Shared rate limit | Ja | Nee |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 aanvragen/min 250 aanvragen/dag 70,000 tokens/min ~6M | Ja | Ja |
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
| Probleem | Oorzaak | Oplossing |
|---|---|---|
| Gemini CLI opent een Google-login | Het authenticatietype staat niet op Gemini API-sleutel | Selecteer Use Gemini API key, of stel security.auth.selectedType in |
| "Invalid auth method selected" | GOOGLE_API_KEY wordt gebruikt met een eigen basis-URL | Gebruik GEMINI_API_KEY en verwijder GOOGLE_API_KEY met unset |
| Aanvragen gaan naar Google, niet naar de gateway | GOOGLE_GEMINI_BASE_URL is niet ingesteld in deze shell | Exporteer de variabele en start gemini opnieuw |
404 bij modelaanroepen | De basis-URL bevat /v1beta | Gebruik alleen de oorsprong http://localhost:3001 |
| Toolaanroepen mislukken | De Gemini-familie is gekoppeld aan een model met zwakke tool-aanroepen | Koppel de familie aan een model uit de tabellen hierboven |
| "Alle modellen hebben de snelheidslimiet bereikt na N pogingen" | Alle sleutels hebben hun limiet bereikt | Voeg sleutels van meer aanbieders toe, of wacht tot de cooldowns voorbij zijn |
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
- free gemini api
- Gemini API-quota overschreden (429 RESOURCE_EXHAUSTED)
- Claude Code gratis gebruiken
- Codex CLI gebruiken met gratis modellen
- Beste gratis API's voor codemodellen
Bronnen
- Gemini CLI docs: configuration reference (gecontroleerd 20 November 2026)
- Gemini CLI docs: authentication (gecontroleerd 20 November 2026)
- Gemini CLI docs: quota and pricing (gecontroleerd 20 November 2026)
- Google Developers Blog: transitioning Gemini CLI to Antigravity CLI (gecontroleerd 20 November 2026)
- Gemini CLI issue 27550: auth with a custom base URL (gecontroleerd 20 November 2026)
- Google AI Studio: rate limits (gecontroleerd 20 November 2026)
- FreeLLMAPI docs: native Gemini API (gecontroleerd 20 November 2026)