L'API xAI pour les développeurs — Découverte de Grok & xAI

Intégrer Grok dans vos applications

L’API xAI vous permet d’intégrer les capacités de Grok directement dans vos applications, sites web et services. Cette leçon vous donne un aperçu des possibilités offertes par l’API et des premières étapes pour l’utiliser.

Prérequis

Avant de commencer, assurez-vous d’avoir :

Un compte xAI créé sur accounts.x.ai
Une clé API générée sur console.x.ai
Un moyen de paiement configuré (pour dépasser le quota gratuit)
Un environnement de développement Python ou JavaScript

Configuration initiale

Variable d’environnement

La première étape est de stocker votre clé API de manière sécurisée dans une variable d’environnement :

export XAI_API_KEY="xai-votre-cle-ici"

Ne codez jamais votre clé API en dur dans votre code source. Utilisez toujours des variables d’environnement ou un gestionnaire de secrets.

Installation du SDK

Plusieurs SDKs sont disponibles selon votre langage :

SDK natif xAI (Python) :

pip install xai-sdk

SDK OpenAI compatible (Python) :

pip install openai

Vercel AI SDK (JavaScript) :

npm install ai @ai-sdk/xai

Votre première requête

Avec le SDK natif xAI

from xai_sdk import Client
import os

client = Client(api_key=os.getenv("XAI_API_KEY"))
response = client.chat.create(model="grok-4.20-reasoning")

Avec le SDK OpenAI (compatibilité)

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1"
)

response = client.responses.create(
    model="grok-4.20-reasoning",
    input="Explique-moi le machine learning en 3 phrases."
)

Avec cURL

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.20-reasoning",
    "input": "Bonjour, comment vas-tu ?"
  }'

Les fonctionnalités de l’API

L’API xAI expose un large éventail de fonctionnalités :

Génération de texte : réponses conversationnelles, rédaction, analyse
Raisonnement : résolution de problèmes complexes étape par étape
Streaming : réception des réponses en temps réel, token par token
Recherche web et X : accès à l’information en temps réel
Compréhension d’images : analyse d’images fournies en entrée
Génération d’images et vidéos : création visuelle via grok-imagine
Voix : conversations vocales et TTS
Function calling : appel de fonctions personnalisées
Sorties structurées : génération de JSON garanti
Exécution de code : exécution de code côté serveur
RAG : recherche dans des collections de documents

Les modèles disponibles

Modèles de raisonnement

grok-4.20-reasoning : le modèle le plus puissant, avec raisonnement avancé
grok-4-1-fast-reasoning : modèle rapide et économique, 10x moins cher

Modèles sans raisonnement

Les mêmes modèles existent en version non-reasoning, adaptés aux tâches simples où le raisonnement étape par étape n’est pas nécessaire.

Conventions de nommage

grok-4.20 : dernière version stable recommandée
grok-4.20-latest : version la plus récente (peut changer)
grok-4.20-0309 : version figée à une date précise (9 mars)

Limites de débit

L’API impose des limites de débit pour garantir un service stable :

10 millions de tokens par minute (TPM)
1 800 requêtes par minute (RPM)

Pour les modèles de génération d’images et de vidéos, des limites spécifiques s’appliquent (30 à 300 RPM selon le modèle).

Bonnes pratiques

Utilisez le streaming pour les réponses longues afin d’améliorer l’expérience utilisateur
Activez le cache en utilisant un identifiant de conversation pour réduire les coûts
Choisissez le bon modèle : grok-4-1-fast pour les tâches simples, grok-4.20 pour le raisonnement
Gérez les erreurs : implémentez des retries avec backoff exponentiel
Surveillez votre consommation via la console pour éviter les surprises de facturation

Points clés à retenir

L’API xAI est compatible avec le format OpenAI, facilitant la migration
Plusieurs SDKs sont disponibles : xAI natif, OpenAI, Vercel AI SDK
L’API couvre le texte, les images, les vidéos, la voix et la recherche
Deux niveaux de modèles : grok-4.20 (puissant) et grok-4-1-fast (économique)
Stockez toujours votre clé API dans une variable d’environnement, jamais en dur dans le code