Migración de modelos
Gemini 2.5: migración de Pro y Flash antes de diciembre
Google anunció el 2 de noviembre cambios para Gemini 2.5. Revisa el destino automático del 1 de diciembre, los parámetros y el coste antes de migrar.
En este artículo
Deprecado no significa retirado hoy. Antes del 1 de diciembre prepara y prueba explícitamente el modelo de destino; el alias y la factura pueden cambiar.
Qué cambia y cuándo#
El aviso del 2 de noviembre de 2026 retira Gemini 2.5 Pro y Flash del selector de AI Studio. A partir del 1 de diciembre, sus solicitudes API se dirigirán a los destinos indicados abajo y se cobrarán con las tarifas de esos destinos. No deduzcas que hoy todas las llamadas a 2.5 ya fallan.
| Identificador anterior | Destino desde el 1 de diciembre |
|---|---|
| gemini-2.5-pro | gemini-3.8-flash |
| gemini-2.5-flash | gemini-3.5-flash-lite |
Documentación: Google · Gemini API release notes, 2 November 2026 · Google · Gemini API deprecations
Auditar el contrato antes de cambiar el nombre#
El cambio incluye thinking_level en lugar de thinking_budget, validación de llamadas a herramientas y firmas de razonamiento. Las guías también señalan parámetros de muestreo y turnos de modelo precargados que deben retirarse. Comprueba el contrato de la API y SDK que realmente utilizas; un cambio de cadena no demuestra compatibilidad.
| Área | Prueba de migración |
|---|---|
| Parámetros | Revisar thinking_level y eliminar parámetros que el destino no acepte. |
| Herramientas | Repetir una conversación con llamadas a funciones y sus respuestas; conservar las firmas exigidas. |
| Contexto | Probar entradas cortas y próximas al límite que usa tu aplicación. |
| Resultado | Validar esquema, errores y criterio de aceptación, además de HTTP 200. |
Documentación: Google · Gemini 3.8 Flash migration · Google · Gemini 3.5 Flash-Lite migration
Una prueba controlada y una salida de recuperación#
- Congela un conjunto representativo de tareas y sus respuestas aceptables; no uses datos privados de producción como material de prueba.
- Ejecuta el conjunto en staging con el identificador de destino explícito y registra modelo efectivo, consumo, errores y tiempo.
- Compara coste por tarea completada, incluidos reintentos y cargos adicionales. Una tarifa por token menor no prueba que el flujo completo cueste menos.
- Despliega gradualmente con un destino alternativo compatible ya probado. No dependas del nombre antiguo como recuperación después de su redirección.
Qué conservar en la comparación#
Guarda fecha de corte, identificador exacto, tarifa aplicable y condiciones de caché y contexto. Revisa también alertas, presupuestos y reglas que dependan del nombre del modelo. Este artículo cubre la migración de los dos identificadores, no todo el calendario de retiros.