Gemini CLI z własnym punktem końcowym i darmowymi modelami
Gemini CLI to open-source agent do kodowania od Google, działający w terminalu. Może wysyłać żądania na własny adres bazowy. Ten poradnik kieruje Gemini CLI na FreeLLMAPI, który udostępnia natywne API Gemini pod /v1beta. Twoje żądania trafiają wtedy do Twojej puli darmowych dostawców, która może zawierać darmowe klucze API Gemini.
Kod, nazwy modeli i etykiety z katalogu na żywo są podane po angielsku.
Zmiana darmowego planu Gemini CLI w 2026
Najpierw przeczytaj to. Google zmieniło darmowe użycie Gemini CLI w 2026. Strona limitów Gemini CLI mówi: "Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI on June 18th, 2026."
Ogłoszenie Google mówi, że Gemini CLI pozostaje dostępne przez płatne klucze API Gemini oraz dla klientów korporacyjnych.
- Logowanie Google w darmowym planie: nie jest już obsługiwane przez Gemini CLI dla kont konsumenckich.
- Klucz API Gemini z własnym adresem bazowym: dokumentacja konfiguracji Gemini CLI nadal opisuje
GOOGLE_GEMINI_BASE_URL. Z tą zmienną Gemini CLI wysyła żądania na adres, który ustawisz, a nie do Google. - Darmowe klucze API Gemini: Google AI Studio nadal wymienia darmowy plan dla API Gemini. FreeLLMAPI może używać tych kluczy razem z kluczami innych dostawców.
Ten poradnik używa drugiej metody. FreeLLMAPI odpowiada na żądania i wysyła każde z nich do darmowego modelu z Twojej puli.
Krok 1: zainstaluj FreeLLMAPI i Gemini CLI
Zainstaluj oba
curl -fsSL https://freellmapi.co/install.sh | bash
npm install -g @google/gemini-cliOtwórz http://localhost:3001. Na stronie Keys dodaj co najmniej dwa klucze darmowych dostawców. Dobrym pierwszym kluczem jest darmowy klucz Google AI Studio. Skopiuj swój wspólny klucz z tej samej strony.
Krok 2: skieruj Gemini CLI na bramę
Ustaw dwie zmienne środowiskowe i uruchom Gemini CLI. Adres bazowy to adres serwera bez /v1beta. Gemini CLI dodaje ścieżkę API samo.
macOS lub 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>"
geminiGdy Gemini CLI zapyta o metodę uwierzytelniania, wybierz Use Gemini API key. Aby zapisać wybór, ustaw go w ~/.gemini/settings.json:
~/.gemini/settings.json
{
"security": {
"auth": {
"selectedType": "gemini-api-key"
}
}
}GEMINI_API_KEY. Zgłoszenie w Gemini CLI podaje, że wersja 0.44.x kończy się błędem "Invalid auth method selected", gdy GOOGLE_API_KEY jest użyty z GOOGLE_GEMINI_BASE_URL. Jeśli GOOGLE_API_KEY jest ustawiony, usuń go poleceniem unset GOOGLE_API_KEY.Krok 3: zmapuj nazwy modeli Gemini na darmowe modele
Gemini CLI prosi o nazwy modeli Gemini, na przykład gemini-2.5-flash. FreeLLMAPI nie wysyła tych nazw bezpośrednio do Google. Rozwiązuje je przez mapę rodzin Gemini na karcie Keys, Agents. Zmapuj każdą rodzinę (Pro, Flash i Flash-Lite) na Auto albo na przypięty model z katalogu.
- Przy Auto router wybiera darmowy model dla każdego żądania. Gdy jeden dostawca wyśle błąd 429, próbuje następnego.
- Identyfikatory z katalogu też działają jako nazwy modeli. Uruchom Gemini CLI poleceniem
gemini -m <catalog-id>albo ustawGEMINI_MODEL. - Gemini CLI to agent z narzędziami. Mapuj rodziny na modele z wywoływaniem narzędzi i dużym oknem kontekstu.
Pierwsza tabela pokazuje dzisiaj darmowe modele Gemini w katalogu. Druga tabela pokazuje inne darmowe modele, które możesz zmapować na rodzinę Gemini.
| Model | Za darmo w | Kontekst | Darmowe limity (najlepsza oferta) | Narzędzia | Wizja |
|---|---|---|---|---|---|
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Tak | Tak |
| Gemini Flash (latest alias) | Google AI Studio | - | 10 żądań/min 20 żądań/dzień 250,000 tokenów/min ~3M | Tak | Tak |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 żądań/min 20 żądań/dzień 250,000 tokenów/min ~3M | Tak | Tak |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 żądań/min 20 żądań/dzień 250,000 tokenów/min ~3M | Tak | Tak |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 żądań/min 20 żądań/dzień 250,000 tokenów/min ~3M | Tak | Tak |
| Gemini 3.8 Live | Google AI Studio | - | 10 żądań/min 20 żądań/dzień 250,000 tokenów/min ~3M | Tak | Tak |
| Gemini 3.8 Live Extended Thinking | Google AI Studio | - | 10 żądań/min 20 żądań/dzień 250,000 tokenów/min ~3M | Tak | Tak |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 żądań/min 20 żądań/dzień 250,000 tokenów/min ~3M | Tak | Tak |
Pokazano 8 z 14 pasujących darmowych modeli. Zobacz wszystkie modele.
Dane na żywo z katalogu FreeLLMAPI (wersja 2026.11.19, sprawdzono 2026-11-19). Darmowe limity często się zmieniają. Katalog jest sprawdzany codziennie.
| Model | Za darmo w | Kontekst | Darmowe limity (najlepsza oferta) | Narzędzia | Wizja |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 żądań/min 1 req/min per model | Tak | Nie |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 żądań/min 40 RPM | Tak | Tak |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Tak | Nie |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Tak | Tak |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Tak | Tak |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 żądań/min 50 żądań/dzień 50 req/day account-wide (1,000 after a $10 purchase) | Tak | Tak |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 żądań/min 50 żądań/dzień Shared rate limit | Tak | Nie |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 żądań/min 250 żądań/dzień 70,000 tokenów/min ~6M | Tak | Tak |
Pokazano 8 z 104 pasujących darmowych modeli. Zobacz wszystkie modele.
Dane na żywo z katalogu FreeLLMAPI (wersja 2026.11.19, sprawdzono 2026-11-19). Darmowe limity często się zmieniają. Katalog jest sprawdzany codziennie.
Darmowe limity planu Gemini
Strona limitów Google mówi, że limity obowiązują na projekt, a nie na klucz API. Więcej kluczy w jednym projekcie nie daje większego limitu. Google podaje też, że limity nie są gwarantowane, a aktualne limity zobaczysz w Google AI Studio. Modele w wersji podglądowej mają niższe limity.
Darmowy klucz Gemini Flash pozwala na kilka żądań dziennie. Jedno zadanie Gemini CLI może wysłać wiele żądań. Dodaj klucze od innych dostawców, aby router mógł działać dalej, gdy limit Gemini się wyczerpie. Natywny interfejs obsługuje generateContent, streamGenerateContent z ?alt=sse, countTokens oraz listę modeli.
FreeLLMAPI przyjmuje klucz w nagłówku x-goog-api-key, jako token Bearer albo w parametrze zapytania ?key= w stylu Gemini. Preferuj nagłówek, bo klucz w adresie URL może trafić do historii powłoki i logów proxy.
Rozwiązywanie problemów
| Problem | Przyczyna | Rozwiązanie |
|---|---|---|
| Gemini CLI otwiera logowanie Google | Typ uwierzytelniania nie jest ustawiony na klucz API Gemini | Wybierz Use Gemini API key albo ustaw security.auth.selectedType |
| "Invalid auth method selected" | GOOGLE_API_KEY jest użyty z własnym adresem bazowym | Użyj GEMINI_API_KEY i usuń zmienną GOOGLE_API_KEY |
| Żądania idą do Google, a nie do bramy | GOOGLE_GEMINI_BASE_URL nie jest ustawiony w tej powłoce | Wyeksportuj zmienną i uruchom gemini ponownie |
404 przy wywołaniach modeli | Adres bazowy zawiera /v1beta | Używaj tylko adresu http://localhost:3001 |
| Wywołania narzędzi nie działają | Rodzina Gemini jest zmapowana na model o słabym wywoływaniu narzędzi | Zmapuj rodzinę na model z tabel powyżej |
| "Wszystkie modele osiągnęły limit po N próbach" | Wszystkie klucze są na limicie | Dodaj klucze od większej liczby dostawców albo poczekaj na przerwy po błędach |
Najczęstsze pytania
Czy Gemini CLI nadal jest darmowe?
Google zakończyło darmowe użycie Gemini CLI z logowaniem Google dla użytkowników bez płatnego planu i użytkowników Google One 18 czerwca 2026. CLI nadal obsługuje własny adres bazowy, więc może działać na darmowej bramie, takiej jak FreeLLMAPI.
Jak używać Gemini CLI z własnym punktem końcowym?
Ustaw GOOGLE_GEMINI_BASE_URL na adres punktu końcowego, a GEMINI_API_KEY na jego klucz, potem wybierz Use Gemini API key. Punkt końcowy musi obsługiwać natywne API Gemini pod /v1beta.
Czy Gemini CLI może używać modeli, które nie są Gemini?
Tak, przez FreeLLMAPI. Brama mapuje nazwy rodzin Gemini Pro, Flash i Flash-Lite na Auto albo na dowolny model z katalogu, na przykład model Qwen lub GLM.
Jakie są darmowe limity API Gemini?
Google ustawia limity na projekt, a nie na klucz, i pokazuje aktualne wartości w Google AI Studio. Tabela na tej stronie pokazuje dzisiejsze darmowe modele Gemini i ich limity z katalogu FreeLLMAPI.
Dlaczego widzę 'Invalid auth method selected'?
Zgłoszenie w Gemini CLI podaje ten błąd w wersji 0.44.x, gdy GOOGLE_API_KEY jest użyty z GOOGLE_GEMINI_BASE_URL. Użyj GEMINI_API_KEY i wykonaj unset GOOGLE_API_KEY.
Powiązane poradniki
- free gemini api
- Przekroczony limit Gemini API (429 RESOURCE_EXHAUSTED)
- Jak używać Claude Code za darmo
- Codex CLI z darmowymi modelami
- Najlepsze darmowe API modeli do kodowania
Źródła
- Gemini CLI docs: configuration reference (sprawdzono 20 November 2026)
- Gemini CLI docs: authentication (sprawdzono 20 November 2026)
- Gemini CLI docs: quota and pricing (sprawdzono 20 November 2026)
- Google Developers Blog: transitioning Gemini CLI to Antigravity CLI (sprawdzono 20 November 2026)
- Gemini CLI issue 27550: auth with a custom base URL (sprawdzono 20 November 2026)
- Google AI Studio: rate limits (sprawdzono 20 November 2026)
- FreeLLMAPI docs: native Gemini API (sprawdzono 20 November 2026)