Strona główna / Poradniki / Gemini CLI z własnym punktem końcowym i darmowymi modelami

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

Otwó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>
gemini

Windows PowerShell

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

Gdy 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"
    }
  }
}
Ważne: użyj 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 ustaw GEMINI_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.

Darmowe modele API Gemini z wywoływaniem narzędzi (Google AI Studio)
ModelZa darmo wKontekstDarmowe limity (najlepsza oferta)NarzędziaWizja
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaTakTak
Gemini Flash (latest alias)Google AI Studio-10 żądań/min
20 żądań/dzień
250,000 tokenów/min
~3M
TakTak
Gemini 3.7 FlashGoogle AI Studio1M10 żądań/min
20 żądań/dzień
250,000 tokenów/min
~3M
TakTak
Gemini 3.6 FlashGoogle AI Studio1M10 żądań/min
20 żądań/dzień
250,000 tokenów/min
~3M
TakTak
Gemini 3.5 FlashGoogle AI Studio1M10 żądań/min
20 żądań/dzień
250,000 tokenów/min
~3M
TakTak
Gemini 3.8 LiveGoogle AI Studio-10 żądań/min
20 żądań/dzień
250,000 tokenów/min
~3M
TakTak
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 żądań/min
20 żądań/dzień
250,000 tokenów/min
~3M
TakTak
Gemini 3.5 Flash LiteGoogle AI Studio1M15 żądań/min
20 żądań/dzień
250,000 tokenów/min
~3M
TakTak

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.

Inne darmowe modele dla Gemini CLI: wywoływanie narzędzi i kontekst 128K+
ModelZa darmo wKontekstDarmowe limity (najlepsza oferta)NarzędziaWizja
GLM 5.3UnoRouter1M1 żądań/min
1 req/min per model
TakNie
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 żądań/min
40 RPM
TakTak
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceTakNie
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditTakTak
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditTakTak
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 żądań/min
50 żądań/dzień
50 req/day account-wide (1,000 after a $10 purchase)
TakTak
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 żądań/min
50 żądań/dzień
Shared rate limit
TakNie
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 żądań/min
250 żądań/dzień
70,000 tokenów/min
~6M
TakTak

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

ProblemPrzyczynaRozwiązanie
Gemini CLI otwiera logowanie GoogleTyp uwierzytelniania nie jest ustawiony na klucz API GeminiWybierz Use Gemini API key albo ustaw security.auth.selectedType
"Invalid auth method selected"GOOGLE_API_KEY jest użyty z własnym adresem bazowymUżyj GEMINI_API_KEY i usuń zmienną GOOGLE_API_KEY
Żądania idą do Google, a nie do bramyGOOGLE_GEMINI_BASE_URL nie jest ustawiony w tej powłoceWyeksportuj zmienną i uruchom gemini ponownie
404 przy wywołaniach modeliAdres bazowy zawiera /v1betaUż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ędziZmapuj rodzinę na model z tabel powyżej
"Wszystkie modele osiągnęły limit po N próbach"Wszystkie klucze są na limicieDodaj klucze od większej liczby dostawców albo poczekaj na przerwy po błędach
Używaj wszystkich tych modeli przez jeden klucz. FreeLLMAPI to router o otwartym kodzie, uruchamiany na własnym serwerze. Łączy wszystkie te darmowe plany za jednym punktem końcowym zgodnym z OpenAI i przełącza się na inny dostawcę, gdy limit zostanie przekroczony. Przeglądaj katalog lub uruchom.

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

Źródła

Wszystkie poradniki · Przeglądaj wszystkie darmowe modele