API Grok : clés, endpoints, modèles et première requête

Ce qu’est l’API Grok

L’API Grok est l’interface payante pour développeurs de SpaceXSI (anciennement xAI). Elle donne à votre propre code accès à la même famille de modèles Grok que celle des applications Grok, ainsi qu’à des modèles d’image, de vidéo et de voix. Vous payez au token, à l’image, à la seconde de vidéo ou à la minute d’audio.

L’API est distincte des formules grand public. La page des tarifs de The X Subscription mentionne un « accès à l’API Grok » dans Plus, mais précise aussi que l’utilisation de l’API est facturée séparément. SpaceXSI n’explique pas comment les deux s’articulent : prévoyez donc de payer les appels API avec des crédits de la console.

Les principaux cas d’usage sont les classiques : chat et raisonnement dans vos propres applications, agents qui appellent des outils, compréhension de documents et d’images, et génération de médias. Pour une définition simple, voir l’entrée API de notre glossaire.

Comment obtenir une clé API Grok

Le démarrage rapide de SpaceXSI décrit quatre étapes :

1. Créez un compte sur console.x.ai.
2. Chargez des crédits prépayés. La documentation précise que des crédits sont nécessaires pour que les appels fonctionnent.
3. Ouvrez la page API Keys et générez une clé.
4. Enregistrez la clé dans une variable d’environnement nommée XAI_API_KEY, pas dans votre code source.

La facturation est prépayée par défaut. Quand les crédits sont épuisés, les requêtes sont refusées. Vous pouvez activer la recharge automatique, avec un minimum de $5. La facturation sur facture est désactivée par défaut et doit être demandée au service commercial de SpaceXSI.

URL de base, SDK et endpoints

Toutes les requêtes passent par l’URL de base https://api.x.ai/v1. La documentation indique trois façons de l’appeler :

• xai_sdk, le SDK Python officiel.
• Le SDK OpenAI (Python et JavaScript), pointé vers l’URL de base de xAI.
• Le Vercel AI SDK, via le paquet @ai-sdk/xai.

Responses API ou Chat Completions

La Responses API sur /v1/responses est l’interface principale de SpaceXSI. Chat Completions sur /v1/chat/completions reste pris en charge. Avec Grok 4.7, les appels à la Responses API renvoient toujours un raisonnement chiffré. L’ancien endpoint /v1/completions est remplacé par /v1/chat/completions.

Les endpoints de style Anthropic sont obsolètes

Les endpoints compatibles Anthropic /v1/messages et /v1/complete sont marqués comme obsolètes. SpaceXSI oriente les utilisateurs vers la Responses API ou gRPC. Aucune date de fin n’est donnée, mais les nouveaux projets ne devraient pas s’appuyer dessus.

Endpoint régional américain

Un endpoint américain, https://us.api.x.ai/v1, maintient l’inférence aux États-Unis. Il coûte 1,1x les tarifs mondiaux et ne sert que grok-4.7 et grok-4.6. Les détails sont sur notre page des tarifs de l’API Grok.

Une première requête minimale

Cet exemple appelle la Responses API avec curl. Il suppose que votre clé est enregistrée dans XAI_API_KEY :

curl https://api.x.ai/v1/responses -H "Authorization: Bearer $XAI_API_KEY" -H "Content-Type: application/json" -d '{"model": "grok-4.7", "input": "Explain a context window in one sentence."}'

Deux réglages à connaître dès le premier jour :

• reasoning_effort : Grok 4.7 accepte low, medium, high (par défaut) ou xhigh.
• prompt_cache_key (ou l’en-tête x-grok-conv-id) : SpaceXSI recommande vivement d’en définir un. Sans lui, une requête peut tomber sur un serveur au cache froid et payer le prix d’entrée complet.

Les noms de champs peuvent changer. Consultez la référence des requêtes dans la documentation officielle avant de passer en production.

Les modèles de l’API Grok

Voici les modèles texte actuels, avec les prix en USD par million de tokens. Les prompts de plus de 200k tokens coûtent le double.

Grok 4.7 Fast n’est pas disponible sur l’API publique. Il n’est proposé que dans Cursor et Grok Build. Plusieurs anciens modèles, dont grok-3, grok-4-0709, Grok 4 Fast et grok-code-fast-1, ont été retirés le 15 mai 2026. Les appels à grok-code-fast-1 sont désormais redirigés vers grok-build-0.1.

L’API sert aussi les modèles d’image et de vidéo Grok Imagine et les modèles Grok Voice. Voir Grok Imagine et le guide de l’API Grok Voice.

Outils intégrés

Les modèles Grok peuvent appeler des outils côté serveur que SpaceXSI fait tourner pour vous. La page des tarifs cite :

• Web Search et Image Search.
• X Search, qui renvoie des posts et des profils de X.
• Code Execution.
• File attachment search et Collections Search pour la recherche dans vos propres documents.
• Les outils view_image, view_x_video et Remote MCP, facturés uniquement aux tokens.

La plupart des outils sont facturés par tranche de 1 000 appels, en plus du coût des tokens. Chaque modèle a aussi des plafonds de requêtes et de tokens par niveau, détaillés sur notre page des limites de débit de l’API Grok.

Questions fréquentes