API xAI et compatibilité OpenAI

Une API familière

L’API xAI utilise le même format que l’API OpenAI. Si vous avez déjà travaillé avec l’API d’OpenAI ou avec des outils compatibles, vous n’avez rien de nouveau à apprendre. Le seul changement : l’URL de base.

https://api.x.ai/v1

Cette compatibilité est un choix stratégique de xAI. Plutôt que d’imposer un nouveau format propriétaire, ils ont adopté le standard de facto de l’industrie. Résultat : tout outil, tout SDK, tout éditeur qui supporte l’API OpenAI peut utiliser grok-code-fast-1 immédiatement.

Configuration minimale

Pour passer d’OpenAI à xAI dans n’importe quel client compatible, vous n’avez que deux paramètres à changer :

1. Base URL : remplacer https://api.openai.com/v1 par https://api.x.ai/v1
2. Clé API : utiliser votre clé API xAI (obtenue sur console.x.ai)

Le reste — format des messages, paramètres de température, structure des réponses — est identique.

Exemple avec le SDK Python OpenAI

from openai import OpenAI

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

response = client.chat.completions.create(
    model="grok-code-fast-1",
    messages=[
        {"role": "system", "content": "Vous êtes un assistant de programmation."},
        {"role": "user", "content": "Écrivez une fonction de tri rapide en Python."}
    ]
)

Vous utilisez le SDK OpenAI standard, sans aucune modification. Seuls base_url et le nom du modèle changent.

Exemple avec curl

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer votre-cle-xai" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-code-fast-1",
    "messages": [
      {"role": "user", "content": "Explique la différence entre let et const en JavaScript"}
    ]
  }'

Obtenir une clé API

1. Rendez-vous sur console.x.ai
2. Connectez-vous avec votre compte xAI (ou créez-en un sur accounts.x.ai)
3. Dans la section API Keys, générez une nouvelle clé
4. Copiez-la immédiatement — elle ne sera plus affichée après

Conservez cette clé en sécurité. Ne la commitez jamais dans un dépôt Git, ne la partagez pas dans un chat d’équipe. Utilisez une variable d’environnement ou un gestionnaire de secrets.

Endpoints disponibles

grok-code-fast-1 supporte les endpoints suivants, tous au format OpenAI :

• /v1/chat/completions : génération de texte et code (le plus utilisé)
• /v1/chat/completions avec stream: true : streaming avec reasoning_content
• /v1/chat/completions avec tools : tool calling natif

Limites de la compatibilité

Quelques différences mineures existent :

• Les modèles disponibles sont ceux de xAI (grok-code-fast-1, Grok 4, etc.), pas ceux d’OpenAI
• Certains paramètres spécifiques à OpenAI (comme logprobs) peuvent ne pas être supportés
• Le reasoning_content est spécifique à l’API xAI et n’existe pas chez OpenAI

Points clés à retenir

• L’API xAI est à https://api.x.ai/v1, compatible format OpenAI
• Il suffit de changer la base URL et la clé API pour migrer
• Le SDK Python OpenAI fonctionne directement
• La clé API s’obtient sur console.x.ai
• Tous les éditeurs compatibles OpenAI fonctionnent avec xAI