IDs de modelo e versionamento

Cada ID de modelo do Claude identifica uma versão fixa do modelo. Quando você usa um ID de modelo em uma requisição de API, o modelo subjacente permanece constante durante toda a vida útil desse ID. Essa garantia se aplica aos IDs de modelo, não aos aliases de conveniência que a API do Claude aceita para alguns modelos anteriores (consulte Antes da geração 4.6).

Formato do ID de modelo

Os IDs de modelo do Claude seguem um esquema de nomenclatura versionado.

A geração 4.6 e posteriores

A partir da geração Claude 4.6, os IDs de modelo usam um formato sem data:

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

Por exemplo: claude-sonnet-4-6, claude-opus-4-6, claude-opus-4-7 e claude-opus-4-8

No Amazon Bedrock, o formato correspondente é:

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

Por exemplo: anthropic.claude-sonnet-4-6, anthropic.claude-opus-4-7, anthropic.claude-opus-4-8

Claude Opus 4.6 é o último ID de modelo do Bedrock a incluir o sufixo -v1 (anthropic.claude-opus-4-6-v1). A Anthropic removeu o sufixo a partir do Claude Sonnet 4.6.

No Google Cloud Vertex AI, o formato corresponde ao da API do Claude.

Antes da geração 4.6

Modelos anteriores à geração 4.6 incluem uma data de snapshot no ID:

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

Por exemplo: claude-sonnet-4-5-20250929, claude-haiku-4-5-20251001

No Amazon Bedrock, esses modelos usam o formato:

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

Por exemplo: anthropic.claude-sonnet-4-5-20250929-v1:0

No Google Cloud Vertex AI, a data é separada por @:

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

Por exemplo: claude-haiku-4-5@20251001

Na API do Claude, esses modelos também têm aliases mais curtos (por exemplo, claude-sonnet-4-5) que apontam para o snapshot datado mais recente daquela versão secundária.

IDs sem data são snapshots fixos

Um equívoco comum é que IDs de modelo sem data, como claude-sonnet-4-6, se comportam como ponteiros perenes que direcionam para a versão mais recente ou de melhor desempenho. Esse não é o caso.

Para a geração 4.6 e posteriores, o ID sem data é o ID de modelo canônico para aquele lançamento. Ele mapeia para um único snapshot fixo do modelo. A Anthropic não atualiza os pesos ou a configuração de um ID de modelo existente. Quando uma versão atualizada está disponível, ela é lançada sob um novo ID de modelo.

Isso difere dos aliases sem data que existem na API do Claude para modelos anteriores. Um alias como claude-sonnet-4-5 é um ponteiro de conveniência que resolve para o snapshot datado mais recente daquela versão secundária. Um ID da geração 4.6, como claude-sonnet-4-6, não é um alias. Ele é o snapshot.

Cada ID de modelo, seja datado ou sem data, tem seu próprio cronograma distinto de descontinuação e desativação.

Pesos do modelo versus infraestrutura de serviço

Os pesos do modelo são fixos para um determinado ID, mas a infraestrutura de serviço em torno do modelo pode mudar ao longo do tempo. Essa infraestrutura inclui componentes como o roteador de requisições, classificadores de segurança e lógica de amostragem.

Ocasionalmente, atualizações de infraestrutura produzem pequenas diferenças no comportamento observável, mesmo quando o ID do modelo e os pesos não mudaram. Se você notar diferenças comportamentais inesperadas em um ID de modelo anteriormente estável, uma atualização de infraestrutura é a causa mais provável.

IDs de modelo atuais

Para a lista completa de IDs de modelo atuais e seus equivalentes no Amazon Bedrock e no Google Cloud Vertex AI, consulte Visão geral dos modelos.