Reasoning vs Non-reasoning

Leçon corrigée le 3 novembre 2026 d’après la référence de l’API et le guide Reasoning de xAI : max_completion_tokens ne plafonne que la réponse visible, sans le raisonnement ; logprobs est ignoré à partir de Grok 4.20 ; le raisonnement réglable concerne grok-4.5, 4.6 et 4.7. Sources : Chat Completions · Reasoning.

Deux approches fondamentalement différentes

La gamme Grok propose deux approches du raisonnement : la génération grok-4.20 existe en deux variantes distinctes — reasoning et non-reasoning — tandis que grok-4.5, grok-4.6 et grok-4.7 les unifient dans un raisonnement réglable par un paramètre d’effort, qui ne se désactive pas. Ce choix n’est pas cosmétique — il modifie fondamentalement le comportement du modèle, ses capacités, son coût et ses contraintes API. Choisir la bonne variante pour chaque tâche est une compétence clé.

Comment fonctionne le reasoning

Quand vous utilisez une variante reasoning, le modèle s’engage dans un processus de réflexion interne avant de produire sa réponse. Il décompose le problème, explore différentes approches, vérifie sa logique et construit sa réponse étape par étape.

Chez xAI, ce raisonnement est « chiffré » pour les modèles Grok 4 et supérieurs : vous ne pouvez pas lire les étapes intermédiaires en clair. Vous pouvez toutefois :

• Récupérer le contenu chiffré via include=["reasoning.encrypted_content"] pour le réinjecter dans les requêtes suivantes
• Consulter le nombre de tokens de raisonnement dans usage.completion_tokens_details.reasoning_tokens

Le raisonnement consomme des tokens supplémentaires, facturés au tarif de sortie. Une requête reasoning coûte donc plus qu’une requête non-reasoning identique ; l’écart dépend de la tâche et de l’effort, mesurez-le sur vos données.

Paramètres interdits en mode reasoning

C’est un piège fréquent lors de la migration. Les variantes reasoning ne supportent pas certains paramètres qui sont courants en mode non-reasoning :

Si vous passez presencePenalty, frequencyPenalty ou stop à une variante reasoning, l’API retournera une erreur. Assurez-vous de retirer ces paramètres de vos requêtes quand vous basculez vers le reasoning.

Quand utiliser le reasoning

Le reasoning apporte une valeur ajoutée claire sur certaines catégories de tâches :

• Mathématiques et logique formelle — résolution d’équations, preuves, optimisation
• Analyse de code complexe — debugging avec interdépendances, audit de sécurité
• Questions multi-étapes — problèmes qui nécessitent de construire un raisonnement en plusieurs phases
• Décisions nuancées — évaluation de pour et contre, analyse comparative approfondie
• Expertise quantitative — statistiques, modélisation financière, analyse de données

Quand utiliser le non-reasoning

Le non-reasoning est préférable quand la tâche ne nécessite pas de réflexion approfondie :

• Rédaction et résumé — le modèle n’a pas besoin de « réfléchir » pour rédiger
• Classification et tagging — catégorisation rapide de contenus
• Extraction d’informations — structurer des données depuis du texte brut
• Traduction — le modèle sait traduire sans raisonnement explicite
• Conversation simple — chatbots, FAQ, assistance de premier niveau
• Génération de contenu — emails, descriptions, copy marketing

Stratégie de routage

En production, la stratégie optimale consiste à router dynamiquement les requêtes vers la bonne variante :

1. Analysez la requête — détermine-t-elle un calcul, une analyse ou un simple traitement ?
2. Routing par défaut vers non-reasoning — c’est plus rapide et moins cher
3. Basculez vers reasoning quand la requête implique un raisonnement multi-étapes
4. Monitorez les résultats — ajustez les critères de routage en fonction de la qualité observée

Cette approche vous permet de bénéficier de la puissance du reasoning quand c’est nécessaire, sans en payer le surcoût quand c’est superflu.

Le cas particulier de max_completion_tokens

D’après la référence de l’API xAI, max_completion_tokens ne s’applique qu’à la réponse visible : les tokens de raisonnement et d’appels de fonction n’y comptent pas, et la valeur par défaut est de 128 000 tokens. Fixez donc ce plafond d’après la longueur de réponse attendue, et réglez le raisonnement par l’effort (reasoning_effort) sur grok-4.5, 4.6 et 4.7.

Points clés à retenir

• Les variantes reasoning ajoutent une phase de réflexion interne avant de répondre
• Le raisonnement est chiffré (non visible en clair) ; grok-4.7 en expose toutefois un résumé, consultable en streaming
• presencePenalty, frequencyPenalty et stop sont interdits en mode reasoning
• Le reasoning coûte 2 à 5 fois plus que le non-reasoning
• Utilisez le reasoning pour les maths, la logique et les problèmes multi-étapes
• Utilisez le non-reasoning pour la rédaction, la classification et l’extraction