Grok 4.6 API

Un endpoint de chat compatible OpenAI pour Grok 4.6 de xAI, où une capture d’écran et la question qui l’accompagne arrivent dans le même tour.

Grok 4.6 vient de xAI et répond sur POST https://api.spicyapi.ai/v1/chat/completions sous le nom de modèle xai/grok-4.6. La requête a la forme familière : un tableau messages de 256 tours ordonnés au maximum, un plafond de sortie, deux réglages d’échantillonnage, une liste d’outils, un format de réponse et reasoning_effort pour dire jusqu’où le modèle travaille avant d’écrire. La fenêtre porte 500 000 tokens et une seule réponse peut en prendre 450 000, si bien que la plus grande part du budget se place du côté de la réponse plutôt que du côté du prompt. Le contenu accepte des blocs text et image_url ; il n’existe pas de bloc fichier ou PDF sur ce point de terminaison, et la modalité est texte et images en entrée, texte en sortie.

Une image et la phrase qui va avec, dans le même tour

Le contenu peut être une simple chaîne ou un tableau de blocs, et un bloc image porte une url ainsi qu’un indice detail valant auto, low ou high. La capture et la question arrivent ensemble, donc le modèle lit les pixels et non votre description : c’est toute la différence quand la réponse tient à un axe mal étiqueté, à une trace d’appels coupée au bord ou à une mise en page qui ne casse qu’à une largeur. Le contenu des images est compté à l’intérieur de la fenêtre de 500 000 tokens et non à côté, donc plusieurs grandes captures et un long historique se disputent le même budget.

Presque tout le budget peut partir dans la réponse

Une seule réponse atteint 450 000 tokens, une forme inhabituelle pour un modèle de chat : l’essentiel de la fenêtre peut servir à écrire plutôt qu’à lire. max_tokens reste à 4 096 par défaut, une longue génération se demande donc et ne s’obtient pas par accident, et une coupure à la valeur par défaut arrive sans avertissement. reasoning_effort prend low, medium, high ou xhigh et vaut high par défaut ; l’effort se paie en tokens de sortie et pèse donc à la fois sur votre plafond et sur votre facture.

Rien de notre côté ne se trouve sur le chemin

Nous ne plaçons aucun classificateur de contenu à nous entre vous et ce modèle. Ce qu’il refuse d’écrire relève de son propre comportement et non d’une couche ajoutée ici, et ce que vous envoyez n’est ni analysé, ni noté, ni réécrit au passage. Les droits sur le matériel que vous envoyez vous appartiennent, et vous répondez de l’usage fait de la réponse.

Faire examiner une capture plutôt que la décrire

Envoyez la capture en detail high à côté de la question dans un seul message utilisateur et le modèle travaille sur les pixels : l’étiquette d’axe fausse, la ligne disparue, l’image coupée au bord. Deux captures prises à une heure d’intervalle dans le même tour vous laissent demander quel chiffre a bougé, au lieu d’interroger un résumé tapé à la main.

Écrire l’équivalent d’un livre en un seul appel

Poussez max_tokens vers 450 000 et le guide de migration, le long rapport ou tout un jeu de tests revient en une réponse plutôt qu’en une chaîne de reprises dont chacune perd un peu du fil. Avec stream: true, le texte arrive pendant qu’il s’écrit.

Garder une boucle d’outils lisible

Déclarez jusqu’à 128 définitions de fonctions, associez-les à tool_choice et renvoyez chaque résultat au tour suivant dans un message de rôle tool. Fixez reasoning_effort pour toute la boucle et la seule chose qui varie d’une itération à l’autre est la conversation, ce qui rend la trace lisible le jour où la boucle déraille.

Remettre la réponse au code, pas à une personne

Demandez un objet JSON via response_format et ramenez temperature à 0 : la réponse revient sous une forme que votre parseur prend telle quelle. Associez cela à un bloc image et vous obtenez une extraction directe depuis un reçu, un graphique ou la capture d’un formulaire, sans étape de recopie intermédiaire.

curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "model": "xai/grok-4.6/chat",
  "messages": [
    {
      "role": "user",
      "content": "Summarise the following release notes into three bullet points."
    }
  ],
  "stream": true
}' \
  | jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'

La référence API détaille l’authentification, le schéma complet, le polling et la gestion des erreurs.