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",
    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

Le SDK xAI offre plusieurs avantages par rapport à l’utilisation du SDK OpenAI en mode compatibilité :

• Support prioritaire des nouvelles fonctionnalités (recherche X, exécution de code)
• Types Python complets pour l’autocomplétion dans votre IDE
• Gestion d’erreurs adaptée aux codes spécifiques de l’API xAI
• Mises à jour alignées sur les évolutions de l’API

Quand choisir ce SDK

Utilisez le SDK natif xAI si :

• Vous démarrez un nouveau projet spécifiquement pour l’API Grok
• Vous avez besoin de fonctionnalités propres à xAI (recherche X, recherche web intégrée)
• Vous voulez bénéficier du support le plus complet

Si vous avez du code existant basé sur le SDK OpenAI, la leçon suivante vous montrera comment l’adapter sans tout réécrire.

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