Die Anbindung der Grok API ist für sich genommen nicht kompliziert; hängen bleiben die meisten an drei Fragen: Woher kommt der Key, wie lautet die Base URL, und passen Key und Adresse zusammen? Der häufigste 401 entsteht nicht durch einen ungültigen Key, sondern dadurch, dass der Key einer Plattform an die Adresse einer anderen Plattform gesetzt wird.
Dieser Artikel folgt dem Ablauf „Zugangsweg, Key erstellen, Adresse konfigurieren, minimaler Aufruf, Sicherheit und Fehlersuche“. Modellnamen und Verfügbarkeit richten sich nach den Modellpreisen; Menübezeichnungen im Kontrollzentrum können sich ändern, maßgeblich ist die tatsächliche Seite.
Hinweis: xAI und Grok sind Marken der jeweiligen Inhaber. Dieser Artikel dient der technischen Erläuterung. Schnittstellen, Modelle und Preise können sich ändern; maßgeblich sind die offizielle xAI-Dokumentation und die Modellpreise.
1. Zuerst klären, welcher Key benötigt wird
Ein Grok API Key stammt üblicherweise aus zwei Quellen: dem offiziellen xAI-Kontrollzentrum oder einem inländischen AI-Gateway mit OpenAI-kompatiblem Einstieg. Beide können Grok aufrufen, unterscheiden sich aber in Konto, Zahlung und Rechnungssteller.
| Kriterium | Offizielles xAI-Kontrollzentrum | ZSQH AI Gateway |
|---|---|---|
| Zielgruppe | Auslandszahlung vorhanden, stabiler Zugang | inländische Zahlung, RMB-Rechnung gewünscht |
| Kontosystem | xAI-Konto | Gateway-Konto |
| Zahlung | von xAI unterstützte Methoden | Aufladung in RMB |
| Base URL | https://api.x.ai/v1 |
https://ai.zhongshangqihang.com/v1 |
| Abrechnung | Dollarbeträge, Wechselkurs selbst abwickeln | RMB-Beträge, mehrere Modelle gebündelt |
| Modellumfang | Modelle von xAI | mehrere im Gateway freigeschaltete Modelle |
Die Keys der beiden Wege sind nicht austauschbar. Ein offizieller Key gehört an die offizielle Adresse, ein Gateway-Key an die Gateway-Adresse. Erst den Weg wählen, dann den Key erstellen und unterwegs nicht mischen.
2. Offizielles xAI-Konto: Key erstellen
- Ein nutzbares xAI-Konto vorbereiten und Kontostatus, Nutzungsbedingungen sowie regionale Anforderungen prüfen.
- Im xAI-Kontrollzentrum den Bereich für API-Key-Verwaltung öffnen. Menünamen können je nach Version variieren; maßgeblich ist die Anzeige.
- Die Abrechnung oder Vorauszahlung nach den Vorgaben einrichten. Ohne verfügbares Kontingent lässt sich ein Key zwar erstellen, aber nicht nutzen.
- Einen neuen Key anlegen und nach Projekt und Umgebung benennen, etwa
prod-customer-service, damit Rotation und Audit einfacher werden. - Den Key sofort nach der Erstellung kopieren und speichern. Viele Plattformen zeigen ihn nur einmal vollständig; nach dem Schließen ist er nicht mehr sichtbar.
- Bietet das Kontrollzentrum Optionen für Kontingent, Rechte oder IP-Beschränkungen, nach dem Prinzip minimaler Rechte konfigurieren und nicht standardmäßig alles freigeben.
- Mit einer minimalen Anfrage prüfen, ob Key, Adresse und Modellname zusammenpassen.
Der offizielle Weg eignet sich für Teams, die nur Grok benötigen und über stabile Auslandszahlung und Zugangsbedingungen verfügen. Sind Zahlung oder Netz instabil, verschiebt sich das Problem von „Ist das Modell gut?“ zu „Können wir heute überhaupt aufrufen?“; der Betriebsaufwand wird leicht unterschätzt.
3. Gateway: Key erstellen
- Das ZSQH AI Gateway öffnen, ein Konto registrieren und die erforderlichen Identitäts- oder Unternehmensangaben ergänzen.
- Zuerst einen kleinen Betrag aufladen, Zahlung, Gutschrift und Aufruf prüfen und danach bedarfsgerecht aufstocken.
- Im Kontrollzentrum einen API-Key anlegen, nach Projekt benennen und eine Ausgabenobergrenze oder einen Alarm setzen.
- Die Base URL des Gateways notieren:
https://ai.zhongshangqihang.com/v1. - Mit dem folgenden curl-Befehl eine minimale Anfrage senden und prüfen, ob Status 200 mit Inhalt zurückkommt.
- Erst danach den Geschäftscode anbinden und den Key in serverseitige Umgebungsvariablen legen.
Der Wert des Gateway-Wegs liegt nicht nur im Zugang, sondern auch in RMB-Zahlung, einheitlicher Abrechnung, Modellwechsel und der Verwaltung mehrerer Modelle über einen Key. Ob er passt, hängt von Zahlungsweg, Rechnungsanforderung und Betriebsgrenze ab.
4. Base URL und Endpunkt richtig schreiben
Die Base URL ist die häufigste Fehlerquelle. Sie endet üblicherweise bei /v1; das SDK ergänzt den weiteren Pfad selbst. Wer die vollständige Adresse manuell schreibt, muss doppelte Pfade vermeiden.
| Position | Offizielles xAI | ZSQH AI Gateway |
|---|---|---|
| Base URL | https://api.x.ai/v1 |
https://ai.zhongshangqihang.com/v1 |
| Chat-Endpunkt | /chat/completions |
/chat/completions |
| Authentifizierungsheader | Authorization: Bearer <Key> |
Authorization: Bearer <Key> |
| Modellname | nach offizieller Modellliste | nach den Modellpreisen |
Ein häufiger Fehler ist https://api.x.ai/v1/v1/chat/completions oder ein zusätzlicher Schrägstrich am Ende der Base URL, an den der Pfad angehängt wird. Ebenfalls falsch ist der Anthropic-Header x-api-key bei Grok. Der OpenAI-kompatible Einstieg von Grok verwendet Bearer-Authentifizierung.
5. Minimaler Aufruf zur Prüfung
Zuerst mit curl mögliche Fehler im Code ausschließen. Der folgende Befehl sendet eine kurze Nachricht; Status 200 mit dem Feld choices zeigt, dass Key, Base URL und Modellname zusammenpassen:
export GROK_API_KEY="sk-dein-schluessel"
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"}],
"max_tokens": 16
}'
Python-Projekte können das OpenAI SDK weiterverwenden und nur Key und Base URL ändern:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["GROK_API_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."}],
max_tokens=256,
)
print(resp.choices[0].message.content)
Modellnamen nicht aus dem Gedächtnis schreiben. Je nach Konto und Gateway sind unterschiedliche Modelle freigeschaltet; maßgeblich sind die Modellpreise oder die Modellliste im Kontrollzentrum. Ein falscher Modellname führt meist zu 404 oder model not found und ist kein Key-Problem.
6. Sichere Konfiguration des Keys
- Den Key nur in serverseitigen Umgebungsvariablen oder einem Secret-Manager halten, nicht im Repository.
- Den Key nicht in Frontend-Bundles, Browseranfragen oder mobile Installationspakete einbauen; das Frontend ruft ausschließlich das eigene Backend auf.
- Ein Key je Projekt, Test und Produktion getrennt, damit Limits, Rotation und Nutzungsverfolgung möglich sind.
- Im Log nur die ersten Zeichen oder einen Hash speichern, nie den vollständigen Wert.
- Bei Austritt von Mitarbeitern, Projektende oder Verdacht auf Offenlegung sofort sperren und neu erstellen.
- Die Nutzungskurve regelmäßig prüfen; bei auffälligen Aufrufen zuerst den Key stoppen und dann die Ursache suchen, nicht zuerst den Geschäftscode ändern.
Die typische Folge einer Key-Offenlegung ist nicht nur, dass jemand auf fremde Kosten aufruft, sondern dass Daten, Kontingent und Abrechnung gleichzeitig außer Kontrolle geraten. Wer den Key wie ein Datenbankpasswort behandelt, vermeidet viele Probleme im Voraus.
7. Häufige Konfigurationsfehler
| Symptom | Häufige Ursache | Behandlung |
|---|---|---|
| 401 | Key und Base URL passen nicht zusammen; Leerzeichen oder Zeilenumbruch im Key | Herkunft abgleichen, Key neu kopieren |
| 404 | Pfad doppelt angehängt; Endpunkt falsch | Base URL nur bis /v1, Endpunkt /chat/completions |
| model not found | Modellname falsch oder nicht freigeschaltet | Modellnamen aus Preisseite oder Konsole kopieren |
| 429 | Anfragefrequenz, Parallelität oder Token-Limit überschritten | Parallelität senken, mit Backoff wiederholen |
| insufficient quota | Guthaben zu niedrig oder Key-Limit erreicht | Aufladen und Key-Kontingent prüfen |
| Timeout | Netzweg, Proxy oder lange Ausgabe | Ausgang prüfen, sinnvolle Verbindungs- und Lesezeitlimits setzen |
Bei der Fehlersuche zuerst Request-ID und Statuscode aus der Antwort sichern und erst dann die Anfrage ändern. Ohne Statuscode und Request-ID bleibt nur Raten.
Häufige Fragen
Müssen Key und Base URL vom selben Anbieter stammen?
Ja. Ein offizieller Key gehört zur offiziellen Adresse, ein Gateway-Key zur Gateway-Adresse. Gemischt ergibt das meist 401, teilweise auch 404 oder einen Berechtigungsfehler.
Darf der Key im Browser liegen?
Nicht empfohlen. Browser-Code ist für Nutzer sichtbar, und ein Key lässt sich leicht extrahieren. Richtig ist, dass das Frontend das eigene Backend aufruft und das Backend den Key hält und Anfragen weiterleitet.
Kann ein Key mehrere Modelle aufrufen?
Im Gateway-Modus üblicherweise ja, sofern das Konto das jeweilige Modell freigeschaltet hat; im Request wird der Modellname angegeben. Beim offiziellen Konto gilt die Modellliste im offiziellen Kontrollzentrum.
Was tun bei einem offengelegten Key?
Den Key sofort im Kontrollzentrum sperren oder deaktivieren, einen neuen Key erstellen und einsetzen sowie Nutzung und Rechnung der letzten Tage prüfen. Nicht nur die Zeichenkette im Code ändern und den alten Key gültig lassen.
Warum liefert ein frisch kopierter Key ständig 401?
Zuerst auf überzählige Leerzeichen, Zeilenumbrüche oder Anführungszeichen prüfen, dann die Base URL abgleichen. Bleibt der Fehler, mit curl direkt testen, um SDK-Konfiguration und Proxy-Einflüsse auszuschließen.
Nächster Schritt
Wer einen Einstieg für Grok und weitere Modelle benötigt, kann im ZSQH AI Gateway einen Test-Key anlegen und mit einer minimalen Anfrage prüfen, bevor die Geschäftsanbindung erfolgt. Verfügbarkeit und Preise entnehmen Sie den Modellpreisen.
Weiterlesen:
