Le SDK Python d'xAI
På denna sida
Mis à jour le 3 novembre 2026, sur la base des bonnes pratiques et de la référence API d’xAI : température plafonnée à 1 et recommandée à 0,7. Source : Bonnes pratiques. L’exemple d’appel suit le README du SDK (
chat.append(user(...)),chat.sample(),response.content) et a été exécuté pour vérification.
Le SDK Python officiel d’xAI
Le SDK Python natif d’xAI est le moyen le plus direct d’interagir avec l’API Grok. Il expose les fonctionnalités spécifiques de la plateforme et reçoit les mises à jour en priorité lors de l’ajout de nouveaux modèles ou points de terminaison.
Installation
Installe le SDK avec pip dans ton environnement Python :
pip install xai-sdk
Nous recommandons d’utiliser un environnement virtuel pour isoler les dépendances de chaque projet :
python -m venv venv
source venv/bin/activate # Linux/macOS
venv\Scripts\activate # Windows
pip install xai-sdk
Initialisation du client
La classe Client est le point d’entrée du SDK. Elle gère l’authentification, les connexions HTTP et la sérialisation des requêtes :
from xai_sdk import Client
import os
client = Client(api_key=os.getenv("XAI_API_KEY"))
Si la variable d’environnement XAI_API_KEY est définie, tu peux aussi créer le client sans argument explicite :
client = Client()
Le SDK détecte automatiquement la variable et l’utilise pour l’authentification.
Envoi d’une requête
Une fois le client initialisé, le SDK raisonne en termes de conversations : client.chat.create() crée la conversation (sans rien envoyer), append ajoute un message construit avec user() ou system(), et sample() demande au modèle de générer sa réponse :
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("Explique ce qu'est une API REST en 3 phrases."))
response = chat.sample()
print(response.content)
Paramètres courants
model: l’identifiant du modèle à utiliser (obligatoire) ; xAI recommandegrok-4.7messages: les messages initiaux de la conversation, construits avecsystem(),user()etassistant()depuisxai_sdk.chat(les dictionnaires bruts font échouer l’appel)temperature: de 0 à 2, plafonnée à 1 au-delà ; xAI recommande 0,7, avectop_pà 0,95max_tokens: le nombre maximal de jetons générésreasoning_effort: la profondeur du raisonnement (none,low,medium,high), qu’xAI recommande de définir sur chaque requête
Le streaming ne passe pas par un paramètre : for response, chunk in chat.stream(): renvoie les fragments au fur et à mesure de leur arrivée dans chunk.content. La leçon 10 montre le streaming avec l’API REST, via SSE.
Avantages du SDK natif
Par rapport au SDK OpenAI pointant vers l’API xAI (prochaine leçon), le SDK natif offre un accès direct aux fonctionnalités spécifiques d’xAI : recherche X et web, outils côté serveur, génération vidéo, collections de documents. Ses types Python complets alimentent l’autocomplétion de ton éditeur, et xAI le maintient au rythme de l’API. Il possède aussi sa propre structure, que tu dois accepter : il fonctionne sur gRPC, ses messages se construisent avec user() et system(), et ses erreurs sont de type grpc.RpcError.
Quand choisir ce SDK
Le choix découle naturellement de ta situation. Pour un nouveau projet construit spécifiquement sur l’API Grok, le SDK natif est le point de départ évident : tu obtiens tout ce qui précède sans contraintes de compatibilité à respecter. Il devient essentiel dès que tu prévois d’utiliser des fonctionnalités spécifiques à xAI comme la recherche X ou la recherche web intégrée, qui ne fonctionnent pleinement que de cette manière. Si, en revanche, tu possèdes du code existant basé sur le SDK OpenAI, ne réécris rien pour l’instant : la prochaine leçon montre comment l’adapter en changeant deux lignes.
Viktiga punkter
- Installe avec
pip install xai-sdkdans un environnement virtuel - La classe
Clientest le point d’entrée, avec détection automatique deXAI_API_KEY client.chat.create()crée une conversation ;chat.append(user(...))ajoute un message, etchat.sample()renvoie la réponse, lue depuisresponse.content- Privilégie ce SDK pour les nouveaux projets ciblant uniquement l’API Grok