Tous les noms de modèles de l'API Anthropic : IDs et alias actuels des modèles Claude

Si vous avez cherché tous les noms de modèles de l’API Anthropic, la réponse la plus rapide est celle-ci : les noms d’affichage Claude, les IDs de modèles actuels et les instantanés datés sont tous des étiquettes d’apparence valide, mais seul l’identifiant API exact appartient au champ model. Anthropic utilise des noms Claude lisibles par l’humain pour les pages produits, des IDs de modèles datés pour des appels API reproductibles, et des alias pour des mises à niveau pratiques. Ces valeurs sont liées, mais elles ne sont pas interchangeables.

La règle pratique est simple : utilisez un ID de modèle exact lorsque vous avez besoin d’un comportement reproductible, utilisez un alias lorsque vous souhaitez intentionnellement qu’Anthropic vous déplace vers un instantané plus récent, et ne copiez jamais un nom marketing dans une requête API sans vérifier d’abord la liste officielle des modèles.

Si votre prochaine étape concerne le format de la requête plutôt que le système de dénomination, associez ce guide à la Documentation de l’API Messages Anthropic. Si vous choisissez un workflow de codage orienté Claude, Modèles pris en charge par Claude Code est la lecture complémentaire la plus adaptée.

Qu’est-ce qu’un nom de modèle API Anthropic ?

Un nom de modèle API Anthropic est l’identifiant envoyé dans le paramètre model d’une requête à l’API Messages. Il indique à Anthropic quelle famille et quel instantané de Claude doivent traiter la requête.

Ces trois formes sont faciles à confondre :

Type de valeur	Exemple	Meilleure utilisation
Nom d’affichage	Claude Sonnet	Documentation, interface utilisateur du produit, conversations avec des lecteurs non techniques
ID de modèle actuel	claude-sonnet-5	Nouvelles intégrations utilisant un modèle listé sur la page des modèles actuels d’Anthropic
ID de modèle daté	claude-haiku-4-5-20251001	Tests, workflows réglementés, évaluations et déploiements de production nécessitant de la reproductibilité

Le catalogue exact change avec le temps. Considérez la page des modèles actuels d’Anthropic et la page des dépréciations de modèles comme la source de vérité, plutôt que de coder en dur une liste copiée d’un ancien tutoriel.

Noms de modèles Claude versus IDs de modèles Claude

Les noms de modèles Claude sont optimisés pour les humains. « Claude Sonnet » communique le niveau du produit, tandis que « Claude Haiku » suggère le niveau plus rapide et moins coûteux. L’API nécessite une valeur plus précise car une famille peut avoir plusieurs instantanés, des règles de disponibilité régionale et des dates de retraite.

Un ID daté inclut généralement :

1. La famille Claude, comme opus, sonnet ou haiku.
2. La génération majeure du modèle.
3. Une date de publication au format AAAAMMJJ.

Par exemple, claude-haiku-4-5-20251001 identifie l’instantané Haiku 4.5 publié le 1er octobre 2025. La date fait partie de l’identifiant ; ce n’est pas un horodatage de requête et ne doit pas être remplacée par la date actuelle.

Certains catalogues de modèles exposent également des identifiants de niveau famille plus courts. Ils sont pratiques lorsque vous souhaitez un modèle pris en charge sans gérer vous-même un instantané daté. Le compromis est qu’un pointeur géré par le fournisseur peut changer de comportement après une mise à jour. Vérifiez donc la sémantique de l’ID exact affiché dans le catalogue actuel d’Anthropic.

IDs de modèles Claude courants que vous pourriez rencontrer

Les IDs API suivants étaient listés comme actifs sur la page des modèles actuels d’Anthropic le 24 juillet 2026. Ce tableau est une orientation ponctuelle, pas un registre permanent. Vérifiez la documentation d’Anthropic avant d’utiliser un ID dans un nouveau déploiement.

Famille Claude	ID API actuel	Rôle typique
Claude Opus 4.8	claude-opus-4-8	Raisonnement complexe et analyses à forts enjeux
Claude Sonnet 5	claude-sonnet-5	Charges de travail de production à usage général
Claude Haiku 4.5	claude-haiku-4-5-20251001	Classification rapide, extraction et réponses courtes
Claude Opus 4.7	claude-opus-4-7	Intégrations Opus de génération récente qui n’ont pas migré vers la 4.8
Claude Sonnet 4.6	claude-sonnet-4-6	Intégrations Sonnet de génération récente qui n’ont pas migré vers Sonnet 5

Ce sont des identifiants, pas des garanties qu’un modèle est disponible sur chaque compte Anthropic. Même un ID actuellement listé peut échouer en raison des autorisations du compte, de la région, du quota ou d’un changement ultérieur de cycle de vie. Les IDs datés sont reproductibles tant qu’ils sont pris en charge, mais ils finissent par être retirés.

Comment choisir entre Opus, Sonnet et Haiku

Choisissez en fonction de la charge de travail plutôt que du nom le plus long :

• Opus : Utilisez-le lorsque le raisonnement difficile, la synthèse de longue forme ou les décisions nuancées concernant les outils justifient une latence ou un coût plus élevés.
• Sonnet : Commencez ici pour la plupart des assistants de production, des workflows de codage et de la génération structurée. C’est généralement la référence pratique entre qualité et latence.
• Haiku : Utilisez-le pour le routage à haut volume, l’extraction, la modération, les réécritures courtes et d’autres tâches où le temps de réponse est plus important que la profondeur maximale de raisonnement.

Réalisez une petite évaluation sur des invites représentatives avant de changer de famille. Incluez des entrées malformées, un contexte long, des appels d’outils, une sortie JSON et le comportement de repli que votre application utilise lorsqu’une requête échoue. Un nom de modèle qui ressemble à un remplacement direct peut encore modifier le formatage des appels d’outils ou le comportement dans les cas limites.

Utiliser l’ID du modèle dans une requête de l’API Messages

La valeur model appartient au corps JSON. Elle est distincte de l’en-tête de version API et du modèle affiché dans l’application web Claude.

curl https://api.anthropic.com/v1/messages \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-sonnet-5",
    "max_tokens": 512,
    "messages": [
      {
        "role": "user",
        "content": "Expliquez pourquoi les IDs de modèles API doivent être épinglés en production."
      }
    ]
  }'

L’en-tête anthropic-version décrit le contrat API. Il ne sélectionne pas le modèle Claude. Gardez ces deux paramètres indépendants dans votre configuration afin qu’une mise à niveau de la bibliothèque cliente ne modifie pas silencieusement le routage du modèle.

Pour une utilisation du SDK, définissez le même identifiant via la méthode de création de message du client et conservez-le dans une valeur de configuration spécifique à l’environnement. Ne placez pas de clé API ou d’ID de modèle dans un bundle navigateur ; le routage côté serveur est plus facile à sécuriser et à tester.

Pourquoi un ID de modèle API peut cesser de fonctionner

Une réponse invalid_request_error ou « modèle non trouvé » relève généralement de l’une de ces catégories :

Le nom d’affichage a été utilisé à la place de l’ID

Claude Sonnet est une étiquette utile mais pas une valeur de requête fiable. Remplacez-la par un ID ou un alias listé dans la documentation du fournisseur.

L’instantané a été déprécié

Les IDs datés ne sont reproductibles que tant que le fournisseur les prend en charge. Surveillez le calendrier de dépréciation, fixez une date limite de migration et testez le remplacement avant la date de retraite.

Le compte ne peut pas accéder au modèle

Un identifiant valide peut néanmoins être indisponible en raison des autorisations du compte, de la région, du quota ou d’une politique de l’organisation. Vérifiez le corps de la réponse et la configuration du compte plutôt que de modifier l’invite.

Le routeur attend un nom spécifique au fournisseur

Les passerelles et les API compatibles OpenAI peuvent normaliser les noms de modèles différemment. Anthropic documente actuellement claude-sonnet-5, tandis qu’un autre fournisseur peut exposer une valeur avec espace de noms ou un alias propriétaire. Utilisez le catalogue de modèles de la passerelle et ne supposez pas qu’un ID Claude est portable sur n’importe quel point de terminaison.

Utiliser des workflows de style Claude via un point de terminaison compatible

Si votre application utilise déjà la forme du client OpenAI, une couche de compatibilité peut réduire le travail de migration. L’API LLM Novita fournit un point de terminaison compatible OpenAI pour router les modèles open source pris en charge via une forme de requête familière de type chat completions.

Cela ne signifie pas que chaque ID de modèle Claude est automatiquement disponible là-bas. Gardez le routage du fournisseur explicite :

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["NOVITA_API_KEY"],
    base_url="https://api.novita.ai/v3/openai",
)

response = client.chat.completions.create(
    model="moonshotai/kimi-k2.5",
    messages=[
        {"role": "user", "content": "Résumez ce ticket de support en trois points."}
    ],
)

print(response.choices[0].message.content)

Le modèle de conception important est une carte fournisseur/modèle, pas une seule chaîne globale :

MODELS = {
    "anthropic": "claude-sonnet-5",
    "novita": "moonshotai/kimi-k2.5",
}

Cela vous permet d’évaluer un modèle Claude par rapport à une alternative open source sans réécrire la logique métier. Avant de changer, comparez la sortie structurée, les appels d’outils, la gestion du contexte, la latence et les modes de défaillance—pas seulement le nom d’affichage ou le titre du benchmark.

IDs de modèles dans les backends d’agents et les sandbox

Un agent appelle généralement un modèle plusieurs fois : planification, sélection d’outils, réparation de code et réponse finale. Placez l’identifiant du modèle dans la configuration du backend, pas dans les arguments d’outils contrôlés par l’utilisateur. Enregistrez le fournisseur sélectionné et l’ID du modèle avec chaque exécution afin qu’une évaluation puisse être reproduite ultérieurement.

Lorsqu’un agent exécute du code généré, gardez le routage du modèle séparé de l’environnement d’exécution. Un Sandbox d’Agent géré peut isoler les fichiers, les packages et les commandes, tandis que la configuration de l’API LLM reste dans le service agent. Cette séparation permet de modifier un alias de modèle ou de tester un instantané épinglé sans changer l’image du sandbox.

Pour les agents de production, ajoutez trois garanties :

1. Validez le modèle configuré au démarrage avec une petite requête authentifiée ou une vérification du catalogue du fournisseur.
2. Conservez un ID de repli testé et rendez l’activation du repli visible dans la télémétrie.
3. Stockez l’ID du modèle, la version de l’API, la version de l’invite et le schéma d’outils avec les résultats de l’évaluation.

FAQ

Quel est le nom correct du modèle Claude pour l’API ?

Utilisez l’ID de modèle exact listé dans la documentation actuelle d’Anthropic, comme claude-sonnet-5 ou le daté claude-haiku-4-5-20251001. N’utilisez pas un nom d’affichage comme « Claude Sonnet » seul.

Un ID de modèle Claude daté est-il meilleur qu’un alias ?

Aucun n’est toujours meilleur. Un ID daté est préférable pour la reproductibilité et les déploiements contrôlés. Un alias est préférable lorsque vous souhaitez un pointeur de famille maintenu et que vous disposez de tests de régression pour les mises à jour du fournisseur.

Puis-je utiliser les IDs de modèles Anthropic avec une API compatible OpenAI ?

Seulement si ce point de terminaison prend explicitement en charge et documente l’ID. « Compatible OpenAI » décrit l’interface de requête ; cela ne promet pas des catalogues de modèles identiques. Vérifiez les modèles pris en charge du point de terminaison et utilisez son nom de routage exact.

Comment empêcher une dépréciation de modèle de casser mon application ?

Épinglez un ID testé, surveillez les avis de dépréciation d’Anthropic, testez le remplacement avant la date de retraite, et conservez la valeur du modèle dans la configuration pour pouvoir la modifier sans déployer de changements de logique métier.

Articles recommandés

• Simplifier l’intégration de l’API LLM pour les développeurs
• La meilleure plateforme API LLM pour changer de fournisseur
• Qu’est-ce qu’un sandbox d’agent IA ?

Sources

• Anthropic : Aperçu des modèles
• Anthropic : Référence API des modèles
• Anthropic : Référence API Messages
• Anthropic : Dépréciations de modèles
• Novita AI : API LLM