ID dei modelli e versionamento

Ogni ID di modello Claude identifica una versione fissata (pinned) del modello. Quando usi un ID di modello in una richiesta API, il modello sottostante rimane costante per tutta la durata di vita di quell'ID. Questa garanzia copre gli ID dei modelli, non gli alias di convenienza che l'API di Claude accetta per alcuni modelli precedenti (vedi Prima della generazione 4.6).



Formato degli ID dei modelli

Gli ID dei modelli Claude seguono uno schema di denominazione versionato.



La generazione 4.6 e successive

A partire dalla generazione Claude 4.6, gli ID dei modelli usano un formato senza data:

claude-{name}-{major}[-{minor}]

Le release di versione maggiore come Claude Sonnet 5 e Claude Opus 5 omettono il segmento minore.

Per esempio: claude-sonnet-4-6, claude-sonnet-5, claude-opus-4-6, claude-opus-4-7, claude-opus-4-8 e claude-opus-5

Su Amazon Bedrock, il formato corrispondente è:

anthropic.claude-{name}-{major}[-{minor}]

Per esempio: anthropic.claude-sonnet-4-6, anthropic.claude-sonnet-5, anthropic.claude-opus-4-7, anthropic.claude-opus-4-8, anthropic.claude-opus-5

Claude Opus 4.6 è l'ultimo ID di modello Bedrock a includere il suffisso -v1 (anthropic.claude-opus-4-6-v1). Anthropic ha eliminato il suffisso a partire da Claude Sonnet 4.6.

Su Google Cloud, il formato corrisponde a quello dell'API di Claude.



Prima della generazione 4.6

I modelli precedenti alla generazione 4.6 includono una data di snapshot nell'ID:

claude-{name}-{major}-{minor}-{YYYYMMDD}

Per esempio: claude-sonnet-4-5-20250929, claude-haiku-4-5-20251001

Su Amazon Bedrock, questi usano il formato:

anthropic.claude-{name}-{major}-{minor}-{YYYYMMDD}-v1:0

Per esempio: anthropic.claude-sonnet-4-5-20250929-v1:0

Su Google Cloud, la data è separata con @:

claude-{name}-{major}-{minor}@{YYYYMMDD}

Per esempio: claude-haiku-4-5@20251001

Sull'API di Claude, questi modelli hanno anche alias più brevi (per esempio, claude-sonnet-4-5) che puntano allo snapshot datato più recente per quella versione minore.



Gli ID senza data sono snapshot fissati

Un'idea errata comune è che gli ID di modello senza data come claude-sonnet-4-6 si comportino come puntatori sempreverdi che instradano verso la versione più recente o con le migliori prestazioni. Non è così.

Per la generazione 4.6 e successive, l'ID senza data è l'ID di modello canonico per quella release. Corrisponde a un singolo snapshot fisso del modello. Anthropic non aggiorna i pesi o la configurazione di un ID di modello esistente. Quando è disponibile una versione aggiornata, viene rilasciata con un nuovo ID di modello.

Questo è diverso dagli alias senza data che esistono sull'API di Claude per i modelli precedenti. Un alias come claude-sonnet-4-5 è un puntatore di convenienza che si risolve nello snapshot datato più recente per quella versione minore. Un ID della generazione 4.6 come claude-sonnet-4-6 non è un alias. È lo snapshot.

Ogni ID di modello, datato o senza data, ha il proprio calendario distinto di deprecazione e ritiro.



Pesi del modello rispetto all'infrastruttura di serving

I pesi del modello sono fissi per un dato ID, ma l'infrastruttura di serving attorno al modello può cambiare nel tempo. Questa infrastruttura include componenti come il router delle richieste, i classificatori di sicurezza e la logica di campionamento.

Occasionalmente, gli aggiornamenti dell'infrastruttura producono piccole differenze nel comportamento osservabile anche quando l'ID del modello e i pesi non sono cambiati. Se noti differenze comportamentali inattese su un ID di modello precedentemente stabile, un aggiornamento dell'infrastruttura è la causa più probabile.



ID dei modelli attuali

Per l'elenco completo degli ID dei modelli attuali e dei loro equivalenti su Amazon Bedrock e Google Cloud, consulta la Panoramica dei modelli.