Gemini API im OpenAI-kompatiblen Format

Wer die Gemini API direkt nutzt, braucht ein Google-Konto, erstellt einen Key in Google AI Studio und bezahlt nach dem Abrechnungsmodell von Google. Hier wird dieser Teil ersetzt: Sie laden Guthaben bei RelaySwitch auf, verwenden einen RelaySwitch-Key, und der Request geht an ein Gateway, das ihn an Gemini weiterleitet. Für Ihren Code ändern sich nur Adresse und Key; die Modell-ID bleibt die Gemini-ID.

Gemini hat ein eigenes Request-Format (generateContent), die meisten vorhandenen Tools und Programme sind aber für OpenAI Chat Completions geschrieben. Google selbst bietet eine OpenAI-kompatible Schicht an und vermerkt in der Dokumentation, dass diese Unterstützung noch Beta ist. Der Ansatz hier ist derselbe: Jede Gemini-ID in der Preistabelle lässt sich im OpenAI-Format aufrufen; um OpenAI-Code auf Gemini umzustellen, ändern Sie also nur das Feld model.

Prüfen Sie Key und Adresse zuerst mit curl. Der Key wird im Header Authorization: Bearer gesendet, und gegenüber einem gewöhnlichen OpenAI-Beispiel ändern sich nur Base URL, Key und model.

Die Base URL wird mit /v1 geschrieben, das SDK hängt /chat/completions selbst an. Für Streaming setzen Sie stream auf true; die Antwort kommt als Server-Sent Events im selben Format wie bei OpenAI. Die Token-Zahlen in usage stimmen mit denen im Beleg überein.

Code, der nach der OpenAI-kompatiblen Dokumentation von Google geschrieben wurde, verwendet bereits das OpenAI SDK, der Request-Body muss also nicht geändert werden. Gemini-spezifische Felder, die laut Google-Dokumentation über extra_body gesendet werden, sind auf dieser Seite nicht einzeln getestet; wenn Sie sie verwenden, testen Sie zuerst mit einem Request und prüfen Sie, ob die Abrechnung im Beleg Ihren Erwartungen entspricht.

Nur drei Dinge ändern sich:

• base_url: von der Adresse aus der Google-Dokumentation auf https://api.relayswitch.io/v1.
• api_key: vom Key aus Google AI Studio auf einen RelaySwitch-Key, der mit sk-relay- beginnt.
• model: Gleichen Sie die ID mit der Preistabelle auf dieser Seite ab und verwenden Sie die, die dort aktuell steht; eine falsche ID wird mit 404 model_not_found beantwortet.

Programme, die bereits im Request-Format von Google geschrieben sind, müssen nicht umgeschrieben werden, solange die verwendete Gemini-ID diese Route bedient. Der Pfad lautet /v1beta/models/{model}:generateContent, direkt hinter https://api.relayswitch.io ohne /v1. Der Key wird im Header x-goog-api-key gesendet, nicht in der URL: Einen Key im Query-Parameter lehnt das Gateway ab. Request und Antwort verwenden die Struktur von Google, contents hinein und candidates heraus.

Fehlermeldungen folgen dem jeweiligen Format. Im OpenAI-Format steht der Code in error.code; im nativen Format folgt die Form der von Google, zum Beispiel 401 mit UNAUTHENTICATED in error.status, wenn kein Key gesendet wurde. Beide Formate nutzen denselben Key, dasselbe Guthaben und dieselben Preise. Die Tabelle der Fehlercodes pro Status steht auf der Seite zur OpenAI API und gilt vollständig, wenn Gemini im OpenAI-Format aufgerufen wird.

In USD pro Million Token, beim Rendern der Seite aus dem Katalog gelesen. Abgerechnet wird mit drei Preisen: Input, Cached Input und Output, und der Preis in der Tabelle ist der Preis, der vom Guthaben abgezogen wird.

Gemini wird oft zum Lesen langer Unterlagen eingesetzt: ein vollständiger Vertrag, ein ganzes Code-Repository oder das Transkript einer Besprechung. Die Kosten eines solchen Requests liegen fast vollständig im Input; achten Sie bei der Modellwahl also zuerst auf Input-Preis und Kontextlänge und erst dann auf den Output-Preis. Wird dasselbe Material wiederholt befragt, trifft der wiederkehrende Teil ab dem zweiten Request den Cache und wird zum Preis für Cached Input abgerechnet; der Beleg weist diese Token getrennt aus.

Modellnamen mit dem Wort preview sind Vorschauversionen, die Google später durch einen endgültigen Namen ersetzt; die ID in Ihrem Code muss also der entsprechen, die aktuell in der Tabelle steht. Bei der Modellwahl müssen Sie nicht raten: Alle Gemini-IDs liegen auf demselben Key, schicken Sie also denselben Prompt an jede und vergleichen Sie Antwort und Kosten im Beleg. Auch der Vergleich mit GPT oder Claude ist nur eine Änderung von model.

Legen Sie für die Produktion einen eigenen Key an, geben Sie ihm ein Dollar-Budget und ein tägliches Ausgabenlimit, und beschränken Sie ihn per Modell-Allowlist auf die gewählte Gemini-ID. Programme, die lange Dokumente lesen, brauchen diese Grenzen am dringendsten, denn ein einziger fehlerhafter Request, der ein ganzes Verzeichnis mitschickt, kann Hunderttausende Input-Token enthalten. Lesen Sie bei fehlgeschlagenen Requests den Header retry-after, bevor Sie es erneut versuchen. Wie Sie einen Key erstellen und Limits setzen, steht auf der Seite zum Claude API Key.