Das xAI Python SDK
Auf dieser Seite
Aktualisiert am 3. November 2026, basierend auf den xAI-Best Practices und der API-Referenz: Die Temperatur ist auf 1 begrenzt und wird mit 0,7 empfohlen. Quelle: Best Practices. Das Beispiel folgt dem SDK README (
chat.append(user(...)),chat.sample(),response.content) und wurde zur Verifizierung ausgeführt.
Das offizielle xAI Python SDK
Das native Python SDK von xAI ist der direkteste Weg, um mit der Grok-API zu arbeiten. Es stellt die spezifischen Funktionen der Plattform bereit und erhält Updates, sobald neue Modelle oder Endpunkte hinzugefügt werden.
Installation
Installieren Sie das SDK mit pip in Ihrer Python-Umgebung:
pip install xai-sdk
Wir empfehlen die Verwendung einer virtuellen Umgebung, um die Abhängigkeiten jedes Projekts zu isolieren:
python -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate # Windows
pip install xai-sdk
Initialisierung des Clients
Die Klasse Client ist der Einstiegspunkt des SDKs. Sie übernimmt die Authentifizierung, HTTP-Verbindungen und die Serialisierung von Anfragen:
from xai_sdk import Client
import os
client = Client(api_key=os.getenv("XAI_API_KEY"))
Wenn die Umgebungsvariable XAI_API_KEY gesetzt ist, können Sie den Client auch ohne explizites Argument erstellen:
client = Client()
Das SDK erkennt die Variable automatisch und nutzt sie für die Authentifizierung.
Eine Anfrage senden
Sobald der Client initialisiert ist, denkt das SDK in Gesprächen: client.chat.create() erstellt das Gespräch (ohne etwas zu senden), append fügt eine Nachricht hinzu, die mit user() oder system() erstellt wurde, und sample() fragt das Modell nach seiner Antwort:
import os
from xai_sdk import Client
from xai_sdk.chat import user
client = Client(api_key=os.getenv("XAI_API_KEY"))
chat = client.chat.create(model="grok-4.7")
chat.append(user("Erkläre, was eine REST-API ist, in 3 Sätzen."))
response = chat.sample()
print(response.content)
Häufige Parameter
model: Die ID des zu verwendenden Modells (erforderlich); xAI empfiehltgrok-4.7messages: Die Startnachrichten des Gesprächs, erstellt mitsystem(),user()undassistant()ausxai_sdk.chat(einfache Wörterbücher führen zum Scheitern des Aufrufs)temperature: Von 0 bis 2, oberhalb davon auf 1 begrenzt; xAI empfiehlt 0,7, mittop_pbei 0,95max_tokens: Die maximale Anzahl der generierten Tokensreasoning_effort: Die Tiefe der Überlegung (none,low,medium,high), die xAI empfiehlt, bei jeder Anfrage festzulegen
Streaming erfolgt nicht über einen Parameter: for response, chunk in chat.stream(): gibt die Fragmente zurück, die in chunk.content eintreffen. Lektion 10 zeigt Streaming über die REST-API mittels SSE.
Vorteile des nativen SDK
Im Vergleich zum OpenAI SDK, das auf die xAI-API zeigt (nächste Lektion), bietet das native SDK direkten Zugriff auf xAI-spezifische Funktionen: X und Websuche, serverseitige Tools, Videogenerierung und Dokumentensammlungen. Die vollständigen Python-Typen ermöglichen die Autocomplete-Funktion Ihres Editors, und xAI hält es im Takt der API auf dem neuesten Stand. Es hat zudem seine eigene Struktur, die Sie akzeptieren müssen: Es läuft über gRPC, seine Nachrichten werden mit user() und system() erstellt, und seine Fehler sind grpc.RpcError.
Wann Sie dieses SDK wählen sollten
Die Entscheidung ergibt sich natürlich aus Ihrer Situation. Für ein neues Projekt, das speziell auf der Grok-API basiert, ist das native SDK der offensichtliche Ausgangspunkt: Sie erhalten alles oben Genannte ohne Kompatibilitätsbeschränkungen. Es wird unverzichtbar, sobald Sie xAI-spezifische Funktionen wie die X-Suche oder die integrierte Websuche planen, die nur auf diese Weise vollständig funktionieren. Wenn Sie andererseits bestehenden Code auf Basis des OpenAI SDK haben, sollten Sie nichts umschreiben: Die nächste Lektion zeigt, wie Sie ihn durch das Ändern von zwei Zeilen anpassen können.
Kernaussagen
- Installieren Sie mit
pip install xai-sdkin einer virtuellen Umgebung - Die Klasse
Clientist der Einstiegspunkt mit automatischer Erkennung vonXAI_API_KEY client.chat.create()erstellt ein Gespräch;chat.append(user(...))fügt eine Nachricht hinzu, undchat.sample()gibt die Antwort zurück, gelesen ausresponse.content- Bevorzugen Sie dieses SDK für neue Projekte, die ausschließlich die Grok-API ansprechen