Grok API: Schlüssel, Endpunkte, Modelle und eine erste Anfrage

Was die Grok API ist

Die Grok API ist die kostenpflichtige Entwicklerschnittstelle von SpaceXSI (ehemals xAI). Sie gibt Ihrem eigenen Code Zugriff auf dieselbe Grok-Modellfamilie, die die Grok-Apps antreibt, dazu Bild-, Video- und Sprachmodelle. Sie bezahlen pro Token, pro Bild, pro Sekunde Video oder pro Minute Audio.

Die API ist von den Verbraucherplänen getrennt. Die Preisseite von The X Subscription führt „Grok API access“ unter Plus auf, sagt aber auch, dass die API-Nutzung separat abgerechnet wird. SpaceXSI erklärt nicht, wie beides zusammenhängt – planen Sie also ein, API-Aufrufe über Konsolen-Guthaben zu bezahlen.

Die wichtigsten Einsatzzwecke sind die üblichen: Chat und Reasoning in Ihren eigenen Apps, Agenten, die Tools aufrufen, Dokument- und Bildverständnis sowie Mediengenerierung. Eine einfache Definition finden Sie im API-Eintrag in unserem Glossar.

So erhalten Sie einen Grok-API-Schlüssel

Der Quickstart von SpaceXSI beschreibt vier Schritte:

1. Legen Sie ein Konto auf console.x.ai an.
2. Laden Sie Prepaid-Guthaben auf. Laut Dokumentation ist Guthaben nötig, bevor Aufrufe funktionieren.
3. Öffnen Sie die Seite API Keys und erzeugen Sie einen Schlüssel.
4. Speichern Sie den Schlüssel als Umgebungsvariable namens XAI_API_KEY, nicht in Ihrem Quellcode.

Die Abrechnung erfolgt standardmäßig im Voraus. Ist das Guthaben aufgebraucht, werden Anfragen abgelehnt. Sie können die automatische Aufladung aktivieren, mindestens $5. Abrechnung per Rechnung ist standardmäßig deaktiviert und muss beim Vertrieb von SpaceXSI angefragt werden.

Basis-URL, SDKs und Endpunkte

Alle Anfragen gehen an die Basis-URL https://api.x.ai/v1. Die Dokumentation nennt drei Wege für den Aufruf:

• xai_sdk, das offizielle Python-SDK.
• Das OpenAI SDK (Python und JavaScript), auf die xAI-Basis-URL ausgerichtet.
• Das Vercel AI SDK, über das Paket @ai-sdk/xai.

Responses API oder Chat Completions

Die Responses API unter /v1/responses ist die Hauptschnittstelle von SpaceXSI. Chat Completions unter /v1/chat/completions wird weiterhin unterstützt. Mit Grok 4.7 liefern Aufrufe der Responses API immer verschlüsseltes Reasoning zurück. Der alte Endpunkt /v1/completions wird durch /v1/chat/completions ersetzt.

Endpunkte im Anthropic-Stil sind veraltet

Die Anthropic-kompatiblen Endpunkte /v1/messages und /v1/complete sind als veraltet markiert. SpaceXSI verweist stattdessen auf die Responses API oder gRPC. Ein Abschaltdatum ist nicht genannt, aber neue Projekte sollten nicht darauf aufbauen.

Regionaler US-Endpunkt

Ein US-Endpunkt unter https://us.api.x.ai/v1 hält die Inferenz in den USA. Er kostet das 1,1-Fache der globalen Preise und bedient nur grok-4.7 und grok-4.6. Details finden Sie auf unserer Seite Preise der Grok API.

Eine minimale erste Anfrage

Dieses Beispiel ruft die Responses API mit curl auf. Es setzt voraus, dass Ihr Schlüssel in XAI_API_KEY gespeichert ist:

curl https://api.x.ai/v1/responses -H "Authorization: Bearer $XAI_API_KEY" -H "Content-Type: application/json" -d '{"model": "grok-4.7", "input": "Explain a context window in one sentence."}'

Zwei Einstellungen sollten Sie vom ersten Tag an kennen:

• reasoning_effort: Grok 4.7 akzeptiert low, medium, high (Standard) oder xhigh.
• prompt_cache_key (oder der Header x-grok-conv-id): SpaceXSI empfiehlt dringend, einen zu setzen. Ohne ihn kann eine Anfrage auf einem Server ohne warmen Cache landen und den vollen Input-Preis kosten.

Feldnamen können sich ändern. Prüfen Sie vor dem Livegang die Anfrage-Referenz in der offiziellen Dokumentation.

Modelle in der Grok API

Das sind die aktuellen Textmodelle, Preise in USD pro 1M Tokens. Prompts über 200k Tokens kosten das Doppelte.

Grok 4.7 Fast ist nicht über die öffentliche API verfügbar. Es wird nur in Cursor und Grok Build angeboten. Mehrere ältere Modelle, darunter grok-3, grok-4-0709, Grok 4 Fast und grok-code-fast-1, wurden am 15. Mai 2026 eingestellt. Aufrufe von grok-code-fast-1 werden jetzt an grok-build-0.1 weitergeleitet.

Die API bedient außerdem die Bild- und Videomodelle von Grok Imagine und die Grok-Voice-Modelle. Siehe Grok Imagine und den Ratgeber zur Grok Voice API.

Integrierte Tools

Grok-Modelle können serverseitige Tools aufrufen, die SpaceXSI für Sie betreibt. Die Preisseite nennt:

• Web Search und Image Search.
• X Search, das Posts und Profile von X liefert.
• Code Execution.
• File attachment search und Collections Search für die Suche in Ihren eigenen Dokumenten.
• view_image, view_x_video und Remote MCP, die nur nach Tokens abgerechnet werden.

Die meisten Tools werden zusätzlich zu den Token-Kosten pro 1.000 Aufrufe abgerechnet. Jedes Modell hat außerdem Anfrage- und Token-Grenzen je Stufe, die wir auf unserer Seite Rate Limits der Grok API behandeln.

Häufige Fragen