Startseite / Anleitungen / Gemini CLI mit eigenem Endpunkt und kostenlosen Modellen

Gemini CLI mit eigenem Endpunkt und kostenlosen Modellen

Gemini CLI ist der Open-Source-Coding-Agent von Google für das Terminal. Er kann seine Anfragen an eine eigene Basis-URL senden. Diese Anleitung richtet Gemini CLI auf FreeLLMAPI aus, das die native Gemini API unter /v1beta bereitstellt. Ihre Anfragen gehen dann an Ihren Pool kostenloser Anbieter, zu dem auch kostenlose Gemini-API-Schlüssel gehören können.

Code, Modellnamen und Bezeichnungen aus dem Live-Katalog werden auf Englisch angezeigt.

Die Änderung des kostenlosen Angebots von Gemini CLI im Jahr 2026

Lesen Sie dies zuerst. Google hat die kostenlose Nutzung von Gemini CLI im Jahr 2026 geändert. Die Quota-Seite von Gemini CLI sagt: „Unpaid tier and Google One users: Gemini CLI was replaced by Antigravity CLI on June 18th, 2026.“

Die Ankündigung von Google sagt, dass Gemini CLI über kostenpflichtige Gemini-API-Schlüssel und für Enterprise-Kunden verfügbar bleibt.

  • Google-Anmeldung im kostenlosen Angebot: Für Verbraucherkonten wird Gemini CLI nicht mehr bereitgestellt.
  • Gemini-API-Schlüssel mit eigener Basis-URL: Die Konfigurationsreferenz von Gemini CLI dokumentiert weiterhin GOOGLE_GEMINI_BASE_URL. Mit dieser Variable sendet Gemini CLI seine Anfragen an die URL, die Sie setzen, nicht an Google.
  • Kostenlose Gemini-API-Schlüssel: Google AI Studio listet weiterhin ein kostenloses Angebot für die Gemini API. FreeLLMAPI kann diese Schlüssel zusammen mit Schlüsseln anderer Anbieter nutzen.

Diese Anleitung verwendet die zweite Methode. FreeLLMAPI beantwortet die Anfragen und sendet jede an ein kostenloses Modell in Ihrem Pool.

Schritt 1: FreeLLMAPI und Gemini CLI installieren

Beides installieren

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

Öffnen Sie http://localhost:3001. Fügen Sie auf der Seite Keys mindestens zwei kostenlose Anbieterschlüssel hinzu. Ein kostenloser Schlüssel von Google AI Studio ist ein guter erster Schlüssel. Kopieren Sie Ihren einheitlichen Schlüssel von derselben Seite.

Schritt 2: Gemini CLI auf das Gateway richten

Setzen Sie zwei Umgebungsvariablen und starten Sie Gemini CLI. Die Basis-URL ist der Server-Ursprung ohne /v1beta. Gemini CLI ergänzt den API-Pfad selbst.

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

Wenn Gemini CLI nach einer Authentifizierungsmethode fragt, wählen Sie Use Gemini API key. Um die Wahl zu speichern, setzen Sie sie in ~/.gemini/settings.json:

~/.gemini/settings.json

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}
Wichtig: Verwenden Sie GEMINI_API_KEY. Ein Problem in Gemini CLI berichtet, dass Version 0.44.x mit der Meldung „Invalid auth method selected“ fehlschlägt, wenn GOOGLE_API_KEY zusammen mit GOOGLE_GEMINI_BASE_URL verwendet wird. Ist GOOGLE_API_KEY gesetzt, entfernen Sie es mit unset GOOGLE_API_KEY.

Schritt 3: Gemini-Modellnamen auf kostenlose Modelle abbilden

Gemini CLI fragt nach Gemini-Modellnamen, zum Beispiel gemini-2.5-flash. FreeLLMAPI sendet diese Namen nicht direkt an Google. Es löst sie über die Zuordnung der Gemini-Familien auf dem Tab Keys, Agents auf. Ordnen Sie jede Familie (Pro, Flash und Flash-Lite) Auto oder einem festgelegten Katalogmodell zu.

  • Mit Auto wählt der Router für jede Anfrage ein kostenloses Modell aus. Sendet ein Anbieter den Fehler 429, versucht der Router den nächsten.
  • Katalog-IDs funktionieren auch als Modellnamen. Starten Sie Gemini CLI mit gemini -m <catalog-id> oder setzen Sie GEMINI_MODEL.
  • Gemini CLI ist ein Agent mit Tools. Ordnen Sie die Familien Modellen mit Tool-Aufrufen und großem Kontextfenster zu.

Die erste Tabelle zeigt die heute im Katalog enthaltenen kostenlosen Gemini-Modelle. Die zweite Tabelle zeigt weitere kostenlose Modelle, die Sie einer Gemini-Familie zuordnen können.

Kostenlose Gemini-API-Modelle mit Tool-Aufrufen (Google AI Studio)
ModellKostenlos beiKontextKostenlose Limits (bestes Angebot)ToolsBildverarbeitung
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaJaJa
Gemini Flash (latest alias)Google AI Studio-10 Anfragen/Min.
20 Anfragen/Tag
250,000 Token/Min.
~3M
JaJa
Gemini 3.7 FlashGoogle AI Studio1M10 Anfragen/Min.
20 Anfragen/Tag
250,000 Token/Min.
~3M
JaJa
Gemini 3.6 FlashGoogle AI Studio1M10 Anfragen/Min.
20 Anfragen/Tag
250,000 Token/Min.
~3M
JaJa
Gemini 3.5 FlashGoogle AI Studio1M10 Anfragen/Min.
20 Anfragen/Tag
250,000 Token/Min.
~3M
JaJa
Gemini 3.8 LiveGoogle AI Studio-10 Anfragen/Min.
20 Anfragen/Tag
250,000 Token/Min.
~3M
JaJa
Gemini 3.8 Live Extended ThinkingGoogle AI Studio-10 Anfragen/Min.
20 Anfragen/Tag
250,000 Token/Min.
~3M
JaJa
Gemini 3.5 Flash LiteGoogle AI Studio1M15 Anfragen/Min.
20 Anfragen/Tag
250,000 Token/Min.
~3M
JaJa

Es werden 8 von 14 passenden kostenlosen Modellen angezeigt. Alle Modelle ansehen.

Live-Daten aus dem FreeLLMAPI-Katalog (Version 2026.11.19, geprüft 2026-11-19). Kostenlose Limits ändern sich oft. Der Katalog wird jeden Tag geprüft.

Weitere kostenlose Modelle für Gemini CLI: Tool-Aufrufe und 128K+ Kontext
ModellKostenlos beiKontextKostenlose Limits (bestes Angebot)ToolsBildverarbeitung
GLM 5.3UnoRouter1M1 Anfragen/Min.
1 req/min per model
JaNein
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 Anfragen/Min.
40 RPM
JaJa
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceJaNein
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditJaJa
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditJaJa
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 Anfragen/Min.
50 Anfragen/Tag
50 req/day account-wide (1,000 after a $10 purchase)
JaJa
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 Anfragen/Min.
50 Anfragen/Tag
Shared rate limit
JaNein
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 Anfragen/Min.
250 Anfragen/Tag
70,000 Token/Min.
~6M
JaJa

Es werden 8 von 104 passenden kostenlosen Modellen angezeigt. Alle Modelle ansehen.

Live-Daten aus dem FreeLLMAPI-Katalog (Version 2026.11.19, geprüft 2026-11-19). Kostenlose Limits ändern sich oft. Der Katalog wird jeden Tag geprüft.

Limits des kostenlosen Gemini-Angebots

Die Seite zu den Rate Limits von Google sagt, dass Limits pro Projekt gelten, nicht pro API-Schlüssel. Mehr Schlüssel in einem Projekt bringen kein größeres Kontingent. Google sagt außerdem, dass Limits nicht garantiert sind, und dass Sie Ihre aktuellen Limits in Google AI Studio sehen können. Vorschau-Modelle haben niedrigere Limits.

Ein kostenloser Gemini-Flash-Schlüssel erlaubt nur wenige Anfragen pro Tag. Eine einzelne Aufgabe in Gemini CLI kann viele Anfragen senden. Fügen Sie Schlüssel anderer Anbieter hinzu, damit der Router weiterarbeiten kann, wenn das Gemini-Kontingent erschöpft ist. Die native Schnittstelle unterstützt generateContent, streamGenerateContent mit ?alt=sse, countTokens und die Modellliste.

FreeLLMAPI akzeptiert den Schlüssel im Header x-goog-api-key, als Bearer-Token oder im Query-Parameter ?key= von Gemini. Verwenden Sie bevorzugt einen Header, weil ein Schlüssel in einer URL in den Shell-Verlauf und in Proxy-Logs gelangen kann.

Fehlerbehebung

ProblemUrsacheLösung
Gemini CLI öffnet eine Google-AnmeldungDer Authentifizierungstyp ist nicht auf Gemini-API-Schlüssel gesetztWählen Sie Use Gemini API key oder setzen Sie security.auth.selectedType
„Invalid auth method selected“ (englische Fehlermeldung)GOOGLE_API_KEY wird mit einer eigenen Basis-URL verwendetVerwenden Sie GEMINI_API_KEY und heben Sie GOOGLE_API_KEY mit unset auf
Anfragen gehen an Google, nicht an das GatewayGOOGLE_GEMINI_BASE_URL ist in dieser Shell nicht gesetztExportieren Sie die Variable und starten Sie gemini erneut
404 bei ModellaufrufenDie Basis-URL enthält /v1betaVerwenden Sie nur den Ursprung http://localhost:3001
Tool-Aufrufe schlagen fehlDie Gemini-Familie ist einem Modell mit schwacher Tool-Unterstützung zugeordnetOrdnen Sie die Familie einem Modell aus den Tabellen oben zu
„All models rate-limited after N attempts“ (englische Fehlermeldung)Alle Schlüssel haben ihr Limit erreichtFügen Sie Schlüssel von weiteren Anbietern hinzu oder warten Sie auf die Abkühlzeiten
Nutzen Sie alle diese Modelle über einen einzigen Schlüssel. FreeLLMAPI ist ein Open-Source-Router, den Sie selbst hosten. Er stellt alle diese kostenlosen Angebote hinter einem einzigen OpenAI-kompatiblen Endpunkt bereit und wechselt zum nächsten Anbieter, wenn ein Anbieter das Limit erreicht. Katalog ansehen oder Jetzt starten.

Häufig gestellte Fragen

Ist Gemini CLI noch kostenlos?

Google hat die kostenlose Nutzung von Gemini CLI mit einer Google-Anmeldung für Nutzer ohne Bezahlung und für Google-One-Nutzer am 18. Juni 2026 beendet. Die CLI unterstützt weiterhin eine eigene Basis-URL, sodass sie über ein kostenloses Gateway wie FreeLLMAPI laufen kann.

Wie verwende ich Gemini CLI mit einem eigenen Endpunkt?

Setzen Sie GOOGLE_GEMINI_BASE_URL auf den Ursprung des Endpunkts und GEMINI_API_KEY auf dessen Schlüssel. Wählen Sie dann Use Gemini API key. Der Endpunkt muss die native Gemini API unter /v1beta sprechen.

Kann Gemini CLI Modelle nutzen, die nicht von Gemini sind?

Ja, über FreeLLMAPI. Das Gateway ordnet die Familiennamen Gemini Pro, Flash und Flash-Lite Auto oder einem beliebigen Katalogmodell zu, zum Beispiel einem Qwen- oder GLM-Modell.

Wie hoch sind die Limits des kostenlosen Gemini-API-Angebots?

Google setzt die Limits pro Projekt, nicht pro Schlüssel, und zeigt die aktuellen Werte in Google AI Studio an. Die Tabelle auf dieser Seite zeigt die heutigen kostenlosen Gemini-Modelle und ihre Limits aus dem FreeLLMAPI-Katalog.

Warum erhalte ich die Meldung „Invalid auth method selected“?

Ein Problem in Gemini CLI meldet diesen Fehler in Version 0.44.x, wenn GOOGLE_API_KEY zusammen mit GOOGLE_GEMINI_BASE_URL verwendet wird. Verwenden Sie GEMINI_API_KEY und heben Sie GOOGLE_API_KEY mit unset auf.

Verwandte Anleitungen

Quellen

Alle Anleitungen · Alle kostenlosen Modelle ansehen