Guide de l'API Grok : clé, URL de base et intégration (2026)

Grok est la famille de modèles développée par xAI. Son API reprend un format compatible avec OpenAI, ce qui signifie qu'une équipe peut généralement réutiliser le SDK OpenAI déjà présent dans son projet. Depuis la Chine, les questions qui reviennent le plus souvent ne portent pas sur le code lui-même, mais sur l'accès réseau, le moyen de paiement et la gestion des quotas par modèle.

Cet article décrit comment obtenir une clé API Grok, comment effectuer un appel et comment passer par une passerelle lorsque l'accès direct n'est pas pratique.

Remarque : Grok et xAI sont des marques de leurs détenteurs respectifs. Les exemples ci-dessous correspondent aux versions courantes d'octobre 2026 ; les interfaces et les tarifs applicables sont ceux publiés par l'éditeur ou affichés sur le site.

1. Ce que permet l'API Grok

Questions-réponses générales, rédaction et synthèse.
Génération, explication et revue de code.
Appels d'outils et scénarios d'agents.
Analyse de documents à contexte long.
Comparaison de plusieurs modèles sur un même jeu de tests.

Les noms de modèles réellement disponibles et la longueur de contexte sont indiqués sur la page Tarifs des modèles. Cette page fait référence, car les catalogues évoluent rapidement.

2. Obtenir une clé : deux voies

Voie directe xAI

Créez une clé API dans la console xAI, puis associez un moyen de paiement. Cette voie convient aux équipes qui bénéficient d'un accès réseau stable et disposent d'un moyen de paiement international. Elle donne accès aux paramètres et aux fonctionnalités publiés par l'éditeur au moment de la mise en service.

Passerelle ZSQH AI Gateway

Ouvrez ZSQH AI Gateway et créez un compte.
Créez une clé API et fixez un quota adapté au projet.
Rechargez le solde.
Appelez l'API avec le SDK OpenAI ou avec curl.

Cette voie convient aux équipes dont l'accès depuis la Chine est instable, qui ont besoin d'une facturation unifiée ou qui veulent basculer entre plusieurs modèles sans multiplier les comptes.

3. URL de base

L'URL de base de la plateforme xAI est généralement :

https://api.x.ai/v1

L'entrée compatible OpenAI de ZSQH AI Gateway est :

https://ai.zhongshangqihang.com/v1

Ne mélangez pas les deux adresses. Une clé et une URL de base doivent toujours être associées : une clé de la passerelle envoyée à l'adresse xAI, ou l'inverse, produit le plus souvent une erreur 401. De même, l'URL de base s'arrête à /v1 ; n'y ajoutez pas vous-même /chat/completions, car le SDK ou le chemin de la requête s'en charge.

4. Test en curl

export GROK_API_KEY="sk-votre-cle"

curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
  -H "Authorization: Bearer $GROK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4",
    "messages": [{"role": "user", "content": "Répondez seulement OK"}]
  }'

Le nom du modèle à utiliser figure sur la page Tarifs des modèles. Copiez-le tel quel plutôt que de le reconstituer de mémoire.

5. Appel en Python

from openai import OpenAI

client = OpenAI(
    api_key="sk-votre-cle",
    base_url="https://ai.zhongshangqihang.com/v1",
)

resp = client.chat.completions.create(
    model="grok-4",
    messages=[{"role": "user", "content": "Expliquez une passerelle API en trois phrases"}],
)
print(resp.choices[0].message.content)

Conservez la clé dans une variable d'environnement ou un gestionnaire de secrets. Ne l'écrivez jamais dans du code front-end, un dépôt Git ou une conversation.

6. Erreurs courantes

Erreur	Cause	Traitement
401	Clé et adresse non associées	Vérifiez la clé et l'URL de base
404	Chemin incorrect	Indiquez uniquement `/v1` comme URL de base
model not found	Nom de modèle incorrect	Copiez-le depuis la page de tarifs
429	Limitation de débit	Réduisez la concurrence et réessayez
insufficient quota	Solde insuffisant	Rechargez le compte

7. Coût et choix du modèle

Le prix unitaire, la longueur de contexte et la prise en charge des appels d'outils influencent directement le coût final. Pour estimer une enveloppe :

Mesurez le volume quotidien de tokens en entrée et en sortie.
Consultez le prix unitaire actuel du modèle envisagé.
Ajoutez le coût des nouvelles tentatives et du contexte long.
Comparez avec les autres modèles et répartissez les tâches selon leur complexité.

Ne vous limitez pas au prix unitaire. Dans la pratique, le contexte long et les tokens de sortie constituent souvent la part principale de la facture, surtout pour les tâches de rédaction ou d'analyse de documents.

Questions fréquentes

L'API Grok est-elle compatible avec OpenAI ?

Elle est généralement compatible avec le format Chat Completions, ce qui permet d'utiliser le SDK OpenAI. Le niveau exact de prise en charge des paramètres dépend de l'éditeur et de la passerelle ; consultez leur documentation avant de vous engager sur un comportement précis.

Comment appeler l'API de manière stable depuis la Chine ?

Vous pouvez utiliser la voie directe si votre réseau le permet, ou une passerelle accessible depuis la Chine. Dans les deux cas, prévoyez des délais d'attente et des nouvelles tentatives, et surveillez le taux d'échec par modèle.

Une seule clé peut-elle appeler plusieurs modèles ?

Sur une passerelle, oui : le modèle est indiqué dans les paramètres de la requête. Avec une clé de la plateforme xAI, le périmètre dépend des droits associés au compte et des modèles ouverts.

Pour aller plus loin

Si vous avez besoin d'un accès depuis la Chine ou d'une entrée unifiée pour plusieurs modèles, vous pouvez créer un compte ZSQH AI Gateway et tester avec une clé à faible quota. Les modèles et les tarifs applicables figurent sur la page Tarifs des modèles.