Migración a GPT-5.6: La tabla oficial y el método
En esta página
Estado a 5 de noviembre de 2026. Para un proyecto nuevo, comienza directamente con la familia GPT-6 (Lección 9). No obstante, los modelos GPT-5.6 siguen siendo los sustitutos oficiales de
gpt-5,o3yo3-pro, que se eliminarán de la API el 11 de diciembre de 2026. Mientras tanto,o4-mini,o1yo3-miniya han sido retirados desde el 23 de octubre. El calendario completo de obsolescencia aparece en la Lección 12.
Esta es la última lección sobre las actualizaciones de verano y la más práctica: ¿qué haces con el código construido sobre modelos anteriores? La respuesta tiene dos partes. Primero, conoce los sustitutos que recomienda OpenAI, modelo por modelo. Segundo, ejecuta una migración metódica, porque son precisamente las migraciones «obvias» las que rompen la producción.
Sustitutos oficiales
La página de obsolescencias de OpenAI enumera el sustituto recomendado para cada modelo que ha sido o está siendo retirado:
| Estabas usando | Sustituto recomendado | Eliminación de la API |
|---|---|---|
gpt-5 | gpt-5.6-sol | 11 de diciembre de 2026 |
gpt-5-mini | gpt-5.6-terra | 11 de diciembre de 2026 |
gpt-5-nano | gpt-5.6-luna | 11 de diciembre de 2026 |
o3 | gpt-5.6-sol | 11 de diciembre de 2026 |
o3-pro y gpt-5-pro | gpt-5.6-sol en modo pro | 11 de diciembre de 2026 |
o4-mini | gpt-5.6-terra | Ya eliminado, 23 de octubre de 2026 |
o1 y o3-mini | gpt-5.6-sol | Ya eliminado, 23 de octubre de 2026 |
gpt-5.1 y gpt-5.3-codex | gpt-6-sol | 1 de abril de 2027 |
gpt-5.4-nano | gpt-6-luna | 1 de abril de 2027 |
A fecha de 5 de noviembre, gpt-5.4 y gpt-5.5 no aparecen en esta lista: la API sigue sirviéndolos, aunque GPT-5.5 abandonó ChatGPT, ChatGPT Work y Codex el 14 de octubre. Para estos casos, la lógica de la tabla sigue aplicándose: elige un nivel de modelo y, a continuación, un esfuerzo de razonamiento.
Trata esta tabla como lo que es: un sustituto recomendado, no una garantía de comportamiento idéntico. La única coincidencia fiable es la que confirman tus evaluaciones.
En ChatGPT
Si utilizas la interfaz, la migración ocurre sin tu intervención: o3 abandonó ChatGPT el 26 de agosto de 2026, GPT-5.5 el 14 de octubre, y el selector de modelos muestra ahora solo los modelos activos. Los reflejos de nuestros cursos de incorporación siguen siendo válidos: formula con claridad, aporta contexto e itera. Lo que está envejeciendo son las descripciones de los modelos en tus materiales: «o3 para razonamiento» pertenece al pasado. Si formas equipos, este es el punto que debes actualizar primero.
En tu código: El método de cinco pasos
Comienza inventariando los identificadores: revisa tu código, pero también los archivos de configuración y las variables de entorno, donde los identificadores suelen esconderse y una búsqueda en el código fuente no los encontrará. Hasta que el inventario esté completo, cualquier otra acción es prematura.
Segundo paso: establece el esfuerzo de razonamiento de forma explícita. Los valores por defecto han cambiado: gpt-5.4 no razonaba si no especificabas nada, mientras que GPT-5.6 comienza en medium (Lección 4). minimal ya no existe y se sustituye por low; o3-pro y gpt-5-pro se reemplazan por el modo pro. Una migración que pase por alto este punto altera la latencia y los costes sin previo aviso.
Tercer paso, el que más se suele omitir: vuelve a ejecutar tus evaluaciones. Mide la calidad, la latencia y el coste en tus casos de uso reales antes de pasar nada a producción. Un equipo que migra basándose en la tabla y descubre en producción que un flujo crítico se comporta de manera distinta no ha ahorrado tiempo.
Cuarto paso: recalcula el presupuesto. Los precios han cambiado: Sol a 4 $ / 20 $ por millón de tokens hasta el 30 de noviembre de 2026; Terra a 2 $ / 12 $; Luna a 0,20 $ / 1,20 $; y los tokens de razonamiento se facturan como tokens de salida. El almacenamiento en caché también ha cambiado: desde GPT-5.6, estableces la vida útil de la caché con prompt_cache_options.ttl, cuyo valor por defecto es 30m o 12h, y las escrituras en caché tienen coste. La guía de migración a GPT-6 también pide sustituir el antiguo parámetro prompt_cache_retention al proceder de GPT-5.5 o versiones anteriores.
Por último, evalúa la llamada programática a herramientas (Lección 5). Si tus agentes encadenan llamadas a herramientas, esto puede reducir tokens y latencia, pero se trata de un proyecto de arquitectura separado del simple intercambio de identificadores. Consigue primero que la equivalencia funcione y, después, optimiza.
Tu turno
Inventario en un comando. En la raíz de un proyecto, ejecuta la búsqueda siguiente. Detecta identificadores retirados o a punto de serlo, ignorando los modelos actuales como gpt-5.6-sol. Para cada resultado, anota el sustituto de la tabla, el esfuerzo de razonamiento a establecer y la fecha límite.
grep -rnP '\b(o1|o3|o3-mini|o3-pro|o4-mini|gpt-5(-mini|-nano|-pro)?|gpt-5\.1|gpt-5\.3-codex|gpt-5\.4-nano)\b(?![.\w-])' .
Fuentes oficiales: Deprecations · Reasoning models · Prompt caching · Using GPT-6 (documentación de la API de OpenAI) · Model release notes (Centro de ayuda de OpenAI)
Puntos clave
- La página de obsolescencias ofrece un sustituto oficial para cada modelo: GPT-5.6 para
gpt-5yo3, GPT-6 paragpt-5.1 o4-mini,o1yo3-miniya están retirados;gpt-5yo3lo estarán el 11 de diciembre de 2026- Establece el esfuerzo explícitamente: los valores por defecto han cambiado,
minimalpasa a serlowy los modelos «pro» se convierten en modopro - Ningún cambio a producción sin volver a ejecutar tus evaluaciones y recalcular el presupuesto, incluida la caché