IDs de modelo y versionado

Cada ID de modelo de Claude identifica una versión fija del modelo. Cuando usas un ID de modelo en una solicitud de API, el modelo subyacente permanece constante durante toda la vida útil de ese ID. Esta garantía cubre los IDs de modelo, no los alias de conveniencia que la API de Claude acepta para algunos modelos anteriores (consulta Antes de la generación 4.6).

Formato del ID de modelo

Los IDs de modelo de Claude siguen un esquema de nomenclatura versionado.

La generación 4.6 y posteriores

A partir de la generación Claude 4.6, los IDs de modelo usan un formato sin fecha:

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

Por ejemplo: claude-sonnet-4-6, claude-opus-4-6, claude-opus-4-7 y claude-opus-4-8

En Amazon Bedrock, el formato correspondiente es:

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

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

Claude Opus 4.6 es el último ID de modelo de Bedrock que incluye el sufijo -v1 (anthropic.claude-opus-4-6-v1). Anthropic eliminó el sufijo a partir de Claude Sonnet 4.6.

En Google Cloud Vertex AI, el formato coincide con el de la API de Claude.

Antes de la generación 4.6

Los modelos anteriores a la generación 4.6 incluyen una fecha de "snapshot" (instantánea) en el ID:

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

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

En Amazon Bedrock, estos usan el formato:

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

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

En Google Cloud Vertex AI, la fecha se separa con @:

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

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

En la API de Claude, estos modelos también tienen alias más cortos (por ejemplo, claude-sonnet-4-5) que apuntan a la instantánea con fecha más reciente de esa versión menor.

Los IDs sin fecha son instantáneas fijas

Un error común es pensar que los IDs de modelo sin fecha como claude-sonnet-4-6 se comportan como punteros "evergreen" (siempre actualizados) que dirigen a la versión más reciente o de mejor rendimiento. Ese no es el caso.

Para la generación 4.6 y posteriores, el ID sin fecha es el ID de modelo canónico de esa versión. Se asigna a una única instantánea fija del modelo. Anthropic no actualiza los pesos ni la configuración de un ID de modelo existente. Cuando hay una versión actualizada disponible, se publica bajo un nuevo ID de modelo.

Esto difiere de los alias sin fecha que existen en la API de Claude para modelos anteriores. Un alias como claude-sonnet-4-5 es un puntero de conveniencia que se resuelve a la instantánea con fecha más reciente de esa versión menor. Un ID de la generación 4.6 como claude-sonnet-4-6 no es un alias. Es la instantánea.

Cada ID de modelo, ya sea con fecha o sin fecha, tiene su propio calendario de obsolescencia y retiro.

Pesos del modelo versus infraestructura de servicio

Los pesos del modelo son fijos para un ID determinado, pero la infraestructura de servicio que rodea al modelo puede cambiar con el tiempo. Esta infraestructura incluye componentes como el enrutador de solicitudes, los clasificadores de seguridad y la lógica de muestreo.

Ocasionalmente, las actualizaciones de infraestructura producen diferencias menores en el comportamiento observable incluso cuando el ID de modelo y los pesos no han cambiado. Si notas diferencias de comportamiento inesperadas en un ID de modelo que antes era estable, la causa más probable es una actualización de infraestructura.

IDs de modelo actuales

Para ver la lista completa de IDs de modelo actuales y sus equivalentes en Amazon Bedrock y Google Cloud Vertex AI, consulta Descripción general de los modelos.