Endpoints supportés dans les batchs

Cours révisé le 2 novembre 2026 d’après la documentation de xAI : la remise batch est de 20 % sur les modèles texte éligibles (et non 50 %), les exemples suivent l’API REST et le SDK officiel xai-sdk (client.batch.* ; l’API Batch de xAI n’a pas le format de celle d’OpenAI, le SDK OpenAI ne s’y applique pas), et l’API Responses passe avant Chat Completions, endpoint hérité chez xAI. Sources : Batch API · Référence REST · Tarifs batch.

Sept endpoints, un seul workflow

La Batch API n’est pas limitée à la génération de texte. Elle accepte sept endpoints, couvrant le texte, les images et les vidéos, que vous pouvez mêler dans un même batch pour bâtir des pipelines multimodaux complets en une seule opération.

Endpoints texte

/v1/responses — L’API Responses, celle que xAI recommande. Elle donne accès aux outils serveur (recherche web, recherche X, exécution de code, MCP), au function calling et aux sorties structurées, et c’est elle qui reçoit les nouvelles fonctions en premier.

/v1/chat/completions — L’endpoint de complétion historique, au format OpenAI. xAI le maintient comme endpoint hérité : il reste utile pour du code existant écrit pour lui, mais un nouveau pipeline a intérêt à partir sur Responses.

Sur les modèles éligibles, la remise batch de 20 % s’applique aux deux endpoints, sur tous les types de tokens.

Endpoints images

/v1/images/generations — Génération d’images à partir d’un prompt. Les paramètres utiles sont aspect_ratio (par exemple "16:9"), resolution ("1k", "1.5k" ou "2k"), n pour le nombre d’images et response_format ("url" ou "b64_json").

/v1/images/edits — Édition d’une image existante, désignée par un objet image qui contient une url (adresse publique ou données encodées en base64) ou le file_id d’un fichier téléversé. Utile pour des transformations en série sur un catalogue visuel.

Les images sont facturées au tarif standard, sans remise batch : l’intérêt du lot est ici opérationnel, pas tarifaire.

Endpoints vidéos

/v1/videos/generations (ou /v1/videos) — Génération de vidéos à partir d’un prompt, de 1 à 15 secondes (duration, 8 par défaut), en 480p, 720p ou 1080p.

/v1/videos/edits — Édition d’une vidéo existante, passée dans un objet video (URL d’un fichier .mp4 ou file_id).

/v1/videos/extensions — Prolongation d’une vidéo par un nouveau segment de 2 à 10 secondes.

Comme pour les images, les tarifs vidéo restent standard en mode batch. Les résultats image et vidéo sont fournis sous forme d’URL signées qui expirent au bout d’une heure.

Mixer les endpoints dans un batch

Dans un fichier JSONL, chaque ligne désigne son endpoint dans le champ url :

{"custom_id": "text-1", "method": "POST", "url": "/v1/responses", "body": {"model": "grok-4.3", "input": [{"role": "user", "content": "Résume cet article : ..."}]}}
{"custom_id": "img-1", "method": "POST", "url": "/v1/images/generations", "body": {"model": "grok-imagine-image-2.0", "prompt": "Logo minimaliste pour une librairie de quartier"}}

Vous pourriez ainsi générer, dans le même batch, les descriptions de vos produits et leurs visuels.

Choisir le bon endpoint

• Responses : le choix par défaut, indispensable dès qu’il faut des outils serveur, des sorties structurées ou les fonctions les plus récentes
• Chat Completions : la continuité pour un code déjà écrit au format Chat Completions, sans plus
• Images et vidéos : pour produire des visuels en série, en gardant en tête qu’ils ne bénéficient d’aucune remise

Points clés à retenir

• Sept endpoints sont acceptés : deux pour le texte, deux pour les images, trois pour la vidéo
• Responses est l’endpoint recommandé ; Chat Completions est un endpoint hérité chez xAI
• Seuls les tokens des modèles texte éligibles bénéficient de la remise de 20 %
• Le champ url de chaque ligne JSONL détermine l’endpoint visé, et les endpoints peuvent se mêler dans un batch
• Les résultats image et vidéo sont des URL signées valables une heure