Todos los nombres de modelos de la API de Anthropic: IDs actuales de Claude y alias

Si buscaste todos los nombres de modelos de la API de Anthropic, la respuesta más rápida es esta: los nombres de visualización de Claude, los IDs de modelo actuales y las instantáneas con fecha son etiquetas que parecen válidas, pero solo el identificador exacto de la API pertenece al campo model. Anthropic utiliza nombres legibles para humanos en las páginas de producto, IDs de modelo con fecha para llamadas API reproducibles y alias para actualizaciones convenientes. Esos valores están relacionados, pero no son intercambiables.

La regla práctica es simple: usa un ID de modelo exacto cuando necesites un comportamiento repetible, usa un alias cuando quieras intencionadamente que Anthropic te mueva a una instantánea más nueva, y nunca copies un nombre de marketing en una solicitud API sin verificar primero la lista oficial de modelos.

Si tu siguiente paso es el formato de la solicitud en lugar del esquema de nombres, combina esta guía con la Documentación de la API de Messages de Anthropic. Si estás eligiendo un flujo de trabajo de codificación orientado a Claude, Modelos compatibles con Claude Code es el mejor siguiente paso.

¿Qué es un nombre de modelo de la API de Anthropic?

Un nombre de modelo de la API de Anthropic es el identificador enviado en el parámetro model de una solicitud a la API de Messages. Le indica a Anthropic qué familia de Claude e instantánea debe procesar la solicitud.

Estas tres formas son fáciles de confundir:

Tipo de valor	Ejemplo	Mejor uso
Nombre de visualización	Claude Sonnet	Documentación, interfaz de producto, conversaciones con lectores no técnicos
ID de modelo actual	claude-sonnet-5	Nuevas integraciones que usan un modelo listado en la página de modelos actuales de Anthropic
ID de modelo con fecha	claude-haiku-4-5-20251001	Pruebas, flujos de trabajo regulados, evaluaciones e implementaciones en producción que requieren reproducibilidad

El catálogo exacto cambia con el tiempo. Considera la página de modelos actuales de Anthropic y la página de desaprobación de modelos como la fuente de verdad, en lugar de codificar una lista copiada de un tutorial antiguo.

Nombres de modelos Claude frente a IDs de modelos Claude

Los nombres de modelos Claude están optimizados para personas. “Claude Sonnet” comunica el nivel del producto, mientras que “Claude Haiku” sugiere el nivel más rápido y de menor costo. La API necesita un valor más preciso porque una familia puede tener múltiples instantáneas, reglas de disponibilidad regional y fechas de retiro.

Un ID con fecha generalmente incluye:

1. La familia Claude, como opus, sonnet o haiku.
2. La generación principal del modelo.
3. Una fecha de lanzamiento en formato YYYYMMDD.

Por ejemplo, claude-haiku-4-5-20251001 identifica la instantánea de Haiku 4.5 lanzada el 1 de octubre de 2025. La fecha es parte del identificador; no es una marca de tiempo de solicitud y no debe reemplazarse con la fecha actual.

Algunos catálogos de modelos también exponen identificadores de nivel de familia más cortos. Son convenientes cuando deseas un modelo compatible sin gestionar tú mismo una instantánea con fecha. La compensación es que un puntero gestionado por el proveedor puede cambiar el comportamiento después de una actualización, así que verifica la semántica del ID exacto que aparece en el catálogo actual de Anthropic.

IDs de modelo Claude comunes que puedes encontrar

Los siguientes IDs de API estaban listados como activos en la página de modelos actuales de Anthropic al 24 de julio de 2026. Esta tabla es una orientación puntual, no un registro permanente. Verifica la documentación de Anthropic antes de usar cualquier ID en una nueva implementación.

Familia Claude	ID actual de API	Rol típico
Claude Opus 4.8	claude-opus-4-8	Razonamiento complejo y análisis de alto riesgo
Claude Sonnet 5	claude-sonnet-5	Cargas de trabajo de producción de uso general
Claude Haiku 4.5	claude-haiku-4-5-20251001	Clasificación rápida, extracción y respuestas cortas
Claude Opus 4.7	claude-opus-4-7	Integraciones de Opus de generación reciente que no han migrado a 4.8
Claude Sonnet 4.6	claude-sonnet-4-6	Integraciones de Sonnet de generación reciente que no han migrado a Sonnet 5

Estos son identificadores, no garantías de que un modelo esté disponible en todas las cuentas de Anthropic. Incluso un ID actualmente listado puede fallar debido a permisos de cuenta, región, cuota o un cambio posterior en el ciclo de vida. Los IDs con fecha son reproducibles mientras sean compatibles, pero eventualmente también se retiran.

Cómo elegir entre Opus, Sonnet y Haiku

Elige según la carga de trabajo, no según el nombre más largo:

• Opus: Úsalo cuando el razonamiento difícil, la síntesis de formato largo o las decisiones de herramientas matizadas justifiquen una mayor latencia o costo.
• Sonnet: Empieza aquí para la mayoría de asistentes de producción, flujos de trabajo de codificación y generación estructurada. Suele ser la línea de base práctica entre calidad y latencia.
• Haiku: Úsalo para enrutamiento de alto volumen, extracción, moderación, reescrituras cortas y otras tareas donde el tiempo de respuesta importa más que la profundidad máxima de razonamiento.

Realiza una pequeña evaluación con indicaciones representativas antes de cambiar de familia. Incluye entradas mal formadas, contexto largo, llamadas a herramientas, salida JSON y el comportamiento de respaldo que usa tu aplicación cuando una solicitud falla. Un nombre de modelo que parece un reemplazo directo puede cambiar el formato de las llamadas a herramientas o el comportamiento en casos límite.

Usa el ID del modelo en una solicitud a la API de Messages

El valor de model pertenece al cuerpo JSON. Es independiente del encabezado de versión de la API y del modelo que se muestra en la aplicación web de Claude.

curl https://api.anthropic.com/v1/messages \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-sonnet-5",
    "max_tokens": 512,
    "messages": [
      {
        "role": "user",
        "content": "Explica por qué los IDs de modelo de la API deben fijarse en producción."
      }
    ]
  }'

El encabezado anthropic-version describe el contrato de la API. No selecciona el modelo Claude. Mantén esos dos ajustes independientes en tu configuración para que una actualización de la librería del cliente no cambie silenciosamente el enrutamiento del modelo.

Para el uso del SDK, establece el mismo identificador a través del método de creación de mensajes del cliente y mantenlo en un valor de configuración específico del entorno. No pongas una clave de API o un ID de modelo en un paquete del navegador; el enrutamiento del lado del servidor es más fácil de asegurar y probar.

Por qué un ID de modelo de API puede dejar de funcionar

Una respuesta invalid_request_error o “modelo no encontrado” generalmente cae en una de estas categorías:

Se usó el nombre de visualización en lugar del ID

Claude Sonnet es una etiqueta útil pero no un valor de solicitud confiable. Reemplázalo con un ID o alias listado en la documentación del proveedor.

La instantánea fue desaprobada

Los IDs con fecha son reproducibles solo mientras el proveedor los soporte. Monitorea el calendario de desaprobación, establece una fecha límite de migración y prueba el reemplazo antes de la fecha de retiro.

La cuenta no puede acceder al modelo

Un identificador válido puede no estar disponible debido a permisos de cuenta, región, cuota o una política de la organización. Verifica el cuerpo de la respuesta y la configuración de la cuenta en lugar de cambiar la indicación.

El enrutador espera un nombre específico del proveedor

Las puertas de enlace y las API compatibles con OpenAI pueden normalizar los nombres de los modelos de manera diferente. Anthropic actualmente documenta claude-sonnet-5, mientras que otro proveedor puede exponer un valor con espacio de nombres o un alias propio del proveedor. Usa el catálogo de modelos de la puerta de enlace y no asumas que un ID de Claude es portable a través de todos los endpoints.

Uso de flujos de trabajo tipo Claude a través de un endpoint compatible

Si tu aplicación ya utiliza la forma del cliente de OpenAI, una capa de compatibilidad puede reducir el trabajo de migración. La API LLM de Novita proporciona un endpoint compatible con OpenAI para enrutar modelos de código abierto compatibles a través de una forma familiar de solicitud de chat-completions.

Eso no significa que cada ID de modelo Claude esté automáticamente disponible allí. Mantén el enrutamiento del proveedor explícito:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["NOVITA_API_KEY"],
    base_url="https://api.novita.ai/v3/openai",
)

response = client.chat.completions.create(
    model="moonshotai/kimi-k2.5",
    messages=[
        {"role": "user", "content": "Resume este ticket de soporte en tres viñetas."}
    ],
)

print(response.choices[0].message.content)

El patrón de diseño importante es un mapa proveedor/modelo, no una única cadena global:

MODELS = {
    "anthropic": "claude-sonnet-5",
    "novita": "moonshotai/kimi-k2.5",
}

Esto te permite evaluar un modelo Claude frente a una alternativa de código abierto sin reescribir la lógica de negocio. Antes de cambiar, compara la salida estructurada, las llamadas a herramientas, el manejo del contexto, la latencia y los modos de fallo—no solo el nombre de visualización o el titular de referencia.

IDs de modelo en backends de agentes y entornos aislados

Un agente generalmente llama a un modelo muchas veces: planificación, selección de herramientas, reparación de código y respuesta final. Coloca el identificador del modelo en la configuración del backend, no en los argumentos de herramientas controlados por el usuario. Registra el proveedor seleccionado y el ID del modelo con cada ejecución para que una evaluación pueda reproducirse más tarde.

Cuando un agente ejecuta código generado, mantén el enrutamiento del modelo separado del entorno de ejecución. Un Agente Sandbox gestionado puede aislar archivos, paquetes y comandos, mientras que la configuración de la API LLM permanece en el servicio del agente. Esta separación hace posible cambiar un alias de modelo o probar una instantánea fijada sin cambiar la imagen del sandbox.

Para agentes de producción, agrega tres salvaguardas:

1. Valida el modelo configurado al inicio con una pequeña solicitud autenticada o verificación del catálogo del proveedor.
2. Mantén un ID de respaldo probado y haz que la activación del respaldo sea visible en la telemetría.
3. Almacena el ID del modelo, la versión de la API, la versión de la indicación y el esquema de la herramienta junto con los resultados de la evaluación.

Preguntas frecuentes

¿Cuál es el nombre correcto del modelo Claude para la API?

Usa el ID de modelo exacto listado en la documentación actual de Anthropic, como claude-sonnet-5 o el con fecha claude-haiku-4-5-20251001. No uses un nombre de visualización como “Claude Sonnet” por sí solo.

¿Es mejor un ID de modelo con fecha que un alias?

Ninguno es siempre mejor. Un ID con fecha es preferible para la reproducibilidad y los despliegues controlados. Un alias es preferible cuando deseas un puntero de familia mantenido y tienes pruebas de regresión para las actualizaciones del proveedor.

¿Puedo usar IDs de modelo de Anthropic con una API compatible con OpenAI?

Solo si ese endpoint admite y documenta explícitamente el ID. Compatible con OpenAI describe la interfaz de solicitud; no promete catálogos de modelos idénticos. Verifica los modelos compatibles del endpoint y usa su nombre de enrutamiento exacto.

¿Cómo evito que una desaprobación de modelo rompa mi aplicación?

Fija un ID probado, monitorea los avisos de desaprobación de Anthropic, prueba el reemplazo antes de la fecha de retiro y mantén el valor del modelo en la configuración para que puedas cambiarlo sin enviar cambios en la lógica de negocio.

Artículos recomendados

• Simplificando la integración de API LLM para desarrolladores
• La mejor plataforma de API LLM para cambiar de proveedor
• ¿Qué es un Agente Sandbox de IA?

Fuentes

• Anthropic: Resumen de modelos
• Anthropic: Referencia de API de modelos
• Anthropic: Referencia de API de Messages
• Anthropic: Desaprobaciones de modelos
• Novita AI: API LLM