Grok ist die Modellreihe von xAI. Die API folgt dem OpenAI-kompatiblen Format, sodass Entwickler sie mit dem vorhandenen OpenAI SDK ansprechen können. Beim Einsatz in China liegen die typischen Hürden weniger im Code als beim Zugang, bei der Bezahlung und bei der Verwaltung des Modellbudgets.

Dieser Artikel erklärt, wie man einen Grok-API-Key erhält, wie der Aufruf funktioniert und wie die Anbindung über ein Gateway aussieht.

Hinweis: Grok und xAI sind Marken ihrer jeweiligen Inhaber. Der Artikel bezieht sich auf die im Oktober 2026 üblichen Versionen. Schnittstellen und Preise richten sich nach der offiziellen Dokumentation und den Modellpreisen.

1. Was die Grok API leistet

  • Allgemeine Fragen, Texterstellung und Zusammenfassungen.
  • Codegenerierung und Codeerklärung.
  • Tool-Aufrufe und Agent-Szenarien.
  • Analyse langer Dokumente mit großem Kontextfenster.
  • Vergleichstests mehrerer Modelle.

Welche Modellnamen und Kontextlängen aktuell verfügbar sind, steht auf der Seite Modellpreise. Dort sind auch die Abrechnungseinheiten hinterlegt.

2. Zwei Wege zum API-Key

Offizielles xAI-Konto

Im xAI-Konsolenbereich wird ein API-Key angelegt und eine Zahlungsmethode hinterlegt. Dieser Weg passt zu Teams mit stabilem Zugang und einer Zahlungsmöglichkeit im Ausland.

ZSQH AI Gateway

  1. Beim ZSQH AI Gateway registrieren.
  2. Einen API-Key anlegen und ein Limit setzen.
  3. Guthaben aufladen.
  4. Über das OpenAI SDK oder curl aufrufen.

Dieser Weg eignet sich für Teams, bei denen der direkte Zugang unzuverlässig ist, die eine einheitliche Rechnung brauchen oder mehrere Modelle über einen Key wechseln wollen.

3. Die richtige Base URL

Beim offiziellen xAI lautet die Adresse üblicherweise:

https://api.x.ai/v1

Der OpenAI-kompatible Einstieg des ZSQH AI Gateway:

https://ai.zhongshangqihang.com/v1

Die beiden Adressen dürfen nicht vermischt werden. Key und Base URL müssen zusammenpassen; ein Key aus dem einen System funktioniert nicht gegen den Endpunkt des anderen.

4. Kurzer Test mit curl

export GROK_API_KEY="sk-IHR_KEY"

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

Der Modellname muss exakt der aktuellen Liste entsprechen; maßgeblich ist die Seite Modellpreise. Ein veralteter Name führt häufig zu einem 404 oder zu einer Meldung, dass das Modell nicht existiert.

5. Aufruf mit Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-IHR_KEY",
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="grok-4",
    messages=[{"role": "user", "content": "Erkläre in drei Sätzen, was ein API-Gateway ist."}],
)
print(resp.choices[0].message.content)

Das SDK liest den Key aus dem Konstruktor oder aus einer Umgebungsvariablen. In Produktionsumgebungen sollte der Key nicht im Quellcode stehen, sondern über einen Secret-Manager oder eine Umgebungsvariable eingebunden werden.

6. Häufige Fehlermeldungen

Fehler Ursache Vorgehen
401 Key und Adresse passen nicht zusammen Key und Base URL prüfen
404 Falscher Pfad Nur bis /v1 angeben
model not found Modellname falsch Namen aus der Preisseite übernehmen
429 Ratenlimit erreicht Parallelität senken, später erneut versuchen
insufficient quota Guthaben reicht nicht Konto aufladen

Bei einem 401 lohnt zuerst ein Blick auf Leerzeichen und Zeilenumbrüche im Key. Ein 429 bedeutet nicht automatisch, dass das Guthaben aufgebraucht ist; häufig ist schlicht die Anfrage- oder Token-Rate überschritten.

7. Kosten und Modellwahl

Der Preis pro Token, die Kontextlänge und die Unterstützung von Tool-Aufrufen beeinflussen die tatsächlichen Kosten. Eine belastbare Schätzung entsteht in vier Schritten:

  1. Durchschnittliche Eingabe- und Ausgabe-Token pro Tag erfassen.
  2. Den aktuellen Preis des gewählten Modells nachsehen.
  3. Kosten für Wiederholungen und lange Kontexte hinzurechnen.
  4. Mit anderen Modellen vergleichen und Aufgaben entsprechend verteilen.

Die reine Token-Gebühr ist selten der ganze Aufwand. Lange Kontexte und umfangreiche Ausgaben machen in der Praxis oft den größeren Anteil aus. Für einfache Klassifikationen reicht ein kleineres Modell; komplexe Analysefälle sollten gezielt auf das stärkere Modell gehen.

Häufige Fragen

Ist die Grok API mit OpenAI kompatibel?

Üblicherweise wird das Format der Chat Completions unterstützt, sodass das OpenAI SDK verwendet werden kann. Welche Parameter im Einzelnen unterstützt werden, ergibt sich aus der offiziellen Dokumentation und den Angaben des Gateways.

Wie ruft man die API aus China zuverlässig auf?

Entweder über die direkte offizielle Verbindung, sofern das Netzwerk sie zulässt, oder über ein erreichbares Gateway. In beiden Fällen sollten Timeouts, Wiederholungsversuche und ein Ausweichmodell eingeplant werden.

Kann ein Key mehrere Modelle ansprechen?

In einem Gateway ist das möglich; das Modell wird im Anfrageparameter angegeben. Ein Key des offiziellen Anbieters gilt dagegen nur für dessen eigene Modelle.

Nächster Schritt

Wer einen stabilen Zugang aus China oder einen einheitlichen Einstieg für mehrere Modelle braucht, kann sich beim ZSQH AI Gateway registrieren und zunächst mit einem kleinen Key testen. Modelle und Preise stehen auf der Seite Modellpreise.

Weiterlesen: