Différences de paramètres et de protocoles de Grok

Découvrez les différences de paramètres et l’utilisation de Grok avec les protocoles compatibles.

Réglez pensée, échantillonnage et cache Grok selon cette page. Structures complètes : Chat Completions et Responses.

Modèles concernés

Modèle	Points d’utilisation
grok-4.7	Accepte `low/medium/high/xhigh`, défaut `high`, pensée non désactivable ; Responses renvoie le chiffré par défaut
grok-4.6	Quatre niveaux également, défaut `high`, pensée non désactivable ; demander le chiffré via `include`
grok-4.5	Accepte `low/medium/high`, défaut `high`, pensée non désactivable ; `xhigh` traité comme `high`

xAI classe Chat comme compatibilité historique, Responses comme API principale ; Messages historique est déprécié. Cela ne signifie pas que la plateforme a désactivé d’autres entrées.

Différences Chat Completions

Champ	Différence
`reasoning_effort`	Choisir selon le tableau ; `none` ne désactive pas la pensée
`temperature`	Requête autorisée `0～2`, échantillonnage effectif plafonné à `1`. Valeurs valides au-dessus de `1` ramenées à `1` ; pas une dépréciation
`top_p`	Valeur valide jusqu’à `1`, mais effectif plafonné au défaut du modèle, actuellement `0.95`. Omission : valeur par défaut
`presence_penalty/frequency_penalty/stop`	Non pris en charge sur ces modèles, erreur si fourni ; ne pas reprendre ces options de la Reference générale
`logprobs/top_logprobs`	Non pris en charge sur les trois et ignorés silencieusement, contrairement aux erreurs ci-dessus
`tools[].function.strict`	Arguments conformes au JSON Schema accepté ; `strict` implicitement `true`. `false` ne permet pas la génération non stricte
Historique de raisonnement	Chat n’a pas le champ de pensée chiffrée Responses ; utiliser Responses pour la transmettre entre tours

Différences Responses

Champ	Différence
`reasoning.effort`	Niveaux selon modèle, défaut `high` ; pensée non désactivable
`temperature/top_p`	Même plafond d’échantillonnage. La réponse peut répéter la valeur demandée, pas la valeur réellement plafonnée
Pénalités et Logprobs	Comme Chat : pénalités non prises en charge, Logprobs ignorés ; Responses ne les réactive pas
`max_output_tokens`	Limite la réponse visible seulement, sans tokens de pensée ni fonctions ; défaut `128000`, pas le budget combiné OpenAI
`include`	grok-4.6, grok-4.5 demandent le chiffré via `reasoning.encrypted_content` ; grok-4.7 le renvoie même sans demande
`store/previous_response_id`	`store` : défaut `true`. Réponses natives conservées `30` jours, poursuivables par ID. Avec `store: false`, renvoyer tout l’historique et tous les éléments, pas seulement le texte ; chiffré inchangé
`tools[].strict`	Fonctions aussi implicitement strictes ; paramètres et sortie structurée selon le sous-ensemble xAI
JSON Schema	`additionalProperties` : défaut `false`, définir `true` pour des attributs supplémentaires ; `$ref/$defs` n’accepte que les références non circulaires, pas la récursion
Outils côté serveur	xAI Responses utilise `web_search`, `x_search`, `code_interpreter`, etc. Le dernier correspond à `code_execution` du SDK natif ; ne pas confondre les noms

Différences de cache

Champ	Différence
Cache automatique de préfixe	Réutilisation automatique des préfixes ; instructions fixes d’abord, ajouter ensuite sans supprimer ni réordonner l’historique
`x-grok-conv-id`	Identifiant stable de conversation dans le Header Chat, favorisant le routage vers le serveur en cache ; pas un paramètre du modèle
`prompt_cache_key`	Identifiant correspondant dans Responses ; stable entre tours, chiffré renvoyé intact. Pas de TTL ni point explicite d’autres fournisseurs
Utilisation du cache	Chat : `usage.prompt_tokens_details.cached_tokens`, Responses : `usage.input_tokens_details.cached_tokens` ; cache évictable, identifiant sans garantie de hit

Différences d’entrée multimédia

Entrée	Bloc du protocole	Différence
Image	`image_url`	Chat `image_url.url` : URL publique / Base64 Data URL ; JPEG / PNG, `20 MiB` par image maximum
Image	`input_image`	Responses `image_url` directement URL publique / Base64 Data URL, mêmes limites ; pas l’objet imbriqué Chat

Les trois produisent du texte ; detail accepte auto/low/high pour la précision d’analyse, pas pour générer une image.

Exemples d’appel

Remplacez MODEL_ID par l’ID complet et fixez un identifiant stable par conversation. Responses gère manuellement l’historique ; renvoyer toute sortie et pensée chiffrée ensuite.

curl 'https://api.agtcloud.ai/v1/chat/completions' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  -H 'x-grok-conv-id: YOUR_CONVERSATION_ID' \
  --data '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "Expliquez en trois points comment diagnostiquer un délai d’attente API"}],
    "reasoning_effort": "high",
    "max_tokens": 4096
  }'

Références officielles

Grok 4.7 · Grok 4.6 · Grok 4.5 · Limites des modèles
Pensée et contenu chiffré · Échantillonnage et budget · Chat et Responses
Compatibilité Chat · Responses Reference · API historiques
Sortie structurée et Schema · Outils serveur · Noms d’exécution de code
Identifiants de cache · Règles du cache · Entrée image