Aller au contenu
Cercle IA Tech · API Un site du réseau Cercle IA Tech

Guide

Température et top_p : ce que l'API accepte encore

Claude refuse temperature, top_p et top_k depuis la révision du 21/10/2026 ; Gemini 4 les ignore ; Mistral les garde. État au 16/11/2026.

Mis à jour le

Que faire de votre code
  1. Cherchez dans votre code les appels qui fixent temperature en dur (souvent hérités d'un exemple ou d'un framework).
  2. Rendez ces champs optionnels et propres à chaque fournisseur : ce qui passe chez Mistral peut casser chez Claude.
  3. Testez avec la version d'API que vous visez avant de la changer en production.
  4. Si vous changez de fournisseur, regardez ce que vaut une API « compatible » : un champ accepté n'est pas toujours appliqué.

La température règle le degré de variation d'un modèle : plus basse, elle tend à concentrer le choix des jetons ; plus haute, elle augmente la variation. Ce réglage a longtemps figuré dans de nombreux exemples d’API. Ce n'est plus vrai partout : selon les documentations lues le 16/11/2026, Claude refuse maintenant ces réglages, Gemini 4 les ignore et Mistral les conserve. Si votre code envoie temperature à tout hasard, il peut tomber en erreur. (Pour la définition de la notion, voir le lexique de Cercle IA.)

Lorsqu’un assistant est appelé via une plateforme, utilisez son contrat d’intégration, par exemple la documentation API d’ALMA. Ne transmettez pas automatiquement les paramètres d’un fournisseur de modèle à une interface qui expose d’autres réglages.

Claude : paramètres retirés

La page des versions d'API d'Anthropic indique, pour la révision datée du 21/10/2026 (identifiant 2026-10-21) : les paramètres de requête temperature, top_p et top_k sont supprimés, et une requête qui en envoie un renvoie une erreur 400 sur tous les modèles. La page sur l'utilisation de l'API Messages ajoute que ces paramètres ne sont déjà pas pris en charge sur les modèles Claude 4.7 et suivants : une valeur non par défaut renvoie une erreur 400, et à partir de cette révision, n'importe quelle valeur.

Conseil officiel : omettre ces paramètres des requêtes et guider le comportement du modèle par le prompt. Les exemples d'appel du site n'en contiennent pas. Pour comprendre le champ anthropic-version, voir la page sur les versions de l'API.

Gemini : valeurs ignorées

La documentation de génération de texte de Gemini indique que les modèles Gemini 4 et Gemini 3.6 et suivants ignorent les valeurs personnalisées de temperature, top_p et top_k, renvoient des en-têtes d'avertissement de dépréciation, et recommande de retirer ces paramètres des requêtes. La page présente à la place des réglages dans generation_config, comme max_output_tokens ou thinking_level (la réflexion y est « activée par défaut » sur de nombreux modèles Gemini).

Mistral : réglages conservés

La référence du point d'accès de conversation de Mistral décrit toujours :

  • temperature : recommandée entre 0,0 et 0,7 ; aucune valeur par défaut fixe n'est donnée, elle dépend du modèle et se lit via le point d'accès /models ;
  • top_p : échantillonnage par masse de probabilité (0,1 ne retient que les jetons qui totalisent les 10 % les plus probables) ; il est conseillé de modifier soit lui, soit la température, « mais pas les deux » ;
  • random_seed : la documentation annonce des résultats déterministes lorsqu’il est renseigné. Pour comparer vos essais, conservez aussi le modèle, les messages et les autres paramètres ; ce champ ne garantit pas une reproduction après modification du modèle ou de l’environnement ;
  • max_tokens, stop et stream.

Tableau récapitulatif

Éditeur temperature / top_p / top_k Alternative documentée
Claude (révision du 21/10/2026) Erreur 400 Prompt plus précis
Gemini 4 et 3.6+ Ignorés, avertissement generation_config
Mistral Acceptés random_seed pour la reproductibilité

Que faire de votre code

  1. Cherchez dans votre code les appels qui fixent temperature en dur (souvent hérités d'un exemple ou d'un framework).
  2. Rendez ces champs optionnels et propres à chaque fournisseur : ce qui passe chez Mistral peut casser chez Claude.
  3. Testez avec la version d'API que vous visez avant de la changer en production.
  4. Si vous changez de fournisseur, regardez ce que vaut une API « compatible » : un champ accepté n'est pas toujours appliqué.

Vérifier la requête réellement envoyée

Voici une méthode de contrôle proposée pour votre intégration. Préparez un exemple sans données confidentielles et examinez le corps envoyé après passage dans votre bibliothèque. Cherchez les paramètres ajoutés automatiquement : retirer une option de votre propre configuration ne suffit pas à prouver son absence dans la requête finale.

Consignez séparément le modèle, la version d'API, les champs présents et la réponse obtenue. Comparez ensuite un appel minimal avec celui de votre application. Si le premier réussit et le second échoue, leur différence fournit une piste précise à examiner. Évitez de changer simultanément le modèle, la consigne et les paramètres : vous ne sauriez plus quel changement explique le résultat.

Ce contrôle porte sur la compatibilité technique. Pour la qualité, reprenez les mêmes questions représentatives et relisez les réponses attendues. Une requête acceptée ne constitue pas, à elle seule, un critère de validation métier. Sources des paramètres revérifiées le 16/11/2026.

Stabiliser ce qui compte pour le métier

Ne confondez pas une réponse identique et une réponse correcte. Pour une extraction, définissez les champs obligatoires, la manière de signaler une valeur absente et le contrôle des montants. Pour une rédaction, fixez les informations à conserver et les critères de relecture. Ces vérifications restent nécessaires avec un réglage peu variable ou une graine fixe.

Si vous cherchez un format stable, examinez les sorties structurées et leur validation applicative. La température ne remplace ni un schéma de données ni une vérification de la source.

Questions fréquentes

Pourquoi mon appel à Claude renvoie-t-il une erreur 400 avec temperature ?

À partir de la révision d'API datée du 21/10/2026 (identifiant `2026-10-21`), temperature, top_p et top_k sont retirés : toute requête qui en envoie un renvoie une erreur 400 sur tous les modèles. Avant cette révision, ils restent refusés avec une valeur non par défaut sur les modèles Claude 4.7 et suivants.

Comment rendre les réponses plus stables sans température ?

La documentation de Claude recommande d'omettre ces paramètres et de guider le comportement du modèle par le prompt. Chez Mistral, le paramètre random_seed permet des résultats déterministes.

Quelle température recommande Mistral ?

La référence de l'API Mistral recommande une valeur entre 0,0 et 0,7, et conseille de modifier soit temperature soit top_p, mais pas les deux.

Sources

Pages consultées pour écrire cet article :

  1. https://alma.iarche.fr/fr/api-docs
  2. https://platform.claude.com/docs/en/api/versioning
  3. https://platform.claude.com/docs/en/build-with-claude/working-with-messages
  4. https://aistudio.google.com/docs/text-generation
  5. https://docs.mistral.ai/api/endpoint/chat
  6. https://docs.mistral.ai/api

À lire aussi