Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Le SDK Python d'xAI

Lektion 5 av 14 Uppdaterad 3 november 2026 Utvecklare
På denna sida
  1. Le SDK Python officiel d’xAI
  2. Installation
  3. Initialisation du client
  4. Envoi d’une requête
  5. Avantages du SDK natif
  6. Quand choisir ce SDK
  7. Viktiga punkter

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.

pip
Installation standard
Client
Classe principale
Auto
Détection automatique de la clé API
Natif
Prise en charge complète d'xAI

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 recommande grok-4.7
  • messages : les messages initiaux de la conversation, construits avec system(), user() et assistant() depuis xai_sdk.chat (les dictionnaires bruts font échouer l’appel)
  • temperature : de 0 à 2, plafonnée à 1 au-delà ; xAI recommande 0,7, avec top_p à 0,95
  • max_tokens : le nombre maximal de jetons générés
  • reasoning_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-sdk dans un environnement virtuel
  • La classe Client est le point d’entrée, avec détection automatique de XAI_API_KEY
  • client.chat.create() crée une conversation ; chat.append(user(...)) ajoute un message, et chat.sample() renvoie la réponse, lue depuis response.content
  • Privilégie ce SDK pour les nouveaux projets ciblant uniquement l’API Grok