Grok API: Grok in eigenen Code einbinden

Zwei Wege, um Grok per Code zu nutzen

Entwickler können Grok-Modelle über zwei Hauptwege ansprechen. Der erste ist die xAI API direkt vom Anbieter (jetzt unter dem Namen SpaceXSI), mit Keys von console.x.ai. Der zweite ist ein Modell-Router wie OpenRouter, der Modelle verschiedener Anbieter über einen Key und eine Abrechnung bündelt. Beide unterstützen Anfragen im OpenAI Chat-Completions-Format – die offiziellen OpenAI-SDKs funktionieren also sofort, sobald du Basisadresse und Modellnamen anpasst.

Welche Option passt zu dir?

• xAI API, wenn du alle Grok-Features sofort nutzen willst: die komplette Modellauswahl, die Responses-API, serverseitige Web- und X-Suche, Bild- und Videogenerierung mit Grok Imagine, Voice, Batch-Jobs und Rabatte durch Prompt-Caching. Basis-URL: https://api.x.ai/v1.
• OpenRouter, wenn du flexibel zwischen Grok und Modellen anderer Anbieter wechseln möchtest (ohne neue Verträge) oder bereits einen Account hast. Basis-URL: https://openrouter.ai/api/v1, Modell-IDs mit vorangestelltem x-ai/. Details findest du im OpenRouter-Quickstart.

In beiden Fällen gilt: Speichere den Key sicher auf dem Server oder in einer Umgebungsvariable. Binde ihn niemals direkt in Webseiten oder Mobile-Apps ein, wo er ausgelesen werden kann.

Dein erster Request an die xAI API

Erstelle einen Key in der Konsole, speichere ihn als XAI_API_KEY und sende eine Nachricht an Grok 4.7:

curl

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "reasoning_effort": "low",
    "messages": [
      {"role": "system", "content": "You are a concise assistant."},
      {"role": "user", "content": "Give me three tips for a first marathon."}
    ]
  }'

Python mit der OpenAI-Bibliothek

import os
from openai import OpenAI

grok = OpenAI(
    api_key=os.environ["XAI_API_KEY"],
    base_url="https://api.x.ai/v1",
)

answer = grok.chat.completions.create(
    model="grok-4.3",
    reasoning_effort="medium",
    messages=[{"role": "user", "content": "Is 391 a prime number? Show your check."}],
)
print(answer.choices[0].message.content)

Über reasoning_effort steuerst du, wie intensiv das Modell vor der Antwort nachdenkt. Grok 4.3 unterstützt none, low, medium, high sowie xhigh (Standard: low); Grok 4.7 unterstützt low, medium, high und xhigh (Standard: high). Für Grok 4.20 nutzt xAI separate IDs: grok-4.20-0309-reasoning und grok-4.20-0309-non-reasoning.

Der gleiche Ablauf über OpenRouter

Bei OpenRouter legst du den Key in OPENROUTER_API_KEY ab und nutzt die x-ai/-IDs. OpenRouter steuert das Reasoning stattdessen über ein reasoning-Objekt. Dieses JavaScript läuft in Node.js 18 oder neuer:

const endpoint = "https://openrouter.ai/api/v1/chat/completions";

const reply = await fetch(endpoint, {
  headers: {
    Authorization: `Bearer ${process.env.OPENROUTER_API_KEY}`,
    "Content-Type": "application/json",
  },
  method: "POST",
  body: JSON.stringify({
    model: "x-ai/grok-4.20",
    reasoning: { enabled: false },
    stream: false,
    messages: [{ role: "user", content: "Rewrite this headline in a calmer tone: PRICES EXPLODE AGAIN" }],
  }),
});
const json = await reply.json();
console.log(json.choices[0].message.content);

Um Denkprozesse zu aktivieren, übergibst du stattdessen reasoning: { effort: "low" } (oder medium, high). Mit exclude: true wird das Reasoning zwar intern genutzt, aber nicht in der Ausgabe zurückgegeben. Setze stream: true, um die Antwort Stück für Stück zu erhalten – das sorgt in Chat-Oberflächen für eine deutlich schnellere Rückmeldung.

Bilder übergeben

Grok 4.20, 4.3 und 4.7 können Bilder analysieren. Verwende dazu das OpenAI-typische Nachrichtenformat mit mehreren Content-Parts. Laut xAI-Dokumentation werden JPEG- und PNG-Bilder bis zu 20 MiB akzeptiert; sowohl öffentliche URLs als auch Base64-Data-URLs funktionieren.

{
  "model": "grok-4.20-0309-non-reasoning",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/receipt.png"}},
      {"type": "text", "text": "List the items and the total on this receipt."}
    ]
  }]
}

Grok: Modell-IDs und Preise

Hier sind die aktuellen Textmodelle, die OpenRouter für SpaceXAI führt, inklusive Kontextfenster und Preisen pro Million Token (Listenpreis OpenRouter, Stand: Okt 2026). Die xAI API verlangt dieselben Basispreise für Prompts unter 200.000 Token.

Wichtige Details aus der Modell- und Preisseite von xAI (Listenpreis xAI, Stand: Okt 2026):

• Längere Prompts kosten mehr: Ab 200.000 Token wird der gesamte Request zum höheren Tarif abgerechnet: $4 / $12 für Grok 4.7, $2.50 / $5 für Grok 4.3 und 4.20.
• Günstigerer Input durch Caching: $0.50 pro Million bei Grok 4.7 und $0.20 bei Grok 4.3 und 4.20 für wiederkehrende Prompt-Präfixe.
• Batch-Jobs mit flexibler Bearbeitungszeit erhalten einen Rabatt. OpenRouter listet dafür x-ai/grok-4.3:batch für $1 / $2.
• Unterschiedliche Kontextangaben: OpenRouter nennt für Grok 4.20 ein Fenster von 2.000.000 Token, während xAI auf der eigenen Seite 1.000.000 Token angibt.

Reasoning-Token zählen als Output. Ein denkendes Modell kann pro Antwort also mehr kosten, als der reine Tokenpreis zunächst vermuten lässt.

Praxistipps

• Starte mit Grok 4.20 (Non-Reasoning) für Chatbots, Umformulierungen und Datenextraktion. Es ist schnell und günstig. Wechsle zu Grok 4.3 oder 4.7, wenn Qualität bei anspruchsvollen Aufgaben wichtiger als pure Geschwindigkeit ist.
• Wissensstand beachten: Grok 4.7 kennt Ereignisse bis Mai 2026 (laut xAI). Für aktuellere Infos übergibst du die Daten direkt im Prompt oder nutzt die serverseitigen Web- und X-Such-Tools von xAI (Abrechnung pro Aufruf).
• Nutze System-Messages, um Rolle, Tonalität und Ausgabeformat klar vorzugeben. Fordere JSON inklusive Schema an, wenn dein Code die Antwort parsen soll.
• Rate-Limits abfangen: Baue bei einem 429-Fehler einen automatischen Retry nach kurzer Wartezeit ein.
• Richtlinien einhalten: Die Acceptable Use Policy von xAI gilt auch für API-Zugriffe. Über das Feld safety_identifier kannst du Anfragen einzelnen Endnutzern zuordnen.

Fehlerbehebung

• 401 oder 403: Der Key fehlt, wurde widerrufen oder in der falschen Umgebung geladen. Lass dir auf dem Server die ersten Zeichen ausgeben, um zu prüfen, ob er ankommt.
• Model not found: Prüfe das Präfix. OpenRouter erwartet x-ai/grok-4.7, xAI schlicht grok-4.7.
• Leere oder sehr langsame Antworten bei Reasoning-Modellen bedeuten meist, dass das Output-Budget fürs Nachdenken aufgebraucht wurde. Reduziere den Effort oder erhöhe max_tokens.
• Bild abgelehnt: Konvertiere die Datei in JPEG oder PNG und halte das Größenlimit ein.

FAQ

Ist die Grok API mit dem OpenAI SDK kompatibel?

Ja. Konfiguriere das SDK einfach mit https://api.x.ai/v1 und deinem xAI-Key oder nutze OpenRouter mit entsprechendem Key und der jeweiligen Grok-Modell-ID.

Gibt es eine kostenlose Grok API?

Ein dauerhaft kostenloser Tarif wird nicht angeboten. Sowohl xAI als auch OpenRouter rechnen nach Token ab, kurze Tests kosten jedoch nur Centbruchteile.

Kann ich mit der Grok API Bilder generieren?

Ja, über die Grok Imagine-Modelle von xAI über einen eigenen Images-Endpunkt. Mehr dazu auf unserer Grok Imagine-Seite. Unser Webchat generiert keine Bilder.

Welches Grok-Modell nutzt Grok.Online?

Unser Chat bietet Grok 4.20 ohne Reasoning, Grok 4.3 mit niedrigem Reasoning-Aufwand sowie bis zu 10 Nachrichten pro Tag mit Grok 4.7 – alles angebunden über OpenRouter.