Wenn Sie bereits das OpenAI SDK verwenden, ist der schnellste Weg, Gemini zu testen, den API-Schlüssel, die Basis-URL und die Modell-ID zu ändern. Die offizielle OpenAI-kompatible Basis-URL der Gemini API lautet:
https://generativelanguage.googleapis.com/v1beta/openai/
Für Flatkey lautet die OpenAI-kompatible Router-Basis-URL:
https://router.flatkey.ai/v1
Das ist der Kern des Gemini API OpenAI-Kompatibilitäts-Basis-URL und Flatkey Router-Setups: Bei direktem Gemini wird ein Google-API-Schlüssel und der OpenAI-kompatible Endpunkt von Google verwendet; bei Flatkey wird ein Flatkey-Schlüssel, der Flatkey-Router und eine Gemini-Modell-ID verwendet, die in Ihrem Flatkey-Konto verfügbar ist.
Verwenden Sie den direkten Google-Pfad, wenn Sie nur Gemini benötigen und die möglichst provider-spezifische Einrichtung wünschen. Verwenden Sie den Flatkey-Pfad, wenn Sie Gemini bereits mit GPT, Claude, DeepSeek, Qwen oder anderen Modellen vergleichen und eine einzige OpenAI-kompatible Basis-URL, eine Modellliste und ein Nutzungsprotokoll möchten.
Gemini API OpenAI-Kompatibilitäts-Basis-URL und Flatkey Router-Setup auf einen Blick
| Einrichtungsoption | Basis-URL | API-Schlüssel | Quelle der Modell-ID | Am besten geeignet für |
|---|---|---|---|---|
| Direktes Gemini | https://generativelanguage.googleapis.com/v1beta/openai/ |
Gemini-API-Schlüssel | Google Gemini API-Modell-Dokumentation oder client.models.list() |
Sie benötigen nur Gemini und möchten direkten Google-Zugriff. |
| Flatkey-Router | https://router.flatkey.ai/v1 |
Flatkey-API-Schlüssel | Flatkey /v1/models oder das Model Directory |
Sie möchten Gemini neben anderen Modellanbietern hinter einem Schlüssel. |
Verwechseln Sie die beiden nicht. Ein Gemini-API-Schlüssel authentifiziert nicht bei Flatkey, und ein Flatkey-Schlüssel authentifiziert nicht beim direkten Gemini-Endpunkt von Google.
Direkte Gemini-Einrichtung mit dem OpenAI SDK
Die OpenAI-Kompatibilitätsschicht von Google ermöglicht es Ihnen, die Form des OpenAI SDK für gängige Chat-Completions-Workflows beizubehalten. Der wichtige Unterschied ist die Client-Konfiguration.
Python
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["GEMINI_API_KEY"],
base_url="https://generativelanguage.googleapis.com/v1beta/openai/",
)
response = client.chat.completions.create(
model="gemini-3.8-flash",
messages=[
{"role": "user", "content": "Schreiben Sie einen Satz über Modellrouting."}
],
)
print(response.choices[0].message.content)
JavaScript
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.GEMINI_API_KEY,
baseURL: "https://generativelanguage.googleapis.com/v1beta/openai/",
});
const response = await client.chat.completions.create({
model: "gemini-3.8-flash",
messages: [
{ role: "user", content: "Schreiben Sie einen Satz über Modellrouting." },
],
});
console.log(response.choices[0].message.content);
REST
curl https://generativelanguage.googleapis.com/v1beta/openai/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $GEMINI_API_KEY" \
-d '{
"model": "gemini-3.8-flash",
"messages": [
{"role": "user", "content": "Schreibe einen Satz über Model Routing."}
]
}'
Bevor du live gehst, führe client.models.list() oder GET /openai/models gegen dieselbe Base URL aus. Das fängt den häufigsten Fehler ab: eine alte Modell-ID aus einem Blogbeitrag zu übernehmen und anzunehmen, dass sie für dein Konto noch existiert.
Flatkey Router-Setup für Gemini
Flatkey behält die OpenAI-SDK-Struktur bei, aber die Base URL und der Schlüssel ändern sich erneut. Du verwendest den Flatkey Router und wählst dann eine Gemini-Modell-ID aus Flatkeys /v1/models-Antwort oder dem Live Model Directory aus.
Python
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["FLATKEY_API_KEY"],
base_url="https://router.flatkey.ai/v1",
)
models = client.models.list()
gemini_models = [model.id for model in models.data if "gemini" in model.id]
print(gemini_models)
response = client.chat.completions.create(
model=os.environ.get("FLATKEY_GEMINI_MODEL", "gemini-2.5-flash"),
messages=[
{"role": "user", "content": "Schreibe einen Satz über Model Routing."}
],
)
print(response.choices[0].message.content)
JavaScript
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.FLATKEY_API_KEY,
baseURL: "https://router.flatkey.ai/v1",
});
const models = await client.models.list();
console.log(models.data.map((model) => model.id).filter((id) => id.includes("gemini")));
const response = await client.chat.completions.create({
model: process.env.FLATKEY_GEMINI_MODEL || "gemini-2.5-flash",
messages: [
{ role: "user", content: "Schreibe einen Satz über Model Routing." },
],
});
console.log(response.choices[0].message.content);
In der Produktion solltest du nicht davon ausgehen, dass die direkte Modell-ID von Google und die geroutete Modell-ID von Flatkey immer identisch sein werden. Betrachte die Modellliste als die maßgebliche Quelle für das Konto, das du aufrufst.
Umgebungsvariablen, um den Wechsel rückgängig machbar zu halten
Ein sauberes Gemini API OpenAI-Kompatibilitäts-Basis-URL und Flatkey Router-Setup sollte direkte und geroutete Tests leicht vergleichbar machen, ohne Anwendungscode zu bearbeiten.
# Direktes Gemini
GEMINI_API_KEY="..."
GEMINI_OPENAI_BASE_URL="https://generativelanguage.googleapis.com/v1beta/openai/"
GEMINI_MODEL="gemini-3.8-flash"
# Flatkey-Router
FLATKEY_API_KEY="..."
FLATKEY_BASE_URL="https://router.flatkey.ai/v1"
FLATKEY_GEMINI_MODEL="gemini-2.5-flash"
Wähle dann den Pfad über die Konfiguration aus:
import os
from openai import OpenAI
route = os.environ.get("AI_ROUTE", "flatkey")
if route == "direct_gemini":
client = OpenAI(
api_key=os.environ["GEMINI_API_KEY"],
base_url=os.environ["GEMINI_OPENAI_BASE_URL"],
)
model = os.environ["GEMINI_MODEL"]
else:
client = OpenAI(
api_key=os.environ["FLATKEY_API_KEY"],
base_url=os.environ["FLATKEY_BASE_URL"],
)
model = os.environ["FLATKEY_GEMINI_MODEL"]
response = client.chat.completions.create(
model=model,
messages=[{"role": "user", "content": "Return exactly: route ok"}],
)
Dieses Muster ermöglicht es einem Indie-Hacker, zunächst direktes Gemini zu testen, später Flatkey hinzuzufügen und ohne Umschreiben des Request-Pfads zurückzurollen.
Smoke-Test-Checkliste, bevor Sie Traffic umstellen
| Prüfung | Direktes Gemini | Flatkey-Router |
|---|---|---|
| Authentifizierung | Bestätigen Sie, dass der Gemini-Schlüssel nur gegen den Google-Endpunkt funktioniert. | Bestätigen Sie, dass der Flatkey-Schlüssel nur gegen router.flatkey.ai funktioniert. |
| Modellliste | Führen Sie client.models.list() gegen die Gemini-Basis-URL aus. |
Führen Sie client.models.list() gegen Flatkey aus und filtern Sie nach Gemini-IDs. |
| Einfacher Chat | Senden Sie eine kurze Chat-Completion ohne Streaming. | Senden Sie denselben Prompt über das Flatkey-Gemini-Modell. |
| Streaming | Testen Sie Streaming nur, wenn Ihre App Streaming verwendet. | Testen Sie Streaming mit dem exakt gerouteten Modell, bevor Sie es für Nutzer aktivieren. |
| Tool-Aufruf | Testen Sie ein kleines Funktionsschema, wenn Ihre App Tools verwendet. | Bestätigen Sie, dass das geroutete Modell das Tool-Verhalten unterstützt, das Ihre App erwartet. |
| Strukturierte Ausgabe | Validieren Sie echte JSON-Ausgabe, nicht nur den Status 200. |
Validieren Sie dasselbe Schema und dasselbe Retry-Verhalten. |
| Nutzungsprüfung | Prüfen Sie Google-Nutzung und Fehler in Ihrem Provider-Konto. | Prüfen Sie Flatkey Usage Logs für Modell, Token-Zahlen, Latenz und Kosten. |
OpenAI-kompatibel bedeutet nicht, dass jede anbieterspezifische Funktion identisch funktioniert. Es bedeutet, dass Ihre Client-Struktur für gängige SDK-Workflows nah genug beibehalten werden kann. Der Smoke-Test sollte die Funktionen abdecken, von denen Ihre App tatsächlich abhängt.
Häufige Fehler bei der Basis-URL
/openai/ beim direkten Gemini-Pfad weglassen
Für direkte OpenAI-kompatible Gemini-Aufrufe verwenden Sie:
https://generativelanguage.googleapis.com/v1beta/openai/
Verwenden Sie nicht den nativen Gemini-generateContent-Endpunkt mit OpenAI-SDK-Chat-Completion-Code. Native Gemini-API-Beispiele und OpenAI-kompatible Beispiele haben unterschiedliche Request-Strukturen.
base_url in Node oder baseURL in Python verwenden
Die Konfiguration des Python OpenAI SDK verwendet base_url. Das JavaScript SDK verwendet baseURL.
OpenAI(base_url="https://router.flatkey.ai/v1")
new OpenAI({ baseURL: "https://router.flatkey.ai/v1" })
Modell-IDs als dauerhaft behandeln
Modellnamen ändern sich schneller als der SDK-Setup-Code. Für den direkten Weg prüfen Sie die Modell-Dokumentation von Google oder listen Sie Modelle über den Gemini-OpenAI-kompatiblen Endpoint auf. Für Flatkey prüfen Sie /v1/models und das Model Directory.
Logs überspringen
Die erste erfolgreiche Antwort ist noch nicht das Ende des Setups. Öffnen Sie nach der ersten Flatkey-Anfrage die Usage Logs und verifizieren Sie das Modell, die Token-Zahlen, die Latenz und die Kosten. Dadurch wird das Gemini API OpenAI Compatibility Base URL und Flatkey Router Setup operativ nachvollziehbar statt nur syntaktisch korrekt.
Wann Flatkey einen Mehrwert bietet
Flatkey ist nützlich, wenn Gemini nur ein Pfad in einem breiteren Modell-Stack ist. Zum Beispiel:
- Sie möchten Gemini, Claude, GPT, DeepSeek und Qwen hinter einer OpenAI-kompatiblen Basis-URL bündeln.
- Sie testen das Fallback-Verhalten von Modellen und möchten nicht separate Provider-Keys über Apps und Agents verstreut haben.
- Sie benötigen ein gemeinsames Nutzungsprotokoll für Modell-IDs, Token-Zahlen, Latenz und Kosten pro Anfrage.
- Sie möchten, dass Entwickler den Modellparameter ändern, ohne den SDK-Client zu ändern.
Wenn Ihre App ausschließlich Gemini aufrufen wird, reicht das direkte Google-Setup möglicherweise aus. Wenn Ihr Produkt bereits Anbieter vergleicht, bietet der Flatkey-Router einen saubereren Migrationspfad.
Interne Links, die sich offen halten lohnen
- Flatkey API Schnellstart
- OpenAI-kompatibler Migrationsleitfaden
- Gemini-vs-Claude-Routenprüfungen
- Flatkey Model Directory
- Flatkey-Preisseite
- Flatkey-Statusseite
Häufig gestellte Fragen
Was ist die offizielle Gemini OpenAI-kompatible Basis-URL?
Die offizielle Gemini OpenAI-kompatible Basis-URL ist https://generativelanguage.googleapis.com/v1beta/openai/. Verwenden Sie sie mit einem Gemini-API-Schlüssel, nicht mit einem Flatkey-Schlüssel.
Welche Basis-URL sollte ich für Gemini über Flatkey verwenden?
Verwenden Sie https://router.flatkey.ai/v1 mit einem Flatkey-API-Schlüssel. Wählen Sie dann eine Gemini-Modell-ID aus der /v1/models-Antwort von Flatkey oder aus dem Live Model Directory aus.
Kann ich an beiden Stellen dieselbe Gemini-Modell-ID verwenden?
Manchmal, aber verlassen Sie sich nicht darauf. Der sichere Ablauf besteht darin, die Modelle für die genaue Route und das Konto aufzulisten, die Sie verwenden, und diese ID dann in der Konfiguration fest zu hinterlegen.
Bedeutet OpenAI-kompatibel vollständige Feature-Parität?
Nein. Behandeln Sie OpenAI-Kompatibilität als Komfort bei SDK und Request-Struktur. Testen Sie Streaming, Tools, strukturierte Ausgabe, Dateien und multimodale Eingaben auf dem genauen Modell und der Route vor dem Produktions-Rollout.
Sollte ein Indie-Hacker direkt starten oder mit Flatkey?
Starten Sie direkt, wenn Sie nur beweisen wollen, dass Gemini funktioniert. Starten Sie mit Flatkey, wenn die eigentliche Entscheidung darin besteht, welches Modell das Produkt antreiben soll, nicht ob Gemini allein den Prompt beantworten kann.
Fazit
Das Gemini API OpenAI Compatibility Base URL und Flatkey Router Setup ist einfach, wenn Sie die beiden Routen trennen:
- Direktes Gemini:
https://generativelanguage.googleapis.com/v1beta/openai/ - Flatkey-Router:
https://router.flatkey.ai/v1
Halten Sie Schlüssel getrennt, listen Sie Modelle auf, bevor Sie Chat-Completions aufrufen, testen Sie die Funktionen, die Ihre App verwendet, und prüfen Sie die Nutzung nach der ersten Anfrage. Wenn Sie bereit sind, Gemini mit anderen Anbietern über eine einzige OpenAI-kompatible Schicht zu vergleichen, erstellen Sie einen Flatkey-Schlüssel und verschieben Sie jeweils eine Arbeitslast.
