Skip to Content

Famille Grok

Les modèles Grok de xAI, qui comprennent les modèles de reasoning Grok 4.7, 4.6, 4.5 et 4.3, ainsi que les modèles sans reasoning Grok 4.1 Fast et 4.20. Ils s’appellent via l’API compatible OpenAI.

Que souhaitez-vous faire ?

Modèles

La liste complète des modèles et les prix en vigueur figurent sur la page des modèles . Les ID de modèle portent le préfixe x-ai/, qui peut être omis.

ID de modèle courants (à copier tels quels)
Grok 4.7x-ai/grok-4.7Modèle de reasoning, contexte de 500K
Grok 4.1 Fastx-ai/grok-4.1-fastSans reasoning, contexte de 2M, images acceptées
TypeModèlesDescription
Modèles de reasoningGrok 4.7, 4.6, 4.5Reasoning systématique, latence élevée ; contexte de 500K, texte uniquement
Modèle de reasoningGrok 4.3Contexte de 1M, entrée d’images prise en charge
Modèles sans reasoningGrok 4.1 Fast, 4.20Réponse rapide ; contexte de 2M, entrée d’images prise en charge

Endpoints pris en charge

EndpointModèles pris en charge
Chat Completions /v1/chat/completionsTous
Responses /v1/responsesGrok 4.3, 4.20, 4.1 Fast
API Anthropic nativeGrok 4.3 uniquement ; les autres renvoient protocol_not_supported

Les modèles Grok sont fournis par xAI (grok) ; certains sont également disponibles chez le fournisseur Azure AI Foundry.

Exemples d’appel

grok_basic.py
import os from openai import OpenAI client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"]) resp = client.chat.completions.create( model="x-ai/grok-4.7", reasoning_effort="low", messages=[{"role": "user", "content": "Explique en une phrase ce qu’est l’idempotence."}], ) print(resp.choices[0].message.content) print("Tokens de reasoning :", resp.usage.completion_tokens_details.reasoning_tokens)

Reasoning

L'essentielGrok 4.7, 4.6 et 4.5 raisonnent systématiquement, et une question complexe peut prendre plusieurs minutes. Réduisez le reasoning avec reasoning_effort: low, ou passez au modèle sans reasoning Grok 4.1 Fast.
ModèleReasoningreasoning_effort
Grok 4.7, 4.6, 4.5Systématiquelow réduit nettement le reasoning
Grok 4.3Systématique, contenu du reasoning non renvoyéAccepté
Grok 4.1 Fast, 4.20AucunSur Grok 4.1 Fast, le passer renvoie 400

Mesuré sur un même problème de mathématiques : par défaut, Grok 4.7 produit environ 15 000 tokens de reasoning en 4 minutes environ ; avec reasoning_effort: "low", environ 4 200 tokens en 1 minute environ. Les tokens de reasoning sont facturés au prix unitaire de sortie, leur nombre figurant dans usage.completion_tokens_details.reasoning_tokens ; le contenu du reasoning se trouve dans delta.reasoning_content des réponses en streaming.

Autres fonctionnalités

  • Entrée d’images : prise en charge par Grok 4.3, 4.20 et 4.1 Fast, avec les blocs de contenu image_url standard ; voir Compréhension d’images.
  • Sortie structurée et appel d’outils : response_format accepte json_schema ; l’appel d’outils utilise le paramètre standard tools.
  • Cache : les préfixes de requête répétés sont mis en cache automatiquement ; le volume de cache atteint figure dans usage.prompt_tokens_details.cached_tokens.

Erreurs courantes

HTTP · typeMessage d’erreurCauseSolution
400 invalid_request_errorContient This model does not support et reasoningreasoning_effort passé au modèle sans reasoning Grok 4.1 FastSupprimez ce paramètre
400 protocol_not_supportedModel 'x-ai/grok-4.7' does not support the 'anthropic' protocol on this platform.Ce modèle ne prend pas en charge l’API AnthropicUtilisez l’API compatible OpenAI
400 endpoint_not_supportedModel 'x-ai/grok-4.7' does not support the /v1/responses endpoint on this platform.Ce modèle ne prend pas en charge l’endpoint ResponsesUtilisez /v1/chat/completions
404 model_not_foundModel 'xai/grok-4.7' not foundPréfixe écrit xai/Le préfixe est x-ai/
Délai dépassé—Reasoning trop longPassez reasoning_effort: "low", utilisez le streaming, ou réglez le délai d’attente du client sur 600 secondes ou plus

Les autres erreurs générales sont décrites dans Gestion des erreurs.

Documentation officielle

FAQ

Comment s'écrit l'ID de modèle de Grok ?

La forme standard est x-ai/grok-4.7 ; le préfixe peut être omis : grok-4.7. Écrire xai/grok-4.7 renvoie 404.

Pourquoi Grok 4.7 est-il si lent ?

Grok 4.7, 4.6 et 4.5 raisonnent systématiquement ; une question complexe peut produire plus de 10 000 tokens de reasoning et prendre plusieurs minutes. Passez reasoning_effort: "low" pour raccourcir nettement le temps, ou utilisez Grok 4.1 Fast, sans reasoning.

Peut-on désactiver le reasoning de Grok ?

Le reasoning de Grok 4.7, 4.6, 4.5 et 4.3 ne peut pas être désactivé ; seul reasoning_effort permet de le réduire. Pour des réponses rapides, utilisez Grok 4.1 Fast.

Claude Code peut-il utiliser Grok ?

Seul Grok 4.3 prend en charge l'API Anthropic ; les autres modèles Grok renvoient protocol_not_supported.

Quelle longueur de contexte Grok prend-il en charge ?

2M tokens pour Grok 4.1 Fast et 4.20, 1M pour Grok 4.3, 500K pour Grok 4.7, 4.6 et 4.5.

Dernière mise à jour le