Veille sur les dépréciations et migrations
Des modèles sont retirés, des paramètres sont renommés, des comportements changent. Cette page recense les changements cassants afin que les mises à niveau ne vous surprennent pas. Si vous développez sur l'API, parcourez-la régulièrement.
Pourquoi c'est important
Un ID de modèle épinglé finira par être déprécié puis supprimé. Le code qui le code en dur cesse de fonctionner. Un peu d'hygiène évite les mauvaises surprises à 2 h du matin.
Règles de survie
- Lisez les IDs de modèle depuis la configuration, ne dispersez jamais de valeurs littérales dans la base de code — la migration devient alors une modification d'une seule ligne.
- Surveillez les annonces pour connaître les dates de dépréciation et les remplacements recommandés.
- Relancez vos évaluations lorsque vous changez de modèle — le comportement peut évoluer même sur un modèle « plus récent et meilleur ».
- Testez avant l'échéance, pas après la suppression.
Types de changement courants
| Changement | Exemple | Que faire |
|---|---|---|
| Modèle retiré | Un ancien ID de modèle cesse de fonctionner | Passez au successeur recommandé ; réévaluez |
| Paramètre remplacé | Un réglage de raisonnement/budget remplacé par effort | Mettez à jour les appels ; voir Réflexion et effort |
| Changement de valeur par défaut | Un nouveau modèle/comportement par défaut | Épinglez intentionnellement ; vérifiez que vos prompts fonctionnent toujours |
| Mise à jour d'endpoint/SDK | Nouvelle version majeure du SDK | Lisez le guide de migration ; effectuez la mise à niveau délibérément |
Veille actuelle
Le calendrier faisant autorité figure sur la page officielle des dépréciations de modèles — confirmez-y les dates avant de migrer. Anthropic donne un préavis d'au moins 60 jours avant de retirer un modèle publié.
Modèles dépréciés
| ID de modèle | Déprécié | Retrait | Migrer vers |
|---|---|---|---|
claude-opus-4-1-20250805 (Opus 4.1) | 5 juin 2026 | 5 août 2026 | claude-opus-4-8 |
Les requêtes vers un modèle au-delà de sa date de retrait échouent — si vous épinglez Opus 4.1, migrez avant l'échéance.
Récemment retirés
claude-opus-4-20250514 (Opus 4) et claude-sonnet-4-20250514 (Sonnet 4) ont été retirés le 15 juin 2026. Les appels vers ces IDs renvoient désormais une erreur — passez respectivement à claude-opus-4-8 et claude-sonnet-5.
Dépréciations de paramètres
Sur Claude Opus 4.7 et versions ultérieures (y compris Opus 4.8), les réglages d'échantillonnage temperature, top_p et top_k sont dépréciés : leur affecter une valeur autre que celle par défaut renvoie une erreur 400. Omettez-les et orientez le comportement via le prompting et Réflexion et effort à la place.
Confirmez toujours vos IDs de modèle par rapport au tableau Modèles et tarifs actuels ; si vous utilisez un ancien ID, planifiez une migration.