xAI SDK Python

Le SDK officiel de xAI pour Python

Le SDK Python natif de xAI est la méthode la plus directe pour interagir avec l’API Grok. Il expose les fonctionnalités spécifiques de la plateforme et bénéficie des mises à jour en priorité lorsque de nouveaux modèles ou endpoints sont ajoutés.

Installation

Installez le SDK avec pip dans votre environnement Python :

pip install xai-sdk

Il est recommandé 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

Initialiser le 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, vous pouvez aussi créer le client sans argument explicite :

client = Client()

Le SDK détecte automatiquement la variable et l’utilise pour l’authentification.

Envoyer une requête

Une fois le client initialisé, utilisez la méthode chat.create pour envoyer un message au modèle :

from xai_sdk import Client
import os

client = Client(api_key=os.getenv("XAI_API_KEY"))

response = client.chat.create(
    model="grok-4.5",
    messages=[
        {"role": "user", "content": "Expliquez-moi ce qu'est une API REST en 3 phrases."}
    ]
)

print(response.choices[0].message.content)

Paramètres courants

• model : identifiant du modèle à utiliser (obligatoire)
• messages : liste des messages de la conversation (obligatoire)
• temperature : entre 0 et 2, contrôle la créativité des réponses
• max_completion_tokens : limite le nombre de tokens générés
• stream : active le streaming (voir leçon 10)

Avantages du SDK natif

Par rapport au SDK OpenAI en mode compatibilité, le SDK natif joue sur son terrain : les nouvelles fonctionnalités xAI — recherche X, exécution de code — y arrivent en premier, parfois bien avant d’être accessibles (quand elles le deviennent) par le chemin de compatibilité. Le confort de développement suit : des types Python complets qui alimentent l’autocomplétion de votre IDE, et une gestion d’erreurs qui parle le langage exact des codes de l’API xAI plutôt que de traduire approximativement des erreurs pensées pour un autre fournisseur. Enfin, ses mises à jour suivent le rythme de l’API elle-même : quand un endpoint évolue, le SDK natif est aligné le jour même.

Quand choisir ce SDK

Le choix découle naturellement de votre situation. Pour un nouveau projet construit spécifiquement sur l’API Grok, le SDK natif est le point de départ évident — vous bénéficiez de tout ce qui précède sans aucune contrainte de compatibilité à respecter. Il devient carrément indispensable dès que vous comptez utiliser des fonctionnalités propres à xAI comme la recherche X ou la recherche web intégrée, qui ne s’expriment pleinement que par cette voie. Si en revanche vous avez du code existant bâti sur le SDK OpenAI, ne réécrivez rien pour l’instant : la leçon suivante montre comment l’adapter en changeant deux lignes.

Points clés à retenir

• Installez 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
• Utilisez client.chat.create() pour envoyer des requêtes
• Préférez ce SDK pour les nouveaux projets ciblant exclusivement l’API Grok