Gemini CLI

Gemini CLI ist Googles Open-Source-Agent für das Terminal. Zwei Umgebungsvariablen leiten ihn auf Synthorai um; danach ruft er mit Ihrem Synthorai-Schlüssel den Gemini-nativen Endpunkt des Gateways auf.

Bevor Sie beginnen

Erstellen Sie in der Konsole auf der Seite API-Schlüssel einen Schlüssel. Kopieren Sie ihn sofort, denn er wird nur einmal angezeigt.

Schritt 1 - Umgebungsvariablen setzen

export GOOGLE_GEMINI_BASE_URL="https://synthorai.io"
export GEMINI_API_KEY="sk-..."
gemini -m gemini-3-pro

⚠

Geben Sie nur den Host an, ohne /v1: Gemini CLI hängt seinen Pfad selbst an.

Wenn Gemini CLI nach der Anmeldemethode fragt, wählen Sie Use Gemini API key. Der Schlüssel wird im Header x-goog-api-key gesendet, den das Gateway auf seinem Gemini-nativen Endpunkt annimmt: /v1beta/models/{model}:generateContent und :streamGenerateContent.

Schritt 2 - Modell auswählen

Geben Sie mit -m ein Gemini-Modell an, das Ihr Schlüssel aufrufen darf. Die Modellseite listet sie auf.

Auf diesem Pfad werden nur generateContent und streamGenerateContent bedient. Andere Methoden wie countTokens und embedContent antworten mit 404 und werden nicht berechnet.

Einstellungen in einer Datei ablegen

Statt die Variablen in jeder Shell zu exportieren, können Sie sie in ~/.gemini/.env eintragen:

# ~/.gemini/.env
GOOGLE_GEMINI_BASE_URL="https://synthorai.io"
GEMINI_API_KEY="sk-..."

Fehlerbehebung

401 Der Schlüssel ist falsch oder in der Shell, in der gemini läuft, nicht gesetzt.

404 bei einem Modell Das Modell ist für Ihren Schlüssel nicht freigegeben. Wählen Sie eines, das Ihr Schlüssel aufrufen darf.

/v1/v1beta in einer URL Entfernen Sie /v1 aus GOOGLE_GEMINI_BASE_URL.

Was die Gemini-Modelle kosten, zeigt der Modell-Preisvergleich.