IDs de modelo e versionamento

Cada ID de modelo do Claude identifica uma versão fixada do modelo. Quando você usa um ID de modelo em uma requisição à API, o modelo subjacente permanece constante durante toda a vida útil desse ID. Essa garantia cobre os IDs de modelo, não os aliases de conveniência que a Claude API 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}]

Lançamentos de versão principal, como Claude Sonnet 5 e Claude Opus 5, omitem o segmento de versão secundária.

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

No Amazon Bedrock, o formato correspondente é:

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

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

O 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, o formato corresponde ao da Claude API.

Antes da geração 4.6

Os 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, eles usam o formato:

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

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

No Google Cloud, a data é separada com @:

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

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

Na Claude API, 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 fixados

Um equívoco comum é achar que IDs de modelo sem data, como claude-sonnet-4-6, se comportam como ponteiros "evergreen" (sempre atualizados) que direcionam para a versão mais recente ou de melhor desempenho. Não é esse o caso.

Para a geração 4.6 e posteriores, o ID sem data é o ID de modelo canônico daquele lançamento. Ele corresponde a um único snapshot fixo do modelo. A Anthropic não atualiza os pesos nem 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 Claude API 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 "model weights" (pesos do modelo) são fixos para um determinado ID, mas a "serving infrastructure" (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, consulte Visão geral dos modelos.