Nota del autor: claude-sonnet-4-5 dejará de estar disponible el 2026-11-30. Este artículo explica qué cambia en el ID del modelo, el multiplicador de lectura de caché y la facturación al migrar a claude-sonnet-5-5. También incluye una lista de campos que revisar y un método de validación para el día del cambio.
Si en tu código, archivos de configuración o rutas de la puerta de enlace todavía aparece claude-sonnet-4-5 o la instantánea con fecha claude-sonnet-4-5-20250929, tendrás que planificar la migración cuanto antes. La página de retirada de modelos de Anthropic ya marca esta instantánea como obsoleta. El anuncio se publicó el 2026-09-30 y la fecha de retirada es el 2026-11-30. El modelo de reemplazo indicado oficialmente es claude-sonnet-5-5.
Este no es otro artículo promocional sobre cómo «el nuevo modelo es mejor». Aquí solo abordamos los pasos de ingeniería para migrar de Sonnet 4.5 a Sonnet 5.5: cómo cambiar el ID del modelo, qué cambios hay en los multiplicadores y los precios, qué campos actualizar el día del cambio y cómo validar la migración. Las diferencias de capacidad quedan fuera del alcance de este artículo; tendrás que comprobarlas con las pruebas de regresión de tus propias tareas.
Valor principal: al terminar de leer, tendrás una tabla comparativa de los modelos antiguo y nuevo, una secuencia de cambio que podrás ejecutar y sabrás qué solicitud enviar y qué campos revisar para confirmar que la migración se completó correctamente.
Puntos clave para la retirada de Sonnet 4.5 y la migración a Sonnet 5.5
Empecemos por la conclusión. La tabla siguiente resume los cuatro aspectos más importantes de esta migración. Los datos corresponden al 10 de noviembre de 2026.
| Aspecto | Descripción | Impacto |
|---|---|---|
| Fecha de retirada | claude-sonnet-4-5-20250929 se retirará el 30 de noviembre de 2026. El anuncio se publicó el 30 de septiembre de 2026. |
Quedan unos 20 días. Hay que completar el cambio antes de fin de mes. |
| Modelo de reemplazo oficial | Anthropic recomienda sustituirlo por claude-sonnet-5-5. |
El destino de la migración está claro; no hace falta elegir entre varios modelos. |
| Ambos modelos siguen disponibles | Por ahora, los modelos nuevo y anterior aparecen en la lista de modelos de la plataforma. | Puedes ejecutarlos en paralelo durante un tiempo para hacer una migración gradual y pruebas de regresión. |
| Cambios en los precios y los multiplicadores de caché | Bajan los precios unitarios de entrada, salida y lectura de caché. El multiplicador de lectura de caché pasa de 0,1 a 0,05. | La factura cambiará; el impacto será mayor en los servicios con una alta tasa de aciertos de caché. |
Sonnet 4.5 y Sonnet 5.5 siguen disponibles
No hace falta hacer un cambio «de golpe». El 10 de noviembre de 2026, consultamos la API pública de precios de APIYI (apiyi.com): de los 283 modelos listados, estaban disponibles tanto claude-sonnet-4-5 como claude-sonnet-4-5-20250929, además de claude-sonnet-5-5 y claude-sonnet-5-5-thinking. Como los modelos nuevo y anterior están disponibles al mismo tiempo, puedes usar la misma clave API y la misma interfaz compatible con OpenAI para trasladar el tráfico gradualmente al nuevo ID antes de la fecha de retirada.
Ten en cuenta que en el código suelen aparecer en distintos lugares la versión fechada claude-sonnet-4-5-20250929 y la versión sin fecha claude-sonnet-4-5. La primera suele usarse en scripts de evaluación offline que buscan resultados reproducibles; la segunda, en código de producción y centros de configuración. Durante la migración, busca ambas variantes: no cambies solo una.
La variante thinking durante la migración a Sonnet 5.5
claude-sonnet-5-5-thinking figura como una entrada independiente en la API de precios y tiene su propio multiplicador. Si tu servicio ya distingue entre «invocaciones normales» e «invocaciones de razonamiento profundo», asigna cada caso por separado durante la migración. No mezcles el precio de la variante thinking con el del modelo base claude-sonnet-5-5. El cálculo de precios que aparece más adelante en este artículo solo se aplica al modelo base; para la variante thinking, consulta la entrada correspondiente en la lista de modelos de la plataforma.
Correspondencia de ID de modelo: Sonnet 4.5 y Sonnet 5.5
El primer paso de la migración es crear una tabla de correspondencias entre los ID. La siguiente tabla muestra la forma anterior y la nueva forma recomendada:
| Forma actual | Estado | Forma después de la migración | Notas |
|---|---|---|---|
claude-sonnet-4-5-20250929 |
Obsoleto; se retirará el 2026-11-30 | claude-sonnet-5-5 |
Reemplazo recomendado oficialmente |
claude-sonnet-4-5 |
Sigue en la lista; conviene migrarlo junto con la versión fechada | claude-sonnet-5-5 |
La forma más habitual en el código de negocio |
| Llamadas a Sonnet 4.5 construidas manualmente para tareas de razonamiento | Hay que revisarlas una por una | claude-sonnet-5-5-thinking |
Entrada independiente, con precio propio |
Conviene centralizar esta correspondencia, por ejemplo, en un centro de configuración o en variables de entorno, en lugar de codificarla por separado en varios servicios. Así, solo habrá que cambiarla en un lugar cuando llegue la fecha de retirada, y también será más fácil revertir el cambio.
Cambios de precio y de multiplicador de lectura de caché tras migrar a Sonnet 5.5
Criterios para convertir los multiplicadores
La API de precios no devuelve precios en dólares, sino tres campos de multiplicador: model_ratio (multiplicador de entrada), completion_ratio (multiplicador de salida con respecto a la entrada) y cache_ratio (multiplicador de lectura de caché con respecto a la entrada). Para las conversiones de este artículo, se usa el mismo criterio que en los artículos publicados anteriormente en la plataforma:
- Multiplicador 1 = 2 dólares por cada millón de tokens de entrada
- Precio de salida = precio de entrada ×
completion_ratio - Precio de lectura de caché = precio de entrada ×
cache_ratio
Los precios en dólares de la tabla se han calculado con los criterios anteriores; no son los precios de lista oficiales. Datos del 2026-11-10.
| Modelo | model_ratio | completion_ratio | cache_ratio | Entrada $/millón de tokens | Salida $/millón de tokens | Lectura de caché $/millón de tokens |
|---|---|---|---|---|---|---|
claude-sonnet-4-5 |
1.5 | 5 | 0.1 | $3 | $15 | $0.30 |
claude-sonnet-5-5 |
1 | 5 | 0.05 | $2 | $10 | $0.10 |
Cómo interpretar el cambio en el multiplicador de lectura de caché de Sonnet 5.5
La tabla muestra dos cambios. El primero afecta a los multiplicadores base: model_ratio baja de 1.5 a 1 y completion_ratio se mantiene en 5. Por eso, los precios de entrada y salida bajan aproximadamente un tercio. El segundo cambio afecta a la lectura de caché: cache_ratio baja de 0.1 a 0.05. Al sumarse a la reducción del multiplicador base, el precio de lectura de caché pasa de $0.30 a $0.10, una bajada de aproximadamente dos tercios.
Esto significa que el cambio en la factura no será igual para todos los negocios, aunque se migre el mismo ID de modelo. En escenarios con una alta tasa de aciertos de caché, como los que usan indicaciones de sistema largas, preguntas y respuestas sobre documentos extensos o agentes con varias interacciones, la lectura de caché representa una parte importante de la factura. Por eso, el cambio total puede ser más notable que en negocios centrados únicamente en entradas y salidas. Al preparar el presupuesto, no apliques un único porcentaje de reducción a todos los casos.
Ejemplo de cambio en la factura (uso hipotético)
A continuación, se utiliza un volumen mensual hipotético para mostrar cómo influyen los tres conceptos en la factura. Las cifras son solo un ejemplo del método de cálculo; sustitúyelas por tus propias estadísticas de uso.
| Concepto facturado | Uso mensual hipotético | Coste calculado con Sonnet 4.5 | Coste calculado con Sonnet 5.5 |
|---|---|---|---|
| Entrada | 10 millones de tokens | $30 | $20 |
| Salida | 2 millones de tokens | $30 | $20 |
| Lectura de caché | 30 millones de tokens | $9 | $3 |
| Total | — | $69 | $43 |
Además, la caché de indicaciones suele estar aislada por modelo. Al cambiar al nuevo ID, la caché acumulada con el modelo anterior no se reutiliza automáticamente, así que las primeras solicitudes volverán a escribirla. Por ello, la tasa de aciertos de caché puede ser temporalmente baja el día del cambio y la factura puede fluctuar un poco. Para comparar las facturas, se recomienda esperar unas horas después de la migración.
Antes y después del cambio, vuelve a comprobar los multiplicadores actuales de claude-sonnet-5-5 y claude-sonnet-5-5-thinking en la lista de modelos de APIYI apiyi.com, y actualiza los resultados en la hoja interna de previsión de costes y en los umbrales de alerta.
Guía rápida para migrar de Sonnet 4.5 a Sonnet 5.5
Ejemplo de solicitud mínima
Para llamar al nuevo modelo con una interfaz compatible con OpenAI, solo tienes que tener en cuenta estos campos:
- Dirección de la interfaz base_url:
https://api.apiyi.com/v1 - Ruta de la solicitud:
/chat/completions - Campo del modelo model:
claude-sonnet-5-5(sustituye aclaude-sonnet-4-5oclaude-sonnet-4-5-20250929) - Autenticación: encabezado de la solicitud
Authorization: Bearer YOUR_API_KEY - Cuerpo del mensaje: conserva
messagestal como está; no hace falta modificarlo durante la migración
Si usas el SDK oficial de OpenAI, normalmente solo tienes que cambiar base_url al inicializar el cliente y el parámetro model al hacer la llamada. El resto del código de tu aplicación puede quedarse igual.
Ver la lista completa de campos que debes cambiar
El día del cambio, confirma uno por uno estos puntos:
– Inicialización del cliente: unifica `base_url` como `https://api.apiyi.com/v1` y lee la clave API desde una variable de entorno
– Modelo predeterminado: cambia a `claude-sonnet-5-5` el `model` configurado en el centro de configuración o en las variables de entorno
– Enrutamiento de inferencia: cambia a `claude-sonnet-5-5-thinking` las rutas que antes usaban razonamiento profundo; este modelo tiene una tarifa independiente
– Lista de alternativas: si `claude-sonnet-4-5` aparece en la lista de fallback o en la cadena de reintentos, sustitúyelo también para evitar errores cuando deje de estar disponible
– Lista blanca y permisos: añade el nuevo ID a la lista blanca de modelos de la puerta de enlace y a la lista de modelos disponibles para los miembros del equipo
– Costos y alertas: actualiza la tabla de precios unitarios y los umbrales de las alertas de presupuesto según las nuevas tarifas
– Registros e informes: en los paneles que calculan el uso según el campo `model`, agrupa los ID nuevos y antiguos en la misma línea de negocio para evitar interrupciones en los informes tras el cambio
– Scripts de evaluación sin conexión: actualiza el ID en las tareas de evaluación que usan la instantánea fechada `claude-sonnet-4-5-20250929` y vuelve a ejecutar la línea base
Recomendación para empezar: En el entorno de pruebas, usa la misma clave de API de APIYI para llamar tanto al modelo nuevo como al anterior. Registra las diferencias en las respuestas y el uso antes de decidir el porcentaje del despliegue gradual. Si eres un usuario nuevo, puedes empezar con el saldo de prueba gratuito y ejecutar las pruebas de regresión.
Secuencia recomendada de migración en cinco pasos
- Busca globalmente los ID antiguos: busca
claude-sonnet-4-5en el código, el centro de configuración, los scripts de CI y la configuración de la puerta de enlace. Busca tanto las variantes con fecha como las que no la incluyen y recopílalas en una lista. - Comprueba el precio de los modelos nuevos: consulta la lista de modelos de la plataforma para confirmar los multiplicadores actuales de
claude-sonnet-5-5y su variante thinking. Actualiza la previsión de costes y los umbrales de alerta. - Migra una parte del tráfico de forma gradual: empieza por las operaciones no críticas o una pequeña parte de las solicitudes. Envíalas al ID nuevo y deja que el ID antiguo atienda el resto. Observa la tasa de errores y la calidad de las respuestas.
- Valida con la misma solicitud: envía solicitudes de prueba fijas a los modelos antiguo y nuevo, y comprueba que las respuestas, el uso y la facturación sean los esperados (consulta la sección siguiente).
- Completa la migración antes de retirar el modelo: termina la migración de todo el tráfico antes del 2026-11-30 y elimina el ID antiguo del código y la configuración para evitar que alguna ruta olvidada genere errores después de su retirada.
Valida la migración con la misma solicitud
La clave de la validación es usar «la misma solicitud»: fija el prompt del sistema, el mensaje del usuario y max_tokens; envíalos por separado al modelo antiguo y al nuevo y compara lo siguiente:
- Campo
modelde la respuesta: comprueba que el modelo indicado en la respuesta seaclaude-sonnet-5-5y que ningún valor predeterminado ni lógica de respaldo lo haya cambiado por otro modelo. - Campos de uso (
usage): comparaprompt_tokensycompletion_tokens. Si la respuesta incluye campos relacionados con la caché, regístralos también para comprobar si esta funciona. - Resultados de la tarea: evalúa las respuestas con tus propios criterios; por ejemplo, comprueba si la salida estructurada supera la validación JSON o si el formato de las llamadas a herramientas es correcto. Basa la evaluación de las diferencias de capacidad en las pruebas de regresión de tus tareas.
- Detalle de facturación: busca la solicitud en el historial de uso de la consola de APIYI en apiyi.com y comprueba que el cargo coincida con el nuevo multiplicador.
Al día siguiente, repite la prueba con la misma solicitud para observar también si la caché vuelve a crearse y empieza a registrar aciertos. Cuando la validación dé buenos resultados, aumenta gradualmente la proporción de tráfico migrado.
Preguntas frecuentes
Q1: ¿A qué modelo concreto se refiere la retirada de Sonnet 4.5?
La página de retirada de Anthropic incluye `claude-sonnet-4-5-20250929`, con el estado Deprecated, el anuncio fechado el 2026-09-30 y la retirada prevista para el 2026-11-30. También conviene migrar la forma `claude-sonnet-4-5`, que se usa en producción sin fecha, para evitar errores en las llamadas después de la retirada.
Q2: ¿Qué diferencias hay que tener en cuenta al migrar de Sonnet 4.5 a Sonnet 5.5?
Desde el punto de vista de ingeniería, hay tres cambios principales: el ID del modelo pasa a ser `claude-sonnet-5-5`; bajan los precios unitarios de entrada, salida y lectura de caché; y el multiplicador de lectura de caché cambia de 0.1 a 0.05. Para saber si las capacidades se ajustan a tu caso, haz pruebas de regresión con tus propias tareas; este artículo no concluye que sea un reemplazo completo.
Q3: ¿Se puede seguir llamando a claude-sonnet-4-5 antes de la fecha de retirada?
A fecha de 2026-11-10, tanto `claude-sonnet-4-5` como `claude-sonnet-4-5-20250929` siguen en la lista de modelos de la plataforma y se pueden seguir usando. Este periodo es adecuado para ejecutar en paralelo los modelos nuevos y los antiguos y compararlos, pero no es recomendable esperar al mismo día de la retirada para hacer el cambio.
Q4: ¿Qué negocios notarán más el cambio en la factura tras migrar a Sonnet 5.5?
El cambio será más evidente en los negocios con una alta proporción de lecturas de caché, por ejemplo:
– **Atención al cliente o asistentes con indicaciones de sistema largas**: cada solicitud aprovecha la caché de la misma indicación larga
– **Preguntas y respuestas sobre documentos extensos**: se consulta repetidamente el mismo documento
– **Tareas de Agent con varios turnos**: se reutiliza mucho contexto entre turnos
Q5: ¿Cómo puedo cambiar rápidamente a claude-sonnet-5-5 mediante la API?
Regístrate en APIYI y obtén una clave API. Después, mantén el método de llamada compatible con OpenAI, cambia `base_url` por la dirección indicada en este artículo y establece `model` en `claude-sonnet-5-5`. Los nuevos usuarios pueden probar primero las solicitudes de validación con el crédito gratuito de prueba.
Q6: ¿Cómo se calcula el precio de la variante thinking?
`claude-sonnet-5-5-thinking` aparece como una entrada independiente en la interfaz de precios, con un multiplicador distinto al del modelo base. Los precios calculados en este artículo solo corresponden al modelo base `claude-sonnet-5-5`; para la variante thinking, consulta la entrada actual en la lista de modelos de la plataforma. No apliques los precios del modelo base.
Q7: ¿Qué riesgos conocidos hay en la migración?
Hay tres riesgos principales: primero, que se pasen por alto IDs antiguos codificados de forma fija, lo que provocaría errores directamente después de la retirada; segundo, que haya que reconstruir la caché el día del cambio, con una tasa de aciertos baja durante un periodo breve; y tercero, que el estilo o el formato de salida difieran, por lo que los sistemas posteriores que dependan de un análisis estricto del formato necesitan pruebas de regresión. Un cambio gradual y la validación de solicitudes fijas permiten cubrir la mayoría de estos riesgos.
Puntos clave para migrar de Sonnet 4.5 a Sonnet 5.5
- La fecha de retirada está definida:
claude-sonnet-4-5-20250929se retirará el 30 de noviembre de 2026. La recomendación oficial es cambiar aclaude-sonnet-5-5. - Los modelos antiguo y nuevo pueden coexistir durante la migración gradual: al 10 de noviembre de 2026, ambos aparecen en la lista de modelos de la plataforma, por lo que es posible compararlos en paralelo.
- Cambian los tres precios unitarios: según los multiplicadores, el precio de entrada baja de $3 a $2, el de salida de $15 a $10 y el de lectura de caché de $0.30 a $0.10.
- El cambio más notable está en la lectura de caché:
cache_ratiobaja de 0.1 a 0.05, así que el impacto será mayor en los servicios que usan mucho la caché. - El modo thinking se cobra por separado:
claude-sonnet-5-5-thinkinges una entrada independiente; no se debe mezclar su precio con el del modelo base. - Valida con la misma solicitud: comprueba el campo
model, el uso indicado enusagey el detalle de facturación. Para evaluar las diferencias de capacidad, repite tus propias pruebas.
Resumen
Puntos clave para migrar de Sonnet 4.5 a Sonnet 5.5:
- Primero, cambia los ID: asigna
claude-sonnet-4-5yclaude-sonnet-4-5-20250929aclaude-sonnet-5-5; asigna la rama de razonamiento a la variante thinking. - Después, revisa los precios: vuelve a estimar los costos de entrada, salida y lectura de caché según
model_ratio,completion_ratioycache_ratio. - Por último, valida el cambio: después de implementarlo gradualmente, comprueba con la misma solicitud el modelo devuelto, el uso y el cargo. Elimina los ID antiguos antes de la fecha de retirada.
Quedan unos 20 días hasta el 30 de noviembre de 2026. Te recomendamos hacer una búsqueda global y cambiar al nuevo modelo en el entorno de pruebas esta misma semana para tener tiempo de repetir las pruebas de tu servicio. Si necesitas comparar ambos modelos a la vez, puedes usar una sola clave en APIYI (apiyi.com) para hacer las llamadas y comprobar el uso. Consulta la lista de modelos de la plataforma para ver los modelos disponibles y sus precios.
📚 Referencias
- Página de retirada de modelos de Anthropic: calendario de obsolescencia y retirada de los modelos Claude
- Enlace:
platform.claude.com/docs/en/about-claude/model-deprecations -
Nota: permite confirmar el estado de
claude-sonnet-4-5-20250929, las fechas del anuncio y de retirada, y la recomendación oficial para sustituirlo. -
Interfaz pública de precios de APIYI: fuente de los datos de multiplicadores de los modelos
- Enlace:
api.apiyi.com/api/pricing - Nota: consultada el 2026-11-10. Incluye los campos
model_ratio,completion_ratioycache_ratio.
Autor: equipo técnico de APIYI
Consultas técnicas: Si tienes algún problema durante la migración, ponte en contacto con nosotros desde la página de inicio de APIYI. Encontrarás más información de integración en el centro de documentación, en docs.apiyi.com.
