API Grok : intégrer Grok dans votre code

Deux façons d'utiliser Grok dans votre code

Les développeurs disposent de deux méthodes principales pour appeler les modèles Grok. La première est l'API xAI, gérée directement par l'entreprise (désormais sous la marque SpaceXSI), avec des clés obtenues sur console.x.ai. La seconde repose sur un routeur de modèles comme OpenRouter, qui regroupe les modèles de nombreux fournisseurs sous une seule clé et une facture unique. Les deux solutions acceptent les requêtes au format OpenAI Chat Completions : les SDK officiels d'OpenAI fonctionnent donc parfaitement dès lors que vous modifiez l'URL de base et le nom du modèle.

Quelle solution choisir ?

• L'API xAI si vous souhaitez bénéficier de toutes les fonctionnalités de Grok en avant-première : la liste complète des modèles, l'API Responses, les outils de recherche web et X côté serveur, la génération d'images et de vidéos avec Grok Imagine, la voix, les traitements par lots (batch) et les réductions sur les invites mises en cache. URL de base : https://api.x.ai/v1.
• OpenRouter si vous souhaitez basculer entre Grok et les modèles d'autres entreprises sans multiplier les abonnements, ou si vous possédez déjà un compte OpenRouter. URL de base : https://openrouter.ai/api/v1, identifiants de modèles préfixés par x-ai/. La configuration est détaillée dans le guide de démarrage rapide d'OpenRouter.

Dans les deux cas, conservez précieusement votre clé sur un serveur ou dans une variable d'environnement. Ne l'intégrez jamais directement au code d'une page web ou d'une application mobile, où elle pourrait être extraite facilement.

Votre première requête vers l'API xAI

Générez une clé dans la console, enregistrez-la dans XAI_API_KEY, puis envoyez un message à Grok 4.7 :

curl

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "reasoning_effort": "low",
    "messages": [
      {"role": "system", "content": "Tu es un assistant concis."},
      {"role": "user", "content": "Donne-moi trois conseils pour préparer un premier marathon."}
    ]
  }'

Python (avec la bibliothèque OpenAI)

import os
from openai import OpenAI

grok = OpenAI(
    api_key=os.environ["XAI_API_KEY"],
    base_url="https://api.x.ai/v1",
)

answer = grok.chat.completions.create(
    model="grok-4.3",
    reasoning_effort="medium",
    messages=[{"role": "user", "content": "Le nombre 391 est-il premier ? Détaille ta vérification."}],
)
print(answer.choices[0].message.content)

Le paramètre reasoning_effort détermine le temps de réflexion du modèle avant de répondre. Grok 4.3 accepte none, low, medium, high et xhigh (défini sur low par défaut) ; Grok 4.7 prend en charge low, medium, high et xhigh (défini sur high par défaut). Pour Grok 4.20, xAI propose des identifiants distincts : grok-4.20-0309-reasoning et grok-4.20-0309-non-reasoning.

La même requête via OpenRouter

Sur OpenRouter, définissez la clé dans OPENROUTER_API_KEY et utilisez les identifiants précédés de x-ai/. OpenRouter gère la réflexion via un objet reasoning dédié. Cet exemple en JavaScript fonctionne sous Node.js 18 ou version ultérieure :

const endpoint = "https://openrouter.ai/api/v1/chat/completions";

const reply = await fetch(endpoint, {
  headers: {
    Authorization: `Bearer ${process.env.OPENROUTER_API_KEY}`,
    "Content-Type": "application/json",
  },
  method: "POST",
  body: JSON.stringify({
    model: "x-ai/grok-4.20",
    reasoning: { enabled: false },
    stream: false,
    messages: [{ role: "user", content: "Réécris ce titre sur un ton plus neutre : NOUVELLE EXPLOSION DES PRIX" }],
  }),
});
const json = await reply.json();
console.log(json.choices[0].message.content);

Pour activer la réflexion d'un modèle, transmettez plutôt reasoning: { effort: "low" } (ou medium, high). Ajoutez exclude: true si vous souhaitez que le modèle raisonne sans inclure ses étapes de pensée dans la réponse. Activez stream: true pour recevoir la réponse en temps réel au fil de sa génération, ce qui améliore considérablement la réactivité dans une interface de chat.

Envoyer une image

Grok 4.20, 4.3 et 4.7 analysent tous les images. Utilisez la structure de message standard d'OpenAI avec une liste de composants. La documentation de xAI prend en charge les formats JPEG et PNG jusqu'à 20 Mio ; une URL publique ou une URL de données en base64 fonctionnent indifféremment.

{
  "model": "grok-4.20-0309-non-reasoning",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/receipt.png"}},
      {"type": "text", "text": "Liste les articles et le montant total figurant sur ce reçu."}
    ]
  }]
}

Identifiants et tarifs des modèles Grok

Voici les modèles textuels actuels proposés par SpaceXAI sur OpenRouter, avec leur fenêtre de contexte et leurs tarifs par million de tokens (tarifs publics OpenRouter, oct. 2026). L'API xAI applique les mêmes tarifs de base pour les requêtes de moins de 200 000 tokens.

Quelques précisions issues de la page des modèles et tarifs de xAI (tarifs publics xAI, oct. 2026) :

• Les longues requêtes coûtent plus cher. Dès qu'une requête atteint 200 000 tokens, l'ensemble de l'appel est facturé au tarif supérieur : 4 $ / 12 $ pour Grok 4.7, 2,50 $ / 5 $ pour Grok 4.3 et 4.20.
• L'entrée mise en cache est plus économique : 0,50 $ par million pour Grok 4.7 et 0,20 $ pour Grok 4.3 et 4.20, pour les préfixes d'invites répétés.
• Les traitements par lots (batch) non urgents bénéficient d'une réduction ; OpenRouter propose également x-ai/grok-4.3:batch à 1 $ / 2 $.
• Le contexte varie selon la plateforme : OpenRouter indique 2 000 000 tokens pour Grok 4.20, contre 1 000 000 sur la documentation officielle de xAI.

Les tokens de réflexion étant comptabilisés comme des tokens de sortie, le coût par réponse d'un modèle de raisonnement peut s'avérer plus élevé que ce que son tarif unitaire laisse supposer.

Conseils pratiques

• Commencez avec Grok 4.20 sans réflexion pour le chat, la reformulation et l'extraction de données. Il est rapide et très économique. Passez à Grok 4.3 ou 4.7 lorsque la précision sur des tâches complexes prévaut sur la vitesse.
• Gardez en tête la date limite des connaissances. D'après xAI, Grok 4.7 intègre les données jusqu'en mai 2026. Pour des événements plus récents, fournissez les informations dans votre invite ou exploitez les outils de recherche web et X côté serveur de xAI (facturés par appel).
• Rédigez un message système clair précisant le rôle, le ton et le format attendus, et demandez une sortie JSON conforme à un schéma si votre code doit analyser la réponse.
• Gérez les limites de débit. Implémentez un mécanisme de nouvelle tentative après une brève pause lorsque vous recevez une erreur 429.
• Respectez les règles. La politique d'utilisation de xAI s'applique aux appels d'API, et le champ safety_identifier vous permet d'étiqueter les requêtes par utilisateur final.

Résolution des erreurs fréquentes

• 401 ou 403 : clé absente, révoquée ou chargée dans le mauvais environnement. Affichez les premiers caractères sur votre serveur pour vous assurer qu'elle est bien détectée.
• Modèle introuvable (Model not found) : contrôlez le préfixe. OpenRouter requiert x-ai/grok-4.7, tandis que xAI attend simplement grok-4.7.
• Réponses vides ou très lentes sur un modèle avec réflexion : cela signifie généralement qu'il a épuisé sa limite de tokens en phase de pensée. Diminuez le niveau d'effort ou augmentez max_tokens.
• Image refusée : convertissez-la en JPEG ou PNG et veillez à respecter la limite de taille.

FAQ

L'API Grok est-elle compatible avec le SDK OpenAI ?

Oui. Configurez le SDK avec l'URL https://api.x.ai/v1 et une clé xAI, ou sur OpenRouter avec une clé OpenRouter, en renseignant l'identifiant du modèle Grok souhaité.

Existe-t-il une API Grok gratuite ?

Aucune offre gratuite permanente n'est proposée. xAI et OpenRouter facturent à la consommation (au token), bien que des tests ponctuels ne coûtent que quelques centimes.

Peut-on générer des images avec l'API Grok ?

Oui, en utilisant les modèles Grok Imagine de xAI via un point de terminaison d'images dédié. Consultez notre page Grok Imagine. Notre interface de chat ne génère pas d'images.

Quel modèle Grok est utilisé sur Grok.Online ?

Notre chat donne accès à Grok 4.20 sans réflexion, Grok 4.3 avec un niveau de réflexion faible, ainsi qu'à Grok 4.7 dans la limite de 10 messages par jour, le tout via OpenRouter.