Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

De xAI Python SDK

Les 5 van 14 Bijgewerkt op 3 november 2026 Ontwikkelaar
Op deze pagina
  1. De officiële Python SDK van xAI
  2. Installatie
  3. De client initialiseren
  4. Een verzoek verzenden
  5. Voordelen van de native SDK
  6. Wanneer kiest u voor deze SDK?
  7. Belangrijkste punten

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.

pip
Standaardinstallatie
Client
Hoofdklasse
Auto
Automatische API-sleuteldetectie
Native
Volledige xAI-ondersteuning

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 raadt grok-4.7 aan
  • messages: de startberichten van de conversatie, opgebouwd met system(), user() en assistant() uit xai_sdk.chat (gewone dictionaries laten de aanroep mislukken)
  • temperature: van 0 tot 2, daarboven beperkt tot 1; xAI raadt 0,7 aan, met top_p op 0,95
  • max_tokens: het maximum aantal gegenereerde tokens
  • reasoning_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-sdk in een virtuele omgeving
  • De klasse Client is het startpunt, met automatische detectie van XAI_API_KEY
  • client.chat.create() maakt een conversatie aan; chat.append(user(...)) voegt een bericht toe en chat.sample() retourneert het antwoord, uit te lezen via response.content
  • Geef de voorkeur aan deze SDK voor nieuwe projecten die uitsluitend gericht zijn op de Grok API