Aller au contenu
EN 4 QUESTIONSTrouver mon modèle
Les outils expliqués · guide expert · 13 min de lecture

L'API de xAI : clé, modèles Grok, prix et outils

L'API de xAI (SpaceXSI) sert Grok 4.7, les modèles d'images et de vidéos Imagine et la voix Grok Voice. Ce guide va de la clé à la première requête, détaille les prix, les outils de recherche et d'exécution, et ce qu'il faut savoir des données.

Disponible en France

Illustration du dossier xAI

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

Le trajet d'une requête : votre programme, l'adresse de l'API, le modèle et ses outils côté serveur, puis la facture en jetons et en appels d'outils. D'après la documentation de SpaceXSI, lue le 17 novembre 2026.

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

Documentation Quickstart : « Step 1: Create a SpaceXSI account », « Sign up for an account at console.x.ai, then load it with credits », « Step 2: Generate an API key » avec la commande export XAI_API_KEY.
La page « Quickstart » de la documentation : créer un compte sur console.x.ai, puis une clé d'API à exporter dans XAI_API_KEY (capture du 17 novembre 2026, docs.x.ai). Image : SpaceXSI.
  1. Ouvrez un compte sur console.x.ai et ajoutez des crédits : sans crédits, aucune requête ne passe.
  2. Créez une clé dans la page « API Keys » de la console. Copiez-la tout de suite et gardez-la hors de votre code.
  3. Rangez la clé dans une variable d’environnement :
export XAI_API_KEY="votre_cle"
  1. 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.

  1. 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)
  1. 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

Carte Grok 4.7 (grok-4.7) : contexte 500k jetons, entrée 2,00 dollars et sortie 6,00 dollars par million de jetons, réflexion configurable ; en dessous, Voice API (STS 0,08 dollar la minute, TTS 15 dollars le million de caractères) et Image & Video API (à partir de 0,02 dollar l'image).
La page « Models » de la documentation, avec Grok 4.7 et ses prix, puis les API de voix, d'images et de vidéos (capture du 17 novembre 2026, docs.x.ai). Image : SpaceXSI.

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

  1. Claude Opus 5.5Anthropic101,4
  2. Gemini 4 CarbonGoogle DeepMind100,6
  3. Claude Fable 5.1Anthropic100,1
  4. Claude Sonnet 5.5Anthropic99,8
  5. GPT-6 AstraOpenAI99,3

Score Code, édition du 16 novembre 2026. Deux modèles dont les marges se recouvrent sont ex æquo.

Classement Code des modèles de langage →

Le haut du classement Agents

  1. GPT-6 AstraOpenAI100,3
  2. Claude Opus 5.5Anthropic100,1
  3. Gemini 4 ArgonGoogle DeepMind99,3
  4. Claude Fable 5.1Anthropic97,4
  5. GPT-6.1 SolOpenAI96,0

Score Agents, édition du 16 novembre 2026. Deux modèles dont les marges se recouvrent sont ex æquo.

Classement Agents des modèles de langage →

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.ai peut faire traiter une requête dans n’importe quelle région. L’adresse https://us.api.x.ai/v1 garantit 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

Rangés par ordre alphabétique, sans note ni classement.

Tous les logiciels de cet usage →

Pour aller plus loin

Pour monter son atelier d'IA à la maison, mini lab AI, du même auteur, va plus loin.

Tous les guides →

Sources

  1. Documentation de SpaceXSI, Quickstart, lue le
  2. Documentation de SpaceXSI, Models, lue le
  3. Documentation de SpaceXSI, Pricing, lue le
  4. Documentation de SpaceXSI, Release Notes, lue le
  5. Documentation de SpaceXSI, Tools, lue le
  6. Documentation de SpaceXSI, Web Search, lue le
  7. Documentation de SpaceXSI, Regional Endpoints, lue le
  8. Documentation de SpaceXSI, Output Watermarking, lue le
  9. Documentation de SpaceXSI, FAQ sécurité, lue le
  10. Documentation de SpaceXSI, Video Overview, lue le
  11. xAI, Introducing Grok 4.7 (21 septembre 2026), lue le
  12. xAI, Introducing Grok Voice 3.0 (14 octobre 2026), lue le