URL de base de l'API

Le point d’entrée de l’API Grok

Toutes les requêtes vers l’API xAI passent par une URL de base unique. Comprendre cette URL et les endpoints disponibles est essentiel avant d’écrire votre première ligne de code.

L’URL de base

L’API Grok est accessible à l’adresse suivante :

https://api.x.ai/v1

Cette URL sert de racine pour tous les endpoints. Par exemple, pour créer une réponse, l’URL complète sera https://api.x.ai/v1/responses.

Pourquoi /v1 ?

Le préfixe /v1 indique la version de l’API. Ce versionnement permet à xAI de faire évoluer l’API sans casser les applications existantes. Si une version 2 voit le jour, elle coexistera avec la v1 pendant une période de transition.

Compatibilité avec l’écosystème OpenAI

Un aspect fondamental de l’API xAI est sa compatibilité avec le format OpenAI. Concrètement, cela signifie que si vous avez déjà du code qui fonctionne avec l’API OpenAI, il vous suffit de changer deux paramètres pour utiliser Grok :

• L’URL de base : remplacez https://api.openai.com/v1 par https://api.x.ai/v1
• La clé API : remplacez votre clé OpenAI par votre clé xAI

Cette compatibilité s’étend à la plupart des outils et bibliothèques de l’écosystème OpenAI : LangChain, LlamaIndex, LiteLLM et bien d’autres fonctionnent avec Grok sans modification de code.

Les endpoints principaux

L’API expose plusieurs endpoints regroupés par fonctionnalité :

Génération de texte

• POST /v1/responses : endpoint principal pour générer des réponses (format moderne)
• POST /v1/chat/completions : endpoint compatible OpenAI (format legacy mais toujours supporté)

Génération de médias

• POST /v1/images/generations : générer des images
• POST /v1/images/edits : éditer des images existantes
• POST /v1/videos/generations : générer des vidéos
• POST /v1/tts : synthèse vocale (text-to-speech)

Gestion de fichiers

• POST /v1/files : uploader un fichier
• GET /v1/files : lister les fichiers uploadés

Temps réel

• wss://api.x.ai/v1/realtime : agent vocal via WebSocket

Configurer l’URL dans vos SDKs

Lorsque vous utilisez un SDK compatible OpenAI, vous devez spécifier l’URL de base explicitement :

from openai import OpenAI

client = OpenAI(
    api_key="xai-votre-cle",
    base_url="https://api.x.ai/v1"
)

Avec le SDK natif xAI, l’URL est préconfigurée et vous n’avez rien à spécifier.

Limitations et quotas

L’API applique des limites de débit (rate limits) par clé API. Si vous dépassez ces limites, vous recevrez une erreur HTTP 429. La console xAI affiche vos quotas actuels et votre consommation en temps réel.

Points clés à retenir

• L’URL de base est https://api.x.ai/v1 pour tous les endpoints
• L’API est compatible avec le format OpenAI : changez l’URL et la clé, c’est tout
• L’endpoint principal de génération est POST /v1/responses
• L’endpoint legacy POST /v1/chat/completions reste disponible pour la compatibilité