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

> Appeler Grok depuis un programme : créer une clé sur console.x.ai, choisir le modèle, comprendre les prix en dollars, les outils et le lieu de traitement.

- Niveau : Expert
- Thème : Les outils expliqués
- Durée : 13 minutes
- Systèmes : Mac, Windows, Linux, Navigateur
- Disponible en France : La console et l'API s'ouvrent depuis la France, paiement en dollars par crédits. L'adresse générale ne garantit pas le lieu de traitement ; seule une adresse américaine le fixe, et aucune adresse européenne n'est proposée. (https://docs.x.ai/developers/advanced-api-usage/regions, lue le 17 novembre 2026)
- Publié le 17 novembre 2026, relu le 17 novembre 2026
- Auteur : Ulrich Rozier
- Page : https://quelleia.com/guides/xai-api/

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.](https://quelleia.com/guides/xai-api/une-requete-api.svg)

*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.](https://quelleia.com/guides/xai-api/demarrage-rapide-api.webp)

*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** :

```bash
export XAI_API_KEY="votre_cle"
```

4. **Installez une bibliothèque**, au choix :

```bash
pip install xai-sdk
```

ou, pour la bibliothèque d'OpenAI, `pip install openai`, ou en JavaScript, `npm install ai @ai-sdk/xai zod`.

5. **Envoyez une première requête** avec curl :

```bash
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 :

```python
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)
```

6. **Générez une image**, pour vérifier l'accès aux modèles Imagine :

```bash
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).](https://quelleia.com/guides/xai-api/modeles-et-prix-api.webp)

*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.5](https://quelleia.com/modeles/claude-opus-5-5/) : 101,4 (Anthropic)
2. [Gemini 4 Carbon](https://quelleia.com/modeles/gemini-4-carbon/) : 100,6 (Google DeepMind)
3. [Claude Fable 5.1](https://quelleia.com/modeles/claude-fable-5-1/) : 100,1 (Anthropic)
4. [Claude Sonnet 5.5](https://quelleia.com/modeles/claude-sonnet-5-5/) : 99,8 (Anthropic)
5. [GPT-6 Astra](https://quelleia.com/modeles/gpt-6-astra/) : 99,3 (OpenAI)

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](https://quelleia.com/classement/code/)

**Le haut du classement Agents**

1. [GPT-6 Astra](https://quelleia.com/modeles/gpt-6-astra/) : 100,3 (OpenAI)
2. [Claude Opus 5.5](https://quelleia.com/modeles/claude-opus-5-5/) : 100,1 (Anthropic)
3. [Gemini 4 Argon](https://quelleia.com/modeles/gemini-4-argon/) : 99,3 (Google DeepMind)
4. [Claude Fable 5.1](https://quelleia.com/modeles/claude-fable-5-1/) : 97,4 (Anthropic)
5. [GPT-6.1 Sol](https://quelleia.com/modeles/gpt-6-1-sol/) : 96,0 (OpenAI)

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](https://quelleia.com/classement/agents/)

### 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](https://quelleia.com/guides/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**

1. [Foundry Local](https://quelleia.com/logitheque/foundry-local/) : open source (MIT) (Microsoft, États-Unis)
2. [Heretic](https://quelleia.com/logitheque/heretic/) : open source (AGPL-3.0-or-later) (Philipp Emanuel Weidmann et contributeurs)
3. [Lemonade](https://quelleia.com/logitheque/lemonade/) : open source (Apache-2.0) (AMD)
4. [LocalAI](https://quelleia.com/logitheque/localai/) : open source (MIT) (LocalAI)
5. [MLX LM](https://quelleia.com/logitheque/mlx-lm/) : open source (MIT) (Apple)
6. [NVIDIA AI Workbench](https://quelleia.com/logitheque/ai-workbench/) : code fermé (NVIDIA, États-Unis)
7. [NVIDIA NIM on WSL2](https://quelleia.com/logitheque/nim-pc/) : code fermé (NVIDIA, États-Unis)
8. [NVIDIA PAIR (Personal AI Router)](https://quelleia.com/logitheque/nvidia-pair/) : open source (Apache-2.0) (NVIDIA, États-Unis)
9. [vLLM](https://quelleia.com/logitheque/vllm/) : open source (Apache-2.0) (vLLM)
10. [xAI SDK](https://quelleia.com/logitheque/xai-sdk/) : open source (Apache-2.0) (xAI, États-Unis)

Rangés par ordre alphabétique, sans note ni classement.
[Tous les logiciels de cet usage](https://quelleia.com/logitheque/usages/developpeurs/)

## Pour aller plus loin

- [Grok 4 7](https://quelleia.com/modeles/grok-4-7/)
- [Xai](https://quelleia.com/editeurs/xai/)
- [Xai sdk](https://quelleia.com/logitheque/xai-sdk/)
- [Grok Build](https://quelleia.com/outils/grok-build/)
- [Grok CLI](https://quelleia.com/outils/grok-cli/)
- [Voix a voix](https://quelleia.com/voix/voix-a-voix/)
- [Jetons, prix au million et vrai coût d'une tâche](https://quelleia.com/guides/jetons-et-prix.md) (guide, amateur)
- [MCP : brancher des outils dans Claude, ChatGPT ou un agent](https://quelleia.com/guides/mcp.md) (guide, amateur)
- [Grok et xAI : l'assistant, les agents, les images et l'API](https://quelleia.com/guides/grok.md) (guide, débutant)
- [Grok Bot : des agents d'xAI qui travaillent sur leur ordinateur](https://quelleia.com/guides/grok-bot.md) (guide, amateur)

## Sources

- https://docs.x.ai/developers/quickstart (lue le 17 novembre 2026)
- https://docs.x.ai/developers/models (lue le 17 novembre 2026)
- https://docs.x.ai/developers/pricing (lue le 17 novembre 2026)
- https://docs.x.ai/developers/release-notes (lue le 17 novembre 2026)
- https://docs.x.ai/developers/tools/overview (lue le 17 novembre 2026)
- https://docs.x.ai/developers/tools/web-search (lue le 17 novembre 2026)
- https://docs.x.ai/developers/advanced-api-usage/regions (lue le 17 novembre 2026)
- https://docs.x.ai/developers/advanced-api-usage/watermarking (lue le 17 novembre 2026)
- https://docs.x.ai/developers/faq/security (lue le 17 novembre 2026)
- https://docs.x.ai/developers/model-capabilities/video/overview (lue le 17 novembre 2026)
- https://x.ai/news/grok-4-7 (lue le 17 novembre 2026)
- https://x.ai/news/grok-voice-3 (lue le 17 novembre 2026)
