Un budget de raisonnement est le plafond des tokens qu'un modèle peut utiliser pour réfléchir en interne avant de produire une réponse. Il ne détermine pas la longueur de la réponse, seulement la durée pendant laquelle le modèle peut réfléchir. Augmenter le budget ne rend pas la réponse automatiquement plus longue ; un budget trop bas peut faire répondre à une question difficile avant qu'elle ait été bien réfléchie.
Les trois fournisseurs n'utilisent pas les mêmes noms, ne les mélangez pas
OpenAI utilise reasoning.effort, avec les niveaux none, minimal, low, medium et high ; un niveau n'est pas un nombre de tokens. L'ancien style de Claude utilise budget_tokens dans thinking, un nombre saisi directement, avec un minimum de 1 024 et une valeur qui doit rester inférieure à max_tokens ; le nouveau style utilise output_config.effort, avec les niveaux low, medium, high, xhigh et max, et l'ancienne forme est abandonnée sur les modèles récents. Gemini 2.5 utilise thinkingBudget, un nombre où 0 désactive la réflexion et -1 signifie une réflexion dynamique ; Gemini 3 utilise le niveau thinking_level : minimal, low, medium ou high. Dans une application de chat, un utilisateur ordinaire ne peut généralement que choisir un modèle, activer ou désactiver la réflexion, ou choisir un niveau ; saisir un nombre exact est le travail des développeurs qui appellent l'API.
Augmenter ou diminuer, et ce que chacun coûte
Les tokens de réflexion sont facturés comme des tokens de sortie, et ils consomment aussi du contexte et de la limite de sortie. Un budget trop élevé laisse trop peu de place à la réponse, et le modèle peut être coupé avant d'avoir fini d'écrire ; un budget trop bas fait sauter des étapes ou se tromper sur les questions difficiles. L'augmenter aide généralement pour les mathématiques, la planification en plusieurs étapes et le débogage complexe, mais cela coûte plus cher et prend plus de temps ; pour chercher des informations, résumer, classer ou mettre en forme, le gain est faible. Le diminuer convient aux conversations en direct, à la voix et au traitement en masse : moins cher et plus rapide.
Trois malentendus fréquents
Premièrement, un budget est un plafond, pas un montant exact. Régler 8 000 ne signifie pas dépenser 8 000 à chaque fois ; une question simple fait arrêter la réflexion plus tôt. Deuxièmement, augmenter le budget ne rend pas toujours la réponse plus exacte ; les gains diminuent, et trop réfléchir peut mener sur une fausse piste ou remettre en cause une bonne réponse. Troisièmement, le processus complet de réflexion n'est pas visible par défaut ; on ne voit qu'un résumé ou un panneau de réflexion dépliable. Commencez par le niveau le plus bas pour chaque tâche, puis montez progressivement jusqu'à trouver le niveau suffisant sans gaspillage : c'est la bonne façon d'utiliser un budget de raisonnement.
