L’API de xAI, l’entreprise appelée SpaceXSI depuis l’automne 2026, permet d’appeler les modèles Grok depuis un programme : un site, un script, un agent. Elle sert du texte, des images, des vidéos et de la voix, et peut lancer elle-même des recherches sur le web et dans X. Elle se paie à l’usage, en dollars, avec des crédits achetés sur la console. Ce guide s’adresse à quelqu’un qui sait lancer une commande dans un terminal.
Comment ça marche
Votre programme envoie une requête à https://api.x.ai/v1 avec une clé secrète. Le modèle répond, éventuellement après avoir appelé des outils que SpaceXSI fait tourner de son côté. La facture compte les jetons lus, les jetons écrits, les jetons servis depuis le cache et, à part, les appels d’outils.
L’API suit le format d’OpenAI : la bibliothèque d’OpenAI fonctionne en changeant seulement l’adresse et la clé. SpaceXSI publie aussi son propre SDK pour Python (xai-sdk), et le Vercel AI SDK a son module @ai-sdk/xai. La documentation recommande l’API Responses ; l’ancienne API Chat Completions est rangée parmi les interfaces « Legacy ».
Créer une clé et faire une première requête

- Ouvrez un compte sur console.x.ai et ajoutez des crédits : sans crédits, aucune requête ne passe.
- Créez une clé dans la page « API Keys » de la console. Copiez-la tout de suite et gardez-la hors de votre code.
- Rangez la clé dans une variable d’environnement :
export XAI_API_KEY="votre_cle"
- Installez une bibliothèque, au choix :
pip install xai-sdk
ou, pour la bibliothèque d’OpenAI, pip install openai, ou en JavaScript, npm install ai @ai-sdk/xai zod.
- Envoyez une première requête avec curl :
curl https://api.x.ai/v1/responses \
-H "Authorization: Bearer $XAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "grok-4.7",
"input": "Explique en trois phrases ce que fait la commande git rebase."
}'
ou en Python, avec la bibliothèque d’OpenAI :
import os
from openai import OpenAI
client = OpenAI(api_key=os.getenv("XAI_API_KEY"), base_url="https://api.x.ai/v1")
reponse = client.responses.create(
model="grok-4.7",
input="Corrige cette fonction et explique le bogue : function median(a){a.sort();return a[a.length/2]}",
)
print(reponse.output_text)
- Générez une image, pour vérifier l’accès aux modèles Imagine :
curl -X POST https://api.x.ai/v1/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $XAI_API_KEY" \
-d '{"model": "grok-imagine-image-2.0", "prompt": "Une gare de province sous la neige, au crépuscule"}'
Quel modèle choisir

La documentation est simple : pour tout ce qui est texte, code compris, prenez Grok 4.7, « le modèle le plus capable » de la maison. Il lit 500 000 jetons de contexte, accepte texte et images en entrée, répond en texte, sans limite de longueur de sortie, avec une réflexion réglable. Ses connaissances s’arrêtent en mai 2026. Les noms suivent une règle : grok-4.7 désigne la dernière version stable, un suffixe -latest la toute dernière, un suffixe daté une version figée, à préférer pour un traitement qui doit rester identique.
| Modèle | Contexte | Entrée | Entrée en cache | Sortie |
|---|---|---|---|---|
| grok-4.7 | 500 000 | 2,00 $ | 0,50 $ | 6,00 $ |
| grok-4.6 | 500 000 | 2,00 $ | 0,50 $ | 6,00 $ |
| grok-4.5 | 500 000 | 2,00 $ | 0,30 $ | 6,00 $ |
| grok-4.3 | 1 000 000 | 1,25 $ | 0,20 $ | 2,50 $ |
| grok-build-0.1 | 256 000 | 1,00 $ | 0,20 $ | 2,00 $ |
Prix par million de jetons, en dollars, relevés le 17 novembre 2026, pour une requête de moins de 200 000 jetons. Au-delà, tous les jetons de la requête passent au double. Les variantes grok-4.20-0309 (avec ou sans réflexion, et en plusieurs agents) restent servies au tarif de grok-4.3.
Le classement de QUELLE IA place ces modèles parmi ceux des autres éditeurs, sur le code et sur les tâches d’agent :
Le haut du classement Code
- Claude Opus 5.5Anthropic101,4
- Gemini 4 CarbonGoogle DeepMind100,6
- Claude Fable 5.1Anthropic100,1
- Claude Sonnet 5.5Anthropic99,8
- GPT-6 AstraOpenAI99,3
Score Code, édition du 16 novembre 2026. Deux modèles dont les marges se recouvrent sont ex æquo.
Le haut du classement Agents
- GPT-6 AstraOpenAI100,3
- Claude Opus 5.5Anthropic100,1
- Gemini 4 ArgonGoogle DeepMind99,3
- Claude Fable 5.1Anthropic97,4
- GPT-6.1 SolOpenAI96,0
Score Agents, édition du 16 novembre 2026. Deux modèles dont les marges se recouvrent sont ex æquo.
Images, vidéos et voix
| Modèle | Prix |
|---|---|
| grok-imagine-image | 0,02 $ par image |
| grok-imagine-image-2.0 | 0,04 $ par image |
| grok-imagine-video-1.5-lite | 0,02 $ par seconde |
| grok-imagine-video | 0,05 $ par seconde |
| grok-imagine-video-1.5 | 0,08 $ par seconde |
| grok-voice-3.0 (voix à voix) | 0,08 $ la minute |
| Synthèse vocale | 15 $ le million de caractères |
| Transcription | 0,10 $ l’heure, 0,20 $ en direct |
Les vidéos durent de 1 à 15 secondes ; grok-imagine-video-1.5 les rend en 1080p natif, avec des voix synchronisées sur les lèvres et jusqu’à 14 images de référence. Les demandes sont asynchrones : on envoie, on interroge avec l’identifiant rendu, puis on télécharge.
Les outils côté serveur
Avec le champ tools, le modèle décide lui-même d’appeler des outils que SpaceXSI exécute. Chaque appel se paie en plus des jetons :
| Outil | Ce qu’il fait | Prix |
|---|---|---|
web_search |
cherche et lit des pages web | 5 $ les 1 000 appels |
x_search |
cherche des publications, des profils et des fils de X | 5 $ les 1 000 publications, 10 $ les 1 000 profils |
code_execution |
exécute du Python dans un bac à sable | 5 $ les 1 000 appels |
collections_search |
cherche dans vos documents déposés | 2,50 $ les 1 000 appels |
| serveurs MCP distants | branche vos propres outils | jetons seulement |
Pour une recherche sur le web, il suffit d’ajouter "tools": [{"type": "web_search"}] à la requête. Sans outil de recherche, le modèle ne sait rien de l’actualité postérieure à son entraînement, rappelle la documentation.
Payer moins
- Le cache : un début de requête identique d’un appel à l’autre (consignes, documents) est facturé au tarif « en cache », quatre fois moins cher pour grok-4.7.
- L’API Batch : des requêtes traitées en arrière-plan, en général sous 24 heures, coûtent 20 % de moins sur les modèles Grok 4.x et ne comptent pas dans les limites de débit.
- Le bon modèle : pour une tâche simple, grok-4.3 coûte 1,6 fois moins cher que grok-4.7 en entrée et 2,4 fois moins cher en sortie, avec un contexte d’un million de jetons.
Le guide jetons et prix explique comment estimer le coût d’une tâche.
Données et lieu de traitement
- Entraînement : SpaceXSI écrit qu’elle n’entraîne jamais ses modèles sur les requêtes et réponses de l’API sans votre permission explicite. Elles sont gardées 30 jours, chiffrées, pour enquêter sur un éventuel abus, puis effacées.
- Lieu : l’adresse générale
api.x.aipeut faire traiter une requête dans n’importe quelle région. L’adressehttps://us.api.x.ai/v1garantit un traitement aux États-Unis, pour grok-4.7 et grok-4.6 seulement, sans images, vidéos ni voix, avec des jetons 10 % plus chers. La documentation lue ne propose pas d’adresse européenne. - Filigrane : un filigrane invisible peut marquer le texte (désactivé par défaut, à allumer par modèle dans la console) et marque d’office l’audio des API de voix. Pour un utilisateur final situé dans l’Union européenne, l’Espace économique européen ou en Californie, le filigrane audio ne peut pas être retiré.
Limites et précautions
- Une clé est un moyen de paiement. Ne la mettez jamais dans une appli de téléphone ou une page web : quiconque la lit dépense vos crédits. Faites passer les appels par votre serveur.
- Les prix sont en dollars, hors taxes, et changent : relisez la page de tarifs avant un gros traitement.
- Les modèles changent de nom. Un modèle retiré renvoie parfois vers un autre, comme
grok-imagine-image-quality, servi par Image 2.0 depuis le 2 novembre 2026. Suivez la page « Release Notes ». - Les recherches dans X coûtent à la publication lue, publications citées et parentes comprises : une question large peut en ramener beaucoup.
Les outils pour développeurs
Les outils pour développeurs
- Foundry LocalMicrosoft, États-Unisopen source (MIT)
- HereticPhilipp Emanuel Weidmann et contributeursopen source (AGPL-3.0-or-later)
- LemonadeAMDopen source (Apache-2.0)
- LocalAILocalAIopen source (MIT)
- MLX LMAppleopen source (MIT)
- NVIDIA AI WorkbenchNVIDIA, États-Uniscode fermé
- NVIDIA NIM on WSL2NVIDIA, États-Uniscode fermé
- NVIDIA PAIR (Personal AI Router)NVIDIA, États-Unisopen source (Apache-2.0)
- vLLMvLLMopen source (Apache-2.0)
- xAI SDKxAI, États-Unisopen source (Apache-2.0)
Rangés par ordre alphabétique, sans note ni classement.
Pour aller plus loin
- Jetons, prix au million et vrai coût d'une tâcheNiveau Amateur 5 min
- MCP : brancher des outils dans Claude, ChatGPT ou un agentNiveau Amateur 15 min
- Grok et xAI : l'assistant, les agents, les images et l'APINiveau Débutant 11 min
- Grok Bot : des agents d'xAI qui travaillent sur leur ordinateurNiveau Amateur 22 min
- Adobe Firefly : le studio d'IA d'Adobe et ses modèles partenairesNiveau Débutant 10 min
- Anthropic et Claude : les produits, les modèles et les formulesNiveau Débutant 12 min
- Bien démarrer avec ChatGPT sur le web, l'ordinateur et le mobileNiveau Débutant 12 min
Pour monter son atelier d'IA à la maison, mini lab AI, du même auteur, va plus loin.
Sources
- Documentation de SpaceXSI, Quickstart, lue le
- Documentation de SpaceXSI, Models, lue le
- Documentation de SpaceXSI, Pricing, lue le
- Documentation de SpaceXSI, Release Notes, lue le
- Documentation de SpaceXSI, Tools, lue le
- Documentation de SpaceXSI, Web Search, lue le
- Documentation de SpaceXSI, Regional Endpoints, lue le
- Documentation de SpaceXSI, Output Watermarking, lue le
- Documentation de SpaceXSI, FAQ sécurité, lue le
- Documentation de SpaceXSI, Video Overview, lue le
- xAI, Introducing Grok 4.7 (21 septembre 2026), lue le
- xAI, Introducing Grok Voice 3.0 (14 octobre 2026), lue le
