# Gemini 2.5 Pro obsoleto: qué cambia el 1 de diciembre de 2026 > El 1 de diciembre de 2026 Google manda cada petición de gemini-2.5-pro a gemini-3.8-flash con precios de 3.8 Flash. Qué se rompe y qué hay que cambiar. - Canonical HTML: https://omniakey.com/es/blog/gemini-2-5-pro-deprecated-migration-guide - Markdown: https://omniakey.com/es/blog/gemini-2-5-pro-deprecated-migration-guide.md - Published: 2026-11-04 (updated 2026-11-04) - Author: Kiki, COO at OmniaKey - Language: es - Category: Guide - Reading time: 8 min - All posts: https://omniakey.com/blog/llms.txt --- El 1 de diciembre de 2026 Google manda cada petición a [Gemini 2.5 Pro](https://omniakey.com/es/gemini-2-5-pro) hacia [Gemini 3.8 Flash](https://omniakey.com/es/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). |Lo que envías|Lo que pasa|Qué cambiar| |-|-|-| |`thinking_budget`|sustituido en la petición de 3.8|envía `thinking_level`| |`thinking_level: "minimal"`|devuelve un error|usa `low`, `medium` o `high`| |`temperature`, `top_p`, `top_k`|se ignoran ahora, HTTP 400 en generaciones futuras|bórralos| |`candidate_count`|no compatible en Gemini 3 y posteriores|un candidato por llamada| |un turno final con `role: "model"`|HTTP 400|mueve la regla a `system_instruction`| |`FunctionResponse` sin `call_id` ni `name`|`Malformed_Function_Call`|añade los dos campos| 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: ```json { "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: ```json { "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](https://omniakey.com/es/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](https://omniakey.com/es/pricing). ## 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). |Modelo|Entrada por 1M|Salida por 1M| |-|-|-| |`gemini-2.5-pro`, hasta 200k|$1.25|$10.00| |`gemini-2.5-pro`, más de 200k|$2.50|$15.00| |`gemini-3.8-flash`, hasta el 31 dic 2026|$0.75|$3.75| |`gemini-3.8-flash`, desde el 1 ene 2027|$1.50|$7.50| 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](https://omniakey.com/es/blog/gemini-3-8-flash-api-pricing). ## 2.5 Flash y 2.5 Flash-Lite 2.5 Flash comparte la fecha del 1 de diciembre; 2.5 Flash-Lite no. |Modelo|Cierre|Reemplazo| |-|-|-| |`gemini-2.5-flash`|1 de diciembre de 2026|`gemini-3.5-flash-lite`| |`gemini-2.5-flash-lite`|ninguno anunciado|sigue disponible| 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](https://ai.google.dev/gemini-api/docs/deprecations) - [Notas de versión de la API de Google Gemini](https://ai.google.dev/gemini-api/docs/changelog) - [Migrar a Gemini 3.8 Flash](https://ai.google.dev/gemini-api/docs/whats-new-gemini-3.8) - [Cambios y parámetros de la API de Gemini 3.6](https://ai.google.dev/gemini-api/docs/whats-new-gemini-3.6) - [Página del modelo Gemini 2.5 Pro](https://ai.google.dev/gemini-api/docs/models/gemini-2.5-pro) - [Página del modelo Gemini 3.8 Flash](https://ai.google.dev/gemini-api/docs/models/gemini-3.8-flash) - [Precios de la API de Gemini](https://ai.google.dev/gemini-api/docs/pricing)