Vigilancia de obsolescencia y migración
Los modelos se retiran, los parámetros se renombran, los comportamientos cambian. Esta página realiza el seguimiento de los cambios incompatibles para que las actualizaciones no te sorprendan. Si construyes sobre la API, revísala periódicamente.
Por qué esto importa
Un ID de modelo fijado acabará quedando obsoleto y luego será eliminado. El código que lo codifica a mano se rompe. Un poco de higiene evita sorpresas a las 2 de la madrugada.
Reglas de supervivencia
- Lee los IDs de modelo desde la configuración, nunca repartas literales por el código — así migrar es un cambio de una sola línea.
- Vigila los anuncios para conocer las fechas de obsolescencia y los reemplazos recomendados.
- Vuelve a ejecutar tus evals cuando cambies de modelo — el comportamiento puede variar incluso en un modelo "más nuevo y mejor".
- Prueba antes de la fecha límite, no después de la eliminación.
Tipos comunes de cambio
| Cambio | Ejemplo | Qué hacer |
|---|---|---|
| Modelo retirado | Un ID de modelo antiguo deja de funcionar | Pasa al sucesor recomendado; vuelve a evaluar |
| Parámetro sustituido | Un control de razonamiento/presupuesto reemplazado por effort | Actualiza las llamadas; consulta Pensamiento y esfuerzo |
| Cambio de predeterminado | Un nuevo modelo/comportamiento predeterminado | Fija el modelo de forma intencionada; verifica que tus prompts siguen funcionando |
| Actualización de endpoint/SDK | Nueva versión mayor del SDK | Lee la guía de migración; actualiza de forma deliberada |
Vigilancia actual
El calendario autorizado vive en la página oficial de obsolescencia de modelos — confirma las fechas ahí antes de migrar. Anthropic da al menos 60 días de aviso antes de retirar un modelo publicado.
Modelos obsoletos
| ID de modelo | Obsoleto | Se retira | Migra a |
|---|---|---|---|
claude-opus-4-1-20250805 (Opus 4.1) | 5 de junio de 2026 | 5 de agosto de 2026 | claude-opus-4-8 |
Las solicitudes a un modelo después de su fecha de retiro fallan — si has fijado Opus 4.1, migra antes de la fecha límite.
Retirados recientemente
claude-opus-4-20250514 (Opus 4) y claude-sonnet-4-20250514 (Sonnet 4) fueron retirados el 15 de junio de 2026. Las llamadas a esos IDs ahora dan error — migra a claude-opus-4-8 y claude-sonnet-5 respectivamente.
Obsolescencia de parámetros
En Claude Opus 4.7 y posteriores (incluido Opus 4.8), los controles de muestreo temperature, top_p y top_k están obsoletos: asignar a cualquiera de ellos un valor distinto del predeterminado devuelve un error 400. Omítelos y dirige el comportamiento con prompting y Pensamiento y esfuerzo en su lugar.
Confirma siempre tus IDs de modelo contra la tabla Modelos y precios actuales; si estás en un ID antiguo, planifica una migración.