De xAI Python SDK
Op deze pagina
Bijgewerkt op 3 november 2026, gebaseerd op de best practices en API-referentie van xAI: temperatuur beperkt tot 1 en aanbevolen op 0,7. Bron: Best practices. Het aanroepvoorbeeld volgt de SDK README (
chat.append(user(...)),chat.sample(),response.content) en is uitgevoerd ter verificatie.
De officiële Python SDK van xAI
De native Python SDK van xAI is de meest directe manier om met de Grok API te werken. Deze SDK biedt toegang tot de specifieke functies van het platform en ontvangt als eerste updates wanneer er nieuwe modellen of eindpunten worden toegevoegd.
Installatie
Installeer de SDK met pip in uw Python-omgeving:
pip install xai-sdk
Wij raden aan een virtuele omgeving te gebruiken om de afhankelijkheden van elk project te isoleren:
python -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate # Windows
pip install xai-sdk
De client initialiseren
De klasse Client is het startpunt van de SDK. Deze verzorgt de authenticatie, HTTP-verbindingen en de serialisatie van verzoeken:
from xai_sdk import Client
import os
client = Client(api_key=os.getenv("XAI_API_KEY"))
Als de omgevingsvariabele XAI_API_KEY is ingesteld, kunt u de client ook maken zonder expliciet argument:
client = Client()
De SDK detecteert de variabele automatisch en gebruikt deze voor authenticatie.
Een verzoek verzenden
Zodra de client is geïnitialiseerd, denkt de SDK in termen van conversaties: client.chat.create() maakt de conversatie aan (zonder iets te verzenden), append voegt een bericht toe dat is opgebouwd met user() of system(), en sample() vraagt het model om een antwoord:
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("Leg uit wat een REST API is in 3 zinnen."))
response = chat.sample()
print(response.content)
Veelgebruikte parameters
model: de ID van het te gebruiken model (verplicht); xAI raadtgrok-4.7aanmessages: de startberichten van de conversatie, opgebouwd metsystem(),user()enassistant()uitxai_sdk.chat(gewone dictionaries laten de aanroep mislukken)temperature: van 0 tot 2, daarboven beperkt tot 1; xAI raadt 0,7 aan, mettop_pop 0,95max_tokens: het maximum aantal gegenereerde tokensreasoning_effort: de diepgang van de redenering (none,low,medium,high), die xAI aanraadt bij elk verzoek in te stellen
Streaming verloopt niet via een parameter: for response, chunk in chat.stream(): retourneert de fragmenten terwijl ze binnenkomen in chunk.content. Les 10 toont streaming met de REST API via SSE.
Voordelen van de native SDK
In vergelijking met de OpenAI SDK die op de xAI API is gericht (volgende les), biedt de native SDK directe toegang tot xAI-specifieke functies: X- en webzoekopdrachten, server-side tools, videogeneratie en documentcollecties. De volledige Python-typen verbeteren de autocomplete-functie van uw editor en xAI onderhoudt deze SDK op hetzelfde tempo als de API. De SDK heeft wel een eigen structuur die u moet accepteren: deze werkt via gRPC, berichten worden opgebouwd met user() en system(), en fouten zijn van het type grpc.RpcError.
Wanneer kiest u voor deze SDK?
De keuze volgt logisch uit uw situatie. Voor een nieuw project dat specifiek is gebouwd op de Grok API, is de native SDK het voor de hand liggende startpunt: u krijgt alles wat hierboven staat zonder compatibiliteitsbeperkingen. Deze SDK wordt essentieel zodra u van plan bent xAI-specifieke functies te gebruiken, zoals X-zoekopdrachten of ingebouwde webzoekopdrachten, die alleen op deze manier volledig werken. Heeft u daarentegen bestaande code die is gebouwd op de OpenAI SDK? Herschrijf dan niets voor nu: de volgende les laat zien hoe u deze aanpast door slechts twee regels te wijzigen.
Belangrijkste punten
- Installeer met
pip install xai-sdkin een virtuele omgeving - De klasse
Clientis het startpunt, met automatische detectie vanXAI_API_KEY client.chat.create()maakt een conversatie aan;chat.append(user(...))voegt een bericht toe enchat.sample()retourneert het antwoord, uit te lezen viaresponse.content- Geef de voorkeur aan deze SDK voor nieuwe projecten die uitsluitend gericht zijn op de Grok API