Die Gemini API unterstützt multimodale Eingaben aus Text, Bild, Audio und Video und ist preislich vergleichsweise attraktiv. Der Zugang zu Google-Diensten aus China, Kontingentgrenzen und Zahlungsmethoden bleiben jedoch häufige Hürden.

Ein Gemini API Relay bündelt diesen Zugang und die Abrechnung in einem Gateway. Dieser Artikel erklärt, wie Sie auswählen, anbinden und testen.

Hinweis: Gemini und Google sind Marken ihrer jeweiligen Inhaber. Dieser Artikel dient der technischen Diskussion; für Preise und Schnittstellen sind die offiziellen Angaben bzw. die Anbieterseite maßgeblich.

1. Was ist ein Gemini API Relay?

Ihre Anwendung → Relay-Gateway → Google Gemini

Sie rufen weiterhin Gemini-Modelle auf und ersetzen nur die Base URL und den Key durch die Werte des Gateways. Das Gateway übernimmt Authentifizierung, Abrechnung, Protokollierung und die Umschaltung zwischen Kanälen.

2. Für wen es geeignet ist

  • Der Zugang zu Google ist aus dem Inland instabil.
  • Multimodale Fähigkeiten (Bild, Video, Audio) werden benötigt.
  • Einheitliche Abrechnung, Mitgliederverwaltung und Kontingente sind erforderlich.
  • Teams nutzen Gemini, Claude, GPT und DeepSeek parallel.
  • Modelle sollen für A/B-Tests schnell gewechselt werden.

Typische Einsatzfelder sind die Auswertung von Produktbildern, die Zusammenfassung von Audioaufnahmen, die Analyse längerer Dokumente und die Verarbeitung von Videomaterial. Prüfen Sie vor der Auswahl, ob Ihr Anwendungsfall tatsächlich multimodale Eingaben benötigt oder ob Text allein genügt. Das beeinflusst sowohl die Anforderungen an das Gateway als auch die Kosten.

3. Auswahlkriterien

Kriterium Was zu klären ist
Modellabdeckung Sind Pro, Flash und weitere Versionen vollständig verfügbar?
Multimodalität Werden Bild-, Video- und Audioeingaben unterstützt?
Protokoll Ist die OpenAI-Kompatibilität vollständig? Funktionieren Streaming und Tool-Aufrufe?
Stabilität Fehlerrate, P95, Rate-Limits
Abrechnung Wie werden Eingabe, Ausgabe und multimodale Eingaben berechnet?
Kontingente Limits für Keys, Mitglieder und Projekte
Compliance Datenaufbewahrung, Verträge, Rechnungen

Achten Sie darauf, welche Modellversionen tatsächlich hinterlegt sind. Ein Gateway kann ältere oder experimentelle Versionen anbieten, die sich in Qualität, Kontextlänge und Preis unterscheiden. Für Produktionsanwendungen ist eine feste, dokumentierte Version sinnvoller als ein automatisch wechselnder Alias. Klären Sie außerdem, ob Kontingente pro Key oder pro Konto gelten und wie sich Stoßzeiten auf die Latenz auswirken.

4. Konfiguration

Base URL:

https://ai.zhongshangqihang.com/v1

curl:

export GEMINI_API_KEY="sk-Ihr-Schluessel"

curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
  -H "Authorization: Bearer $GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2.5-flash",
    "messages": [{"role": "user", "content": "Antworte nur mit OK"}]
  }'

Die Modellnamen entnehmen Sie den Modellpreisen.

5. Multimodale Eingaben

Verschiedene Gateways unterstützen Multimodalität auf unterschiedliche Weise. Zwei Varianten sind verbreitet:

  1. Übergabe per URL: Bild- oder Video-URLs werden in den Messages übergeben.
  2. Übergabe als Base64: Die Datei wird kodiert und in die Anfrage eingefügt.

Klären Sie vor der Nutzung, welche Felder und Größenbeschränkungen das Gateway unterstützt, und übernehmen Sie das Format der offiziellen SDKs nicht ungeprüft. Testen Sie zuerst mit einem kleinen Bild und gehen Sie erst danach in die Produktion.

Für Videos und Audiodateien gelten häufig engere Grenzen als für Bilder. Teilen Sie große Dateien nach Möglichkeit in kleinere Abschnitte und planen Sie Wiederholungen ein, falls eine Anfrage wegen Größe oder Zeitüberschreitung abgelehnt wird. Speichern Sie die verwendeten Dateireferenzen, damit sich Fehler später nachvollziehen lassen.

6. Testcheckliste

  1. Textanfragen.
  2. Streaming-Ausgabe.
  3. Bildeingaben.
  4. Langer Kontext.
  5. 5 bzw. 10 gleichzeitige Anfragen.
  6. Umgang mit 429 und 5xx.
  7. Abgleich der Abrechnung.

Wiederholen Sie die Tests an mehreren Tagen und zu unterschiedlichen Tageszeiten. Nur so lässt sich erkennen, ob Latenz und Fehlerquote stabil bleiben oder von der Auslastung abhängen.

7. Häufige Probleme

Symptom Ursache Vorgehen
Verbindungs-Timeout Google ist nicht erreichbar Gateway mit inländischer Erreichbarkeit nutzen
401 Key und Adresse passen nicht zusammen Key und Base URL prüfen
404 Falscher Pfad Nur bis /v1 angeben
429 Kontingent oder Frequenz Parallelität senken, wiederholen, Kontingent erhöhen
Fehler bei multimodalen Eingaben Feld oder Größe nicht unterstützt Gateway-Dokumentation prüfen, zuerst kleine Datei testen

8. Offizieller Direktzugang vs. Relay

Kriterium Offizieller Direktzugang Relay-Gateway
Zugang Von der Netzverbindung abhängig Aus dem Inland erreichbar
Zahlung Offizielle Methoden Aufladung im Portal
Modelle Nur Gemini Mehrere Modelle möglich
Abrechnung Offizielles Backend Einheitliche Konsole
Multimodalität Vollständiger offizieller Funktionsumfang Abhängig von der Gateway-Unterstützung

Wenn Sie ausschließlich Gemini benötigen und der offizielle Zugang zuverlässig funktioniert, ist der Direktzugang eine Option. Ist der Zugang aus dem Inland instabil oder werden mehrere Modelle benötigt, ist ein Relay besser geeignet.

Ein weiterer Unterschied liegt im Betrieb: Beim Direktzugang verwalten Sie Kontingente und Fehler selbst, beim Relay übernimmt der Anbieter einen Teil davon. Dafür müssen Sie dessen Datenbedingungen und Verfügbarkeitszusagen prüfen. Eine Kombination aus Direktzugang als Hauptkanal und Gateway als Ersatz kann sinnvoll sein, erhöht aber die Komplexität.

Nächster Schritt

Für den Zugang aus dem Inland oder einen einheitlichen Einstiegspunkt für mehrere Modelle können Sie sich zunächst beim ZSQH AI Gateway registrieren und Text- sowie multimodale Anfragen mit einem Key mit kleinem Volumen testen. Modelle und Preise finden Sie unter Modellpreise.

Weiterlesen: