Gemini 2.5 Pro obsoleto: qué cambia el 1 de diciembre de 2026

El 1 de diciembre de 2026 Google manda cada petición a Gemini 2.5 Pro hacia Gemini 3.8 Flash y la cobra a tarifa de 3.8 Flash: $0.75 por millón de tokens de entrada y $3.75 por millón de salida hasta el 31 de diciembre de 2026 (página de deprecaciones de Google, consultada el 4 de noviembre de 2026). Ese día las llamadas siguen saliendo bien. Los cuerpos de petición escritos para el modelo antiguo no, y casi todos los arreglos son pequeños.

Tres ediciones cubren la mayor parte del trabajo:

• cambiar la cadena del modelo a gemini-3.8-flash;
• sustituir thinking_budget por thinking_level;
• quitar temperature, top_p, top_k, candidate_count y los turnos de modelo rellenados de antemano.

Los otros tres pasos cubren el estado multiturno, las llamadas a funciones y el SDK. Cada uno lleva su cifra más abajo, con lo que se ve si se salta.

¿Qué pasa el 1 de diciembre?

La fecha viene de las notas de versión de Google, no de una página de cuenta atrás. La entrada del 2 de noviembre de 2026 marca gemini-2.5-pro como obsoleto y dice que todas las peticiones de API irán automáticamente a gemini-3.8-flash y se cobrarán a tarifas de Gemini 3.8 Flash (notas de versión de Google, consultadas el 4 de noviembre de 2026).

La tabla de deprecaciones añade las fechas de alrededor: publicado el 17 de junio de 2025, cierre el 1 de diciembre de 2026, reemplazo gemini-3.8-flash (consultada el 4 de noviembre de 2026). La página del modelo es aún más estrecha: el acceso por API queda limitado a los usuarios existentes que lo hayan usado de forma activa, y solo hasta el 1 de diciembre de 2026. El selector de AI Studio ya no lo ofrece.

Un detalle merece dos lecturas. La misma fila de la tabla da el 1 de diciembre de 2026 como fecha de cierre y promete el reenvío automático a 3.8 Flash. Google no dice si una llamada reenviada informa gemini-2.5-pro o gemini-3.8-flash en la respuesta, así que conviene guardar en el registro el ID de modelo que llegue el primer día.

Diga lo que diga la respuesta, el reemplazo es estable: gemini-3.8-flash salió el 2 de septiembre de 2026, tiene un único ID de versión estable y no tiene fecha de cierre anunciada (página de deprecaciones de Google, consultada el 4 de noviembre de 2026).

Qué cambia en tu código y en tu factura

La regla de usuarios existentes ya se aplica, antes del 1 de diciembre: la página del modelo 2.5 Pro dice que el acceso por API queda limitado a los usuarios existentes que lo hayan usado de forma activa, y solo hasta el 1 de diciembre de 2026 (consultada el 4 de noviembre de 2026). Prueba con la clave que tu equipo despliega de verdad antes de planear el resto.

Los dos modelos se parecen más de lo que sugiere esa regla. Ambos aceptan 1.048.576 tokens de entrada y devuelven hasta 65.536, ambos leen texto, imágenes, vídeo, audio y PDF, y ambos devuelven texto (páginas de modelo de Google, consultadas el 4 de noviembre de 2026). Las diferencias aparecen en los bordes: la página de 3.8 Flash incluye computer use como compatible, y la de 2.5 Pro no tiene fila de computer use. La generación de audio, la de imagen y la Live API figuran como no compatibles en los dos.

Ahora la factura. Desde el 1 de diciembre pagas tarifas de 3.8 Flash por la misma petición. Antes de esa fecha, 2.5 Pro conserva su precio y su tramo de 200.000 tokens.

Qué se rompe al pasar a 3.8 Flash

Seis formas de petición cambian de comportamiento, y las llamadas a funciones necesitan la revisión más cuidadosa. La lista de migración a 3.8 Flash de Google nombra cada cambio (consultada el 4 de noviembre de 2026).

Los parámetros de muestreo son el fallo silencioso. Las notas de 3.6 de Google dicen que temperature, top_p y top_k están obsoletos y hoy se ignoran, y que enviarlos devuelve un HTTP 400 en generaciones futuras del modelo (consultadas el 4 de noviembre de 2026). Para un prompt ya ajustado, ignorar es peor que rechazar: los ajustes de determinismo dejan de hacer nada y ningún error te avisa.

El relleno previo es el ruidoso. Una petición cuyo último turno no vacío es un turno model devuelve HTTP 400, y el arreglo es system_instruction o salidas estructuradas (notas de 3.6 de Google, consultadas el 4 de noviembre de 2026). Las conversaciones multiturno deben llevar previous_interaction_id en lugar de una transcripción reconstruida con el último turno relleno.

Para llamadas a funciones, mete los recursos multimodales dentro del cuerpo de la respuesta, separa las instrucciones en línea con \n\n y usa el recurso de Google si aparece Malformed_Function_Call alrededor del texto previo a la herramienta. En la llamada antigua a generateContent, cada FunctionResponse necesita call_id y name.

Las firmas de pensamiento son el sexto punto, y pesan cuando el SDK es más antiguo que el modelo. La lista de Google te envía a su página de firmas de pensamiento para actualizar el SDK y conservar las firmas.

Los seis cambios, paso a paso

Trabaja en este orden. Los dos primeros tocan todas las peticiones; el resto toca funciones concretas.

1. Cambia la cadena del modelo. Envía gemini-3.8-flash en lugar de gemini-2.5-pro, en la configuración y no en un ayudante de reintentos, para que los registros muestren el ID que querías llamar.
2. Sustituye el presupuesto de pensamiento. thinking_budget pasa a thinking_level con low, medium o high. medium es el valor por defecto y minimal devuelve un error.
3. Borra los parámetros de muestreo y el turno relleno. temperature, top_p, top_k, candidate_count y un turno model al final desaparecen.
4. Mueve el estado multiturno. Unifica en previous_interaction_id del lado del servidor.
5. Revisa las llamadas a funciones. Recursos dentro del cuerpo de la respuesta, \n\n entre instrucciones en línea, call_id y name en cada FunctionResponse.
6. Actualiza el SDK y conserva las firmas de pensamiento. La lista de 3.8 enlaza la página de firmas de pensamiento de Google para este punto.

El diff de la petición cabe en un bloque. Antes:

{
  "model": "gemini-2.5-pro",
  "contents": [{"role": "user", "parts": [{"text": "Summarize the attached invoice."}]}],
  "generation_config": {
    "thinking_budget": 8192,
    "temperature": 0.7,
    "top_p": 0.9
  }
}

Después:

{
  "model": "gemini-3.8-flash",
  "contents": [{"role": "user", "parts": [{"text": "Summarize the attached invoice."}]}],
  "generation_config": {
    "thinking_level": "medium"
  }
}

Lanza una petición real a gemini-3.8-flash antes del 1 de diciembre y guarda en el registro el ID de modelo de la respuesta.

Si quieres otra forma de llamar a gemini-3.8-flash durante el cambio, la página del modelo Gemini 3.8 Flash lista el ID, el contexto de 1M y los tres niveles de pensamiento. Las tarifas actuales de ambos modelos están en la página de precios.

La diferencia de precio

En el nivel de pago estándar, hasta el 31 de diciembre de 2026, 3.8 Flash cuesta menos de la mitad que 2.5 Pro en salida y un 40% menos en entrada (página de precios de Google, consultada el 4 de noviembre de 2026).

Una petición con 100.000 tokens de entrada y 20.000 de salida concreta la distancia. En 2.5 Pro cuesta $0.125 + $0.20 = $0.325. En 3.8 Flash cuesta $0.075 + $0.075 = $0.15 hasta el 31 de diciembre de 2026, y $0.15 + $0.15 = $0.30 desde el 1 de enero de 2027.

Lee la fila de 2027 antes de celebrar. La entrada sube un 20% por encima de los $1.25 de 2.5 Pro, y la salida sigue un 25% por debajo de los $10.00 de 2.5 Pro. Una petición con mucha entrada costará más el año que viene que hoy con 2.5 Pro.

El precio por lotes mantiene la forma: 2.5 Pro cobra $0.625 de entrada y $5.00 de salida hasta 200k tokens, y 3.8 Flash cobra $0.375 y $1.875 hasta el 31 de diciembre de 2026 (página de precios de Google, consultada el 4 de noviembre de 2026).

La tabla completa, con caché, Priority y las cifras de 2027, está en la guía de precios de Gemini 3.8 Flash.

2.5 Flash y 2.5 Flash-Lite

2.5 Flash comparte la fecha del 1 de diciembre; 2.5 Flash-Lite no.

La página de deprecaciones de Google (consultada el 4 de noviembre de 2026) pone gemini-2.5-flash en los mismos términos que 2.5 Pro: publicado el 17 de junio de 2025, las peticiones van a gemini-3.5-flash-lite desde el 1 de diciembre de 2026 y la facturación pasa a tarifas de 3.5 Flash-Lite. gemini-2.5-flash-lite no está obsoleto y sigue disponible hasta nuevo aviso.

Dos IDs de audio necesitan su propia entrada de calendario. gemini-2.5-pro-preview-tts y gemini-2.5-flash-preview-tts se cierran el 17 de noviembre de 2026, reemplazados por gemini-3.8-flash-tts o gemini-3.8-flash-lite-tts.

Los preestrenos fijados más antiguos de 2.5 Pro ya están fuera. gemini-2.5-pro-preview-03-25, -05-06 y -06-05 tienen fecha de cierre el 2 de diciembre de 2025, así que una configuración que todavía nombre uno de ellos está fallando hoy.

Preguntas frecuentes

¿Gemini 2.5 Pro está obsoleto?

Sí. Las notas de versión de Google del 2 de noviembre de 2026 marcan gemini-2.5-pro como obsoleto, y la página de deprecaciones fija el 1 de diciembre de 2026 como el día en que todas las peticiones de API pasan a gemini-3.8-flash (consultadas el 4 de noviembre de 2026). El modelo ya no aparece en el selector de AI Studio.

¿Qué pasa con mis llamadas el 1 de diciembre de 2026?

Siguen devolviendo respuestas. Google dice que las peticiones a gemini-2.5-pro van automáticamente a gemini-3.8-flash y se cobran a tarifas de 3.8 Flash. La misma tabla también da el 1 de diciembre de 2026 como fecha de cierre, y Google no dice qué ID de modelo informa la respuesta, así que guárdalo en el registro el primer día.

¿Gemini 2.5 Pro sigue en AI Studio?

No. Google quitó gemini-2.5-pro del selector de AI Studio y limita el acceso por API a los usuarios existentes que lo hayan usado de forma activa, hasta el 1 de diciembre de 2026 (páginas de deprecaciones y de modelo de Google, consultadas el 4 de noviembre de 2026).

¿Mi código se rompe si no cambio nada?

Cuenta con fallos donde 3.8 Flash rechaza un campo antiguo: thinking_level: "minimal", candidate_count, un turno model final y objetos FunctionResponse sin call_id ni name. thinking_budget tiene que pasar a thinking_level, y temperature, top_p y top_k ya se ignoran. La guía de migración de Google enumera cada cambio, y una petición que termina en un turno model no vacío ya devuelve HTTP 400.

¿Cuánto más barato es Gemini 3.8 Flash?

Hasta el 31 de diciembre de 2026 es un 40% más barato en entrada y un 62,5% más barato en salida que 2.5 Pro por debajo de 200k tokens: $0.75 frente a $1.25, y $3.75 frente a $10.00 por millón. Desde el 1 de enero de 2027, la entrada cuesta un 20% más que en 2.5 Pro y la salida un 25% menos.

Fuentes consultadas

• Deprecaciones de la API de Google Gemini
• Notas de versión de la API de Google Gemini
• Migrar a Gemini 3.8 Flash
• Cambios y parámetros de la API de Gemini 3.6
• Página del modelo Gemini 2.5 Pro
• Página del modelo Gemini 3.8 Flash
• Precios de la API de Gemini