Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Die xAI-API für Entwickler

Lektion 15 von 16 Aktualisiert am 29. Juli 2026 Anfänger
Auf dieser Seite
  1. Grok in Ihre Anwendungen integrieren
  2. Voraussetzungen
  3. Erste Einrichtung
  4. Ihre erste Anfrage
  5. Was die API bereitstellt
  6. Modellwahl
  7. Ratenlimits und Best Practices
  8. Wichtige Erkenntnisse

Grok in Ihre Anwendungen integrieren

Alles, was Sie in der Grok-Oberfläche tun können, lässt sich aus Ihrem eigenen Code auslösen. Die xAI-API bringt diese Fähigkeiten in Ihre Apps, Websites und Dienste: Das Gespräch hört auf, ein Ort zu sein, den Sie besuchen, und wird zu einer Funktion, die Ihr Produkt aufruft.

Voraussetzungen

Bevor Sie die erste Zeile Code schreiben, benötigen Sie vier Dinge:

  1. Ein xAI-Konto, das unter accounts.x.ai erstellt wurde
  2. Einen API-Schlüssel, der unter console.x.ai generiert wurde
  3. Eine Zahlungsmethode, die eingerichtet ist (um über das kostenlose Kontingent hinaus zu gehen)
  4. Eine Python- oder JavaScript-Entwicklungsumgebung

Die ersten beiden Punkte haben Sie in diesem Kurs bereits erledigt: Das Konto übernimmt die Authentifizierung, und der Schlüssel identifiziert Ihre Anwendung für die API. Die Zahlungsmethode kommt nur ins Spiel, sobald Ihr Verbrauch das kostenlose Kontingent überschreitet, was schneller passiert, als man denkt, sobald ein Dienst kontinuierlich läuft. Was die Umgebung betrifft, so bieten Python und JavaScript die besten Werkzeuge, doch da die API HTTP spricht, reicht jede Sprache, die eine Anfrage senden kann.

Erste Einrichtung

Der erste Schritt besteht darin, Ihren API-Schlüssel sicher in einer Umgebungsvariablen zu speichern:

export XAI_API_KEY="xai-your-key-here"

Kodieren Sie Ihren Schlüssel niemals direkt in Ihrem Quellcode. Der Grund ist prosaisch: Ein in einer Datei geschriebener Schlüssel landet früher oder später in einem Git-Repository, und ein Schlüssel, der in ein öffentliches Repository hochgeladen wird, wird innerhalb weniger Minuten von Bots ausgenutzt, die Commits scannen, während die Rechnung auf Ihrem Namen verbleibt.

Als Nächstes wählen Sie ein SDK. Das native xAI-SDK für Python wird mit pip install xai-sdk installiert. Wenn Ihr Code bereits OpenAI aufruft, funktioniert die openai-Bibliothek so, wie sie ist, dank der Formatkompatibilität. Auf der JavaScript-Seite fügen Sie das Vercel AI SDK mit npm install ai @ai-sdk/xai hinzu, und es integriert sich mit React- und Next.js-Anwendungen.

Ihre erste Anfrage

Mit dem nativen SDK dauert das Erstellen des Clients und das Öffnen eines Gesprächs drei Zeilen:

from xai_sdk import Client
import os

client = Client(api_key=os.getenv("XAI_API_KEY"))
response = client.chat.create(model="grok-4.5")

Der OpenAI-kompatible Weg ist ebenso direkt: Nur die base_url unterscheidet sich vom bestehenden Code, weshalb viele Teams innerhalb weniger Minuten wechseln.

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1"
)

response = client.responses.create(
    model="grok-4.5",
    input="Explain machine learning to me in 3 sentences."
)

Um zu prüfen, ob ein Schlüssel funktioniert, bevor Sie überhaupt Code schreiben, gibt es nichts Besseres als einen Aufruf aus der Kommandozeile:

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.5",
    "input": "Hi, how are you?"
  }'

Was die API bereitstellt

Die Grundlage bildet die Textgenerierung (konversationelle Antworten, Schreiben, Analyse), ergänzt durch einen Denkmodus, der komplexe Probleme Schritt für Schritt löst. Streaming erweitert dies, indem es die Antwort Token für Token liefert, anstatt bis zum Abschluss der Generierung zu warten.

Eine zweite Gruppe bietet Zugriff auf Informationen: Echtzeit-Web- und X-Suche sowie RAG, das Dokumentensammlungen abfragt, die Sie erstellt haben. Die multimodale Seite umfasst das Verständnis von Bildern, die Sie bereitstellen, die Generierung von Bildern und Videos mit grok-imagine sowie Sprache mit gesprochenen Gesprächen und Text-to-Speech (TTS).

Schließlich ermöglichen drei Mechanismen die Programmierbarkeit der API im strengen Sinne: Funktionsaufrufe, die es dem Modell erlauben, Ihre eigenen Funktionen aufzurufen; strukturierte Ausgaben, die nutzbares JSON ohne zerbrechliche Nachbearbeitung garantieren; und Codeausführung auf dem Server.

Modellwahl

Die Leistungsfähigkeit des Denkens variiert je nach Modell. grok-4.7, die Flaggschiff-Version, bietet konfigurierbares Denken: Der Parameter reasoning_effort (low, medium, high oder xhigh) legt fest, wie tief das Modell pro Anfrage nachdenkt. grok-4.3 bleibt die Budget- und sehr-lange-Kontext-Option, etwa zur Hälfte des Preises. Nicht-denkende Versionen der Modelle existieren für einfache Aufgaben: Umschreiben oder Klassifizierung benötigen keine interne Abwägung.

Namenskonventionen beeinflussen die Stabilität Ihrer Anwendung:

  • grok-4.20: die neueste empfohlene stabile Version
  • grok-4.20-latest: die neueste Version (kann sich ändern)
  • grok-4.20-0309: eine Version, die auf ein bestimmtes Datum (9. März) festgelegt ist

In der Produktion schützt eine festgelegte Version Ihre Prompts vor stillen Änderungen am Modell; latest ist für die Erkundung in Ordnung, solange Sie akzeptieren, dass sich das Verhalten verschieben kann.

Ratenlimits und Best Practices

Die API setzt Ratenlimits durch, um den Dienst stabil zu halten: Auf der Einstiegsstufe etwa 10 Millionen Token pro Minute und 1.800 Anfragen pro Minute für Modelle wie grok-4.3, und mehr, je höher Ihr Tarif ist. Modelle für die Bild- und Videogenerierung haben eigene, deutlich niedrigere Obergrenzen, von 30 bis 300 Anfragen pro Minute je nach Modell, also achten Sie bei einem für Verbraucher bestimmten Dienst darauf.

Einige Gewohnheiten trennen ein Prototyp von einer soliden Integration. Schalten Sie für lange Antworten Streaming ein, denn dreißig Sekunden vor einem leeren Bildschirm fühlen sich wie ein Ausfall an. Geben Sie eine Gesprächs-ID an, um von der Caching-Nutzung zu profitieren. Leiten Sie jede Aufgabe an das richtige Modell weiter: grok-4.3 für einfache Volumen, grok-4.20 für Denkprozesse. Behandeln Sie Fehler mit Wiederholungsversuchen und exponentiellem Backoff, sonst verwandelt sich ein Verkehrsspitze in eine Lawine abgelehnter Anfragen. Und beobachten Sie Ihren Verbrauch in der Konsole, bevor Sie das Gesamtergebnis am Monatsende entdecken.

Wichtige Erkenntnisse

  • Die xAI-API ist mit dem OpenAI-Format kompatibel, was die Migration erleichtert
  • Es stehen mehrere SDKs zur Verfügung: natives xAI, OpenAI und das Vercel AI SDK
  • Die API deckt Text, Bilder, Video, Sprache und Suche ab
  • Zwei Modellstufen: grok-4.7 (Flaggschiff, konfigurierbares Denken) und grok-4.3 (Budget, 1M Kontext)
  • Speichern Sie Ihren API-Schlüssel immer in einer Umgebungsvariablen, niemals direkt im Code