Zum Hauptinhalt springen
Deutsch— Sprache auswählen
Menü

Das xAI Python SDK

Lektion 5 von 14 Aktualisiert am 3. November 2026 Entwickler
Auf dieser Seite
  1. Das offizielle xAI Python SDK
  2. Installation
  3. Initialisierung des Clients
  4. Eine Anfrage senden
  5. Vorteile des nativen SDK
  6. Wann Sie dieses SDK wählen sollten
  7. Kernaussagen

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.

pip
Standardinstallation
Client
Hauptklasse
Auto
API-Schlüssel-Erkennung
Native
Vollständige xAI-Unterstützung

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 empfiehlt grok-4.7
  • messages: Die Startnachrichten des Gesprächs, erstellt mit system(), user() und assistant() aus xai_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, mit top_p bei 0,95
  • max_tokens: Die maximale Anzahl der generierten Tokens
  • reasoning_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-sdk in einer virtuellen Umgebung
  • Die Klasse Client ist der Einstiegspunkt mit automatischer Erkennung von XAI_API_KEY
  • client.chat.create() erstellt ein Gespräch; chat.append(user(...)) fügt eine Nachricht hinzu, und chat.sample() gibt die Antwort zurück, gelesen aus response.content
  • Bevorzugen Sie dieses SDK für neue Projekte, die ausschließlich die Grok-API ansprechen