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.
Evidencia y alcance
Documentación verificada · Fuentes revisadas:
Método
Se contrastó el aviso oficial del 2 de noviembre con el calendario de deprecaciones y las dos guías de migración de Google. La matriz y la pauta de pruebas organizan una migración, no acreditan una integración ejecutada.
Limitaciones
- Sin llamadas a cuentas ni pruebas con datos de producción. El destino automático, la disponibilidad y las tarifas deben contrastarse antes del cambio del 1 de diciembre.
Próxima revisión prevista:
Fuentes y alcance
Documentación consultada el 4 de noviembre de 2026. Los ejemplos y criterios de decisión son propuestas editoriales; adáptalos al contrato de tu aplicación y valídalos en tu entorno de pruebas autorizado.