Utiliser l’API Grok 4.7 : le guide pas à pas avec curl, Python et JavaScript

Créez une clé API xAI et envoyez votre première requête à Grok 4.7, puis ajoutez le niveau de raisonnement, les questions de suivi, la recherche web, le suivi des coûts et les consignes de contenu.

Graphic of a terminal window sending a request to a cloud and getting a reply, for a guide to the Grok 4.7 API

Grok 4.7 est le modèle le plus récent et le plus performant de l’API xAI, et vous pouvez l’appeler depuis un terminal ou un petit script en quelques minutes. Ce guide vous accompagne pas à pas : créer une clé, envoyer une première requête avec curl, Python et JavaScript, puis utiliser les fonctions dont vous aurez besoin ensuite : niveau de raisonnement, questions de suivi, recherche web en direct, suivi des coûts et nouvelles consignes de contenu. Les commandes suivent la documentation officielle sur docs.x.ai, vérifiée le 15 novembre 2026.

À retenir

  • Grok 4.7 est le modèle le plus performant de l’API xAI, avec une fenêtre de contexte de 500 000 tokens.
  • Créez une clé sur console.x.ai, enregistrez-la sous XAI_API_KEY et appelez la Responses API avec curl ou le SDK OpenAI.
  • Réglez le niveau de raisonnement de low à xhigh, poursuivez une conversation avec previous_response_id et ajoutez l’outil web_search pour des réponses à jour.
  • Chaque réponse indique son prix exact dans cost_in_usd_ticks, et des consignes facultatives refusent les contenus nsfw, violence ou profanity.

Une remarque sur le nom : la documentation appelle désormais l’entreprise SpaceXSI, mais le service s’appelle toujours « the xAI API », l’adresse reste api.x.ai et la variable de la clé reste XAI_API_KEY.

Ce qu’il vous faut

  • Un compte sur console.x.ai avec des crédits. Le guide de démarrage rapide demande de charger des crédits avant d’utiliser l’API.
  • Un terminal avec curl. Cela suffit pour tout le guide.
  • Facultatif : Python avec pip, ou Node.js avec npm, si vous voulez appeler l’API depuis du code.

Grok 4.7 en un coup d’œil

Ces chiffres proviennent de la page Grok 4.7 et de la page des tarifs au 15 novembre 2026. Les prix évoluent : vérifiez-les avant d’établir un budget.

CaractéristiqueValeur
Nom du modèlegrok-4.7
Fenêtre de contexte500 000 tokens
Date limite des connaissancesMai 2026
EntréeTexte et images
SortieTexte
Prix, prompts de moins de 200k tokens2,00 $ en entrée, 0,50 $ en entrée mise en cache, 6,00 $ en sortie par million de tokens
Prix, prompts de 200k tokens ou plus4,00 $ en entrée, 1,00 $ en entrée mise en cache, 12,00 $ en sortie par million de tokens
Niveau de raisonnementlow, medium, high (par défaut) ou xhigh

En chiffres

500 000 tokensfenêtre de contexte

2,00 $en entrée par million de tokens, sous 200k

6,00 $en sortie par million de tokens, sous 200k

Étape 1 : créer une clé API

  1. Connectez-vous sur console.x.ai et ajoutez des crédits.
  2. Ouvrez la page API Keys et créez une clé.
  3. Stockez-la dans une variable d’environnement pour qu’elle ne figure jamais dans votre code :
Terminal
export XAI_API_KEY="your_api_key"

Sous Windows PowerShell, utilisez plutôt $env:XAI_API_KEY="your_api_key". Traitez la clé comme un mot de passe. Ne la collez pas dans des documents partagés et ne la commitez pas dans un dépôt.

Étape 2 : envoyer votre première requête avec curl

La documentation recommande la Responses API, à l’adresse https://api.x.ai/v1/responses. Voici l’exemple du guide de démarrage rapide :

Terminal
curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "input": "Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}"
  }'

Résultat attendu : un objet JSON. La réponse se trouve dans la liste output, dans un élément de type message dont le contenu est de type output_text. Le même objet contient un id (vous l’utiliserez à l’étape 5) et un bloc usage avec le nombre de tokens.

Diagramme du parcours, du chargement des crédits xAI et de la création d'une clé API jusqu'à la lecture de la première réponse de Grok 4.7

Étape 3 : l’appeler depuis Python ou JavaScript

L’API fonctionne avec les SDK OpenAI si vous les faites pointer vers l’URL de base de xAI. Installez-en un :

Terminal
pip install openai
Terminal
npm install openai

Python :

Code
import os
from openai import OpenAI

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

response = client.responses.create(
    model="grok-4.7",
    input="Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}",
)

print(response.output_text)

JavaScript (enregistrez-le dans un fichier .mjs pour que import et await au niveau supérieur fonctionnent dans Node.js) :

Code
import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.XAI_API_KEY,
  baseURL: 'https://api.x.ai/v1',
});

const response = await client.responses.create({
  model: 'grok-4.7',
  input: 'Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}',
});

console.log(response.output_text);

Les deux n’affichent que le texte du modèle. xAI propose aussi son propre paquet Python (pip install xai-sdk), et la documentation indique qu’on peut mélanger les deux sans problème.

Étape 4 : choisir à quel point le modèle réfléchit

Grok 4.7 raisonne toujours avant de répondre. Impossible de le désactiver, mais le guide du raisonnement vous permet de régler l’effort. La valeur par défaut est high. Utilisez low pour les appels simples et rapides, et xhigh pour les problèmes les plus difficiles, quand une réponse plus lente est acceptable.

Terminal
curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -m 3600 \
  -d '{
    "model": "grok-4.7",
    "reasoning": {"effort": "low"},
    "input": "Summarise the difference between TCP and UDP in three bullet points."
  }'

L’option -m 3600 laisse la requête tourner jusqu’à une heure avant que curl abandonne. La documentation l’utilise dans ses exemples de raisonnement, car un raisonnement poussé peut prendre du temps. En Python, le même réglage s’écrit reasoning={"effort": "low"}.

Échelle des niveaux de raisonnement de Grok 4.7, de low à xhigh, avec high indiqué comme valeur par défaut

Étape 5 : poser une question de suivi sans renvoyer la conversation

Par défaut, la Responses API conserve chaque échange sur les serveurs de xAI pendant 30 jours, selon le guide de génération de texte. Vous pouvez donc poursuivre une conversation en transmettant l’id de la réponse précédente :

Terminal
curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -m 3600 \
  -d '{
    "model": "grok-4.7",
    "previous_response_id": "The previous response ID",
    "input": [
        {
            "role": "user",
            "content": "How do stars form?"
        }
    ]
}'

Remplacez l’espace réservé par l’id de votre réponse précédente. Si vous préférez que les requêtes ne soient pas conservées, ajoutez "store": false à la requête et gérez vous-même l’historique.

Le saviez-vous ?

Par défaut, la Responses API conserve chaque échange sur les serveurs de xAI pendant 30 jours. Ajoutez « store »: false à une requête si vous préférez gérer vous-même l’historique de la conversation.

Étape 6 : laisser Grok chercher sur le web

La page des modèles est sans détour : sans outils de recherche, Grok ne sait rien au-delà de ses données d’entraînement. Pour obtenir des réponses à jour, ajoutez l’outil de recherche web :

Terminal
curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
  "model": "grok-4.7",
  "input": [
    {
      "role": "user",
      "content": "What were the main technology headlines this week?"
    }
  ],
  "tools": [
    {
      "type": "web_search"
    }
  ]
}'

Grok décide lui-même du nombre de recherches. Au 15 novembre 2026, la recherche web coûte 5 $ pour 1 000 appels en plus des frais de tokens habituels, donc un prompt qui demande beaucoup de recherches coûte plus cher qu’un prompt simple.

Étape 7 : voir combien a coûté chaque requête

Chaque réponse indique son prix exact dans un champ appelé cost_in_usd_ticks, décrit dans le guide du suivi des coûts. Un dollar américain vaut 10 000 000 000 ticks. Si jq est installé, cette commande affiche le chiffre pour un seul appel :

Terminal
curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "input": "Say hello"
  }' | jq '.usage.cost_in_usd_ticks'

Divisez le résultat par 10 000 000 000 pour obtenir des dollars. L’exemple de la documentation : 37756000 ticks font environ 0,0038 $.

Le saviez-vous ?

xAI facture les requêtes en ticks : un dollar américain vaut 10 000 000 000 ticks. L’exemple de la documentation, 37756000 ticks, revient à environ 0,0038 $.

Étape 8 (facultative) : ajouter des consignes de contenu

En octobre 2026, xAI a ajouté des contrôles de modération personnalisés. Vous joignez une liste guidelines à une requête, et Grok refuse ce type de contenu pendant qu’il écrit. Il existe trois catégories, nsfw, violence et profanity, et le seul comportement disponible aujourd’hui est decline.

Terminal
curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "input": "Write a short story about a knight.",
    "guidelines": [
      { "type": "policy", "category": "violence", "behavior": "decline" },
      { "type": "policy", "category": "nsfw", "behavior": "decline" }
    ]
  }'

Les consignes ne s’appliquent qu’à la requête qui les contient : envoyez-les donc à chaque fois. Avec le SDK OpenAI pour Python, passez la liste dans extra_body, car ce SDK n’a pas de paramètre guidelines propre.

Erreurs courantes et solutions

Les codes d’état ci-dessous proviennent de la page de débogage de xAI et des guides cités plus haut.

Ce que vous voyezCause probableSolution
401 UnauthorizedPas d’en-tête d’autorisation, ou une clé invalideEnvoyez Authorization: Bearer <your key> et vérifiez que la variable est définie avec echo $XAI_API_KEY
400 Bad RequestUn argument invalide dans le corps ou l’URL, ou une clé API incorrecteVérifiez le JSON, l’adresse du endpoint et la clé
403 ForbiddenVotre clé ou votre équipe n’a pas l’autorisation, ou est bloquéeDemandez l’autorisation à l’administrateur de votre équipe
404 Not FoundLe modèle demandé est introuvable, ou l’URL est mal orthographiéeVérifiez l’orthographe grok-4.7 et l’adresse du endpoint
415 Unsupported Media TypeCorps vide, ou en-tête Content-Type: application/json manquantAjoutez l’en-tête et un corps valide
422 Unprocessable EntityUn champ a un format invalide, par exemple une catégorie guidelines inconnueComparez le champ avec la documentation. Pour les consignes, l’erreur liste les valeurs valides
429 Too Many RequestsVous avez atteint une limite de débitRalentissez et réessayez avec un délai croissant. Les limites augmentent automatiquement avec les dépenses totales de votre équipe
Erreur quand vous définissez stop, une pénalité de présence ou une pénalité de fréquenceLes modèles de raisonnement ne les acceptent pasSupprimez-les
La requête expireLe raisonnement a pris plus de temps que votre client ne l’autoriseAugmentez le délai d’expiration de votre client (les exemples de la documentation utilisent 3 600 secondes) ou baissez le niveau de raisonnement

Si tout échoue en même temps, consultez status.x.ai avant de déboguer votre propre code.

En résumé

Vous avez maintenant une clé fonctionnelle, une première requête et cinq réglages dont la plupart des projets ont besoin : niveau de raisonnement, conversations conservées, recherche web, coût par requête et consignes de contenu. La documentation couvre aussi le streaming, les sorties structurées, l’envoi de fichiers et l’appel de fonctions.

Si vous comparez les fournisseurs, notre guide de l’API Gemini 4 Hydrogen suit les mêmes étapes pour le modèle de Google. Si vous préférez tout garder sur votre propre machine, découvrez comment exécuter un modèle en local avec Ollama. Et si vous voulez Grok dans vos appels plutôt que dans votre code, voici comment ajouter Grok à Zoom, Google Meet ou Teams.

Questions fréquentes

Combien coûte l’API Grok 4.7 ?

Pour les prompts de moins de 200k tokens : 2,00 $ en entrée, 0,50 $ en entrée mise en cache et 6,00 $ en sortie par million de tokens. Les prompts de 200k tokens ou plus coûtent le double. La recherche web ajoute 5 $ pour 1 000 appels. Prix au 15 novembre 2026.

Puis-je utiliser le SDK OpenAI avec l’API Grok ?

Oui. Faites pointer le SDK OpenAI pour Python ou JavaScript vers l’URL de base https://api.x.ai/v1 avec votre XAI_API_KEY et appelez responses.create avec le modèle grok-4.7. xAI propose aussi son propre paquet xai-sdk, et la documentation indique qu’on peut les combiner.

Pourquoi ma requête à l’API Grok expire-t-elle ?

Grok 4.7 raisonne toujours avant de répondre, et un raisonnement poussé peut prendre du temps. Augmentez le délai d’expiration de votre client (les exemples de la documentation utilisent 3 600 secondes) ou baissez le niveau de raisonnement.

Peut-on désactiver le raisonnement de Grok 4.7 ?

Non. Grok 4.7 raisonne toujours avant de répondre. Vous pouvez seulement régler l’effort sur low, medium, high ou xhigh, high étant la valeur par défaut.

Petit quiz

Quel est le niveau de raisonnement par défaut de Grok 4.7 ?

  • low (faible)
  • medium (moyen)
  • high (élevé)

Le guide du raisonnement fixe high comme valeur par défaut.

Combien de ticks font un dollar américain ?

  • 10,000,000,000
  • 1,000,000
  • 37,756,000

D’après le guide du suivi des coûts, un dollar américain vaut 10 000 000 000 ticks.

Que signifie le plus souvent une erreur 401 Unauthorized ?

  • Vous avez atteint une limite de débit
  • Un en-tête manquant ou une clé invalide
  • Le nom du modèle est mal orthographié

La page de débogage de xAI indique comme cause l’absence d’en-tête d’autorisation ou une clé invalide.

Sources

Liens vérifiés pour la dernière fois le 15 novembre 2026.

Écrit par Mindloop Editorial

The Mindloop Experience editorial team writes clear, carefully sourced explainers and how-tos on tech, science, money and culture, for anyone who likes to know how things actually work.

À propos de Mindloop Experience

Réponses

Écrire une réponse

Plus d’articles de Mindloop Experience

Tout voir de Mindloop Experience

Vous pouvez applaudir jusqu’à 50 fois.