ID dei modelli e versionamento

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



Formato dell'ID del modello

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 utilizzano un formato senza data:

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

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

Su Amazon Bedrock, il formato corrispondente è:

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

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

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 Vertex AI, il formato corrisponde a quello della Claude API.



Prima della generazione 4.6

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

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

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

Su Amazon Bedrock, questi utilizzano il formato:

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

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

Su Google Cloud Vertex AI, la data è separata da @:

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

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

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



Gli ID senza data sono snapshot fissati

Un malinteso comune è che gli ID di modello senza data come claude-sonnet-4-6 si comportino come puntatori "evergreen" (sempre aggiornati) che indirizzano alla versione più recente o più performante. Non è così.

Per la generazione 4.6 e successive, l'ID senza data è l'ID canonico del modello 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 differisce dagli alias senza data che esistono sulla Claude API per i modelli precedenti. Un alias come claude-sonnet-4-5 è un puntatore di comodità 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 stesso.

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



Pesi del modello e infrastruttura di serving

I pesi del modello sono fissi per un determinato 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 differenze minori nel comportamento osservabile anche quando l'ID del modello e i pesi non sono cambiati. Se noti differenze comportamentali inaspettate su un ID di modello precedentemente stabile, la causa più probabile è un aggiornamento dell'infrastruttura.



ID dei modelli attuali

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