La respuesta corta a 21 de marzo de 2026 es esta: el reemplazo oficial de gemini-2.5-pro es gemini-3.1-pro-preview. Eso aparece de forma explícita en la página viva de deprecations. Pero el problema de producto no termina ahí. gemini-2.5-pro sigue activo hoy, sigue marcado como estable y la documentación no dice que ya esté retirado: dice que su fecha más temprana de apagado es el 17 de junio de 2026. Mientras tanto, gemini-3.1-pro-preview ya es claramente el carril Pro hacia delante, pero sigue siendo Preview y además es más caro.
Por eso este keyword no es solo una pregunta de nomenclatura. La pregunta real es cuándo migrar, qué tráfico mover primero y si todavía tiene sentido mantener 2.5 Pro como carril estable por defecto. Si tu carga ya necesita mejor razonamiento, mejor coding o flujos agentic más sólidos, lo correcto es empezar a benchmarkear gemini-3.1-pro-preview ahora. Si tu prioridad es estabilidad, menor coste por token o conservar una vía de pruebas de baja fricción, sigue siendo racional mantener gemini-2.5-pro en servicio y hacer una migración controlada antes del 17 de junio de 2026, en lugar de forzar un cambio total hoy.
La SERP actual suele quedarse corta por una razón simple: la tabla de deprecations responde al ciclo de vida, la página de precios responde al coste y las páginas de modelos responden al estado. Lo que casi nadie une es la recomendación operativa que sale de leer esas tres piezas juntas.
Resumen rápido
- El reemplazo oficial de
gemini-2.5-proesgemini-3.1-pro-preview. gemini-2.5-prono está muerto todavía. La tabla actual de deprecations marca 17 de junio de 2026 como fecha más temprana de apagado.gemini-3.1-pro-previewsigue en Preview y cuesta más, así que "replacement recomendado" no significa "mejor default inmediato" para todos los equipos.- Para muchos equipos, la ruta más segura es empezar benchmarks ahora, mantener doble enrutamiento si hace falta y completar la migración antes de acercarse demasiado al 17 de junio de 2026.
La comparación práctica a 21 de marzo de 2026 queda así:
| Área | Gemini 3.1 Pro Preview | Gemini 2.5 Pro | Qué implica |
|---|---|---|---|
| Estado oficial | Preview | Stable | El sucesor es más nuevo, pero no necesariamente el carril de menor riesgo |
| Model ID | gemini-3.1-pro-preview | gemini-2.5-pro | Migrar exige un cambio explícito de modelo |
| Fecha de lanzamiento | 19 de febrero de 2026 | 17 de junio de 2025 | 3.1 es la nueva vía Pro; 2.5 es la vía de continuidad |
| Guidance de apagado | Sin fecha anunciada | Earliest shutdown 17 de junio de 2026 | Hay tiempo, pero no indefinido |
| Visibilidad de free tier | Sin fila visible en pricing | Con fila visible en pricing | 2.5 Pro sigue siendo más cómodo para pruebas baratas |
| Precio hasta 200k | $2.00 input / $12.00 output | $1.25 input / $10.00 output | 3.1 es claramente más caro |
| Precio por encima de 200k | $4.00 input / $18.00 output | $2.50 input / $15.00 output | La prima también sigue en prompts largos |
| Contexto / salida | 1,048,576 input / 65,536 output | 1,048,576 input / 65,536 output | No es una migración por ventana de contexto |
| Public Batch API ceilings | Mismos techos publicados que 2.5 | Mismos techos publicados que 3.1 | La documentación pública aún no promete más throughput |
Estas filas salen de las fuentes oficiales: deprecations, pricing, rate limits, página de Gemini 2.5 Pro y página de Gemini 3.1 Pro Preview.
Qué reemplaza oficialmente a Gemini 2.5 Pro
Si solo buscas la respuesta de ciclo de vida, Google ya la dio. La tabla actual de deprecations lista para gemini-2.5-pro:
- fecha de lanzamiento 17 de junio de 2025
- fecha más temprana de apagado: 17 de junio de 2026
- replacement recomendado
gemini-3.1-pro-preview
De ahí salen dos aclaraciones inmediatas.
La primera es que gemini-2.5-pro no está ya fuera de servicio. No lo está. Si hoy usas el model ID estable gemini-2.5-pro, la página oficial no dice que ya haya sido apagado. Dice que la fecha más temprana posible es el 17 de junio de 2026. Todavía existe margen para migrar con calma.
La segunda es que esta sustitución no equivale a un traspaso simple de estable a estable. El sucesor oficial es una Preview. La página dedicada a Gemini 3.1 Pro Preview, el post de lanzamiento en Google Blog y la model card de Google DeepMind lo presentan como la vía avanzada para tareas complejas, pero no como un baseline GA definitivo y sin riesgo.
Ese matiz importa mucho más de lo que parece. Para algunos equipos basta con que Google haya nombrado al sucesor. Si ya pagas por Pro porque tus tareas son realmente difíciles, tiene sentido empezar por el modelo al que Google está empujando la línea. Pero para equipos donde la madurez del modelo forma parte del riesgo de producto, la lectura correcta es otra: la dirección está clara, pero el mejor momento para moverse sigue dependiendo de la carga real.
Si tu duda en realidad es el retiro de gemini-3-pro-preview y no la sustitución de gemini-2.5-pro, conviene empezar por nuestra guía Gemini 3 Pro Preview not found. Es un evento de apagado distinto.
Por qué la pregunta del replacement es más compleja de lo que parece en la tabla
La tabla de deprecations te dice hacia dónde quiere ir Google con la línea Pro. No te dice si debes cambiarlo todo hoy.
Esa parte depende de otras tres señales.
Primero, el replacement cuesta más. En la página actual de precios, gemini-3.1-pro-preview cuesta $2.00 input / $12.00 output por 1M tokens hasta 200k tokens de prompt, y $4.00 / $18.00 por encima de 200k. gemini-2.5-pro sigue costando $1.25 / $10.00 hasta 200k y $2.50 / $15.00 por encima de 200k. No es un upgrade al mismo precio; es un carril premium.
Segundo, la historia del free tier empeora. En la pricing page, gemini-2.5-pro todavía conserva una fila de free tier; gemini-3.1-pro-preview no la muestra. Incluso aquí hace falta matiz: en el foro oficial de Google AI Developers hay un hilo sobre el free tier de 2.5 Pro que deja claro que debe tratarse como best-effort y no como capacidad seria para producción. Aun así, una cosa es tener una vía gratuita inestable para pruebas y otra distinta no tener una fila visible en pricing. Si usas 2.5 Pro para smoke tests, staging ligero o experimentos de prompting, migrar cambia también la economía de desarrollo.
Tercero, la documentación pública no muestra todavía una ventaja clara de throughput en la vía nueva. La página de rate limits recuerda que la capacidad real puede variar, y las tablas públicas de Batch API muestran los mismos published ceilings para 3.1 Pro Preview y 2.5 Pro. Así que no conviene contarse la historia reconfortante de que el modelo nuevo ya está documentado como más barato, más libre y más rápido. No lo está.
Por eso este keyword es, en el fondo, una página sobre timing de migración, no solo una ficha de catálogo. El replacement oficial está claro. El momento óptimo para el cambio no lo está.
Qué cambia de verdad si te mueves a Gemini 3.1 Pro Preview
La mejora principal no está en el tamaño del contexto, sino en la ambición del modelo.
La página de Gemini 3.1 Pro Preview habla de mejor thinking, mejor token efficiency, respuestas más grounded y mejor comportamiento en software engineering y agentic workflows. El post oficial de Google Blog lo posiciona para tareas donde una respuesta simple ya no basta. Y la model card de Google DeepMind llega a describirlo como el modelo más avanzado de Google para tareas complejas en su publicación del 19 de febrero de 2026.
Pero también hay que ver lo que no cambia en la forma headline del producto:
- tanto 2.5 Pro como 3.1 Pro Preview exponen 1,048,576 tokens de entrada
- ambos mantienen un límite de 65,536 tokens de salida
- ambos siguen dentro de la superficie multimodal amplia de Google
Eso significa que no estamos ante una historia de reemplazo donde el modelo anterior se haya quedado pequeño o claramente fuera de clase. Estamos ante una historia donde Google dice que la vía futura Pro debe ser más inteligente y más agentic, mientras la vía estable anterior sigue siendo suficiente para buena parte del tráfico real.
Por eso sigue siendo útil nuestro análisis más amplio Gemini 3.1 Pro vs Gemini 2.5 Pro. Si quieres benchmark y desglose de routing, esa página va más lejos. Pero para este keyword, la conclusión importante es más simple:
- 3.1 Pro Preview es el carril hacia delante
- 2.5 Pro es el carril de continuidad
- muchos equipos deberían usar esos carriles de forma distinta en vez de fingir que uno sustituye al otro en todo hoy mismo
Quién debería migrar ya, quién debería benchmarkear antes y quién puede esperar un poco
La mayor carencia de muchos resultados actuales es que no clasifican al lector con claridad.
La recomendación más limpia a 21 de marzo de 2026 no es "cámbialo todo" ni "ignora 3.1 hasta GA". Es separar cuatro casos.
| Tu situación | Mejor decisión ahora | Por qué |
|---|---|---|
| Vas a lanzar un nuevo flujo premium de razonamiento o agentic y ya esperas pagar por Pro | Empieza en gemini-3.1-pro-preview, pero deja un fallback | Si la carga es realmente difícil, conviene aprender cuanto antes el sucesor oficial |
Ya ejecutas gemini-2.5-pro con éxito en producción y te importa más la estabilidad que la novedad | Primero benchmark, luego migración por etapas | 2.5 Pro sigue estable, sigue más barato y aún no ha sido apagado |
| Usas 2.5 Pro en parte por el free tier o por una vía de pruebas de bajo coste | Mantén 2.5 Pro un poco más y presupuesta la migración | 3.1 Pro Preview no conserva la misma forma de acceso |
| Eres muy conservador y querías un sucesor estable del mismo nivel | Puedes esperar un poco, pero no hasta el último momento | Google ya nombró el replacement; el problema es que sigue siendo Preview |
Para la mayoría de equipos serios de API, el consejo por defecto es migración con benchmark primero.
Eso significa algo concreto:
- deja
gemini-2.5-proen los workloads donde ya funciona bien - prueba
gemini-3.1-pro-previewen las tareas donde mejor razonamiento, mejor coding o mejor comportamiento agentic sí puedan cambiar el resultado - no fuerces un cutover total hasta que la nueva vía justifique en tu tráfico el mayor coste y el riesgo de Preview
Esto es especialmente importante si tu uso de 2.5 Pro es amplio y rutinario, no glamour frontier. Mucho tráfico real de producción no es investigación: es repetitivo, estable y sensible al coste. Para ese tipo de carga, "más nuevo" no basta. El replacement tiene que comprar algo medible.
También vale la inversa. Si ya sabes que tu cuello de botella es razonamiento difícil, cadenas agentic largas o coding de alto coste de error, esperar demasiado para aprender 3.1 Pro Preview también sería un fallo. La dirección de Google ya es evidente; no conviene que tu primera prueba seria del carril sucesor ocurra unos días antes de la fecha de shutdown.
Checklist de migración antes del 17 de junio de 2026
Si quieres la ruta más segura, sigue este orden.
1. Haz inventario de dónde se usa realmente gemini-2.5-pro. No pienses primero en nombres de modelo. Piensa en workloads:
- asistentes de código
- prompts de razonamiento difícil
- síntesis de documentos
- agent / tool orchestration
- evals internas y pruebas de prompts
- staging y smoke tests
Muchas decisiones malas salen de benchmarkear una media sintética y asumir que representa todo.
2. Migra primero las tareas más difíciles, no toda la flota. Google posiciona 3.1 Pro Preview como carril de tareas complejas, así que pruébalo primero donde eso sí importa:
- prompts que ya fallan en 2.5 Pro
- workflows donde mejorar la primera respuesta reduce revisión humana
- bucles agentic donde un error temprano multiplica los reintentos
- tareas de coding donde más fiabilidad sí merece un mayor coste por token
Si el nuevo modelo no cambia materialmente el resultado, no hay razón para pagar la prima antes de tiempo.
3. Actualiza los model IDs de forma explícita. No te fíes de wrappers o defaults internos ambiguos del tipo "latest Pro". Durante una migración, lo seguro es saber con precisión qué workload ya cambió y cuál no.
pythonmodel = "gemini-2.5-pro" # carril oficial de replacement model = "gemini-3.1-pro-preview"
4. Mira economics, no solo calidad. Tu hoja de benchmark debería incluir al menos:
- delta de calidad sobre prompts reales
- delta de coste por tokens
- frecuencia de retry y fallback
- comportamiento de rate limits en tu cuenta
- impacto de perder la vía de pruebas gratuita de 2.5 Pro
Los equipos que ignoran las columnas de coste y acceso suelen llegar a conclusiones demasiado optimistas sobre la vía nueva.
5. Fija un cutoff interno anterior al 17 de junio de 2026. La tabla de deprecations habla de la fecha más temprana de apagado, no del último día absolutamente seguro. La mejor práctica es marcar una fecha propia anterior, completar la migración con calma y dejar margen para limpieza.
Si decides mantener 2.5 Pro algo más de tiempo, eso puede ser razonable. Pero conviértelo en un holdover deliberado con fecha de salida, no en una costumbre indefinida.
Una advertencia práctica sobre free tier y expectativas de fiabilidad
La peor lectura de este tema es: "como 2.5 Pro aún tiene fila de free tier, puedo quedarme ahí hasta el último segundo y no pasará nada".
Eso es demasiado optimista.
El hilo oficial sobre el acceso free tier de 2.5 Pro deja claro que el uso gratuito debe tratarse como best-effort y no como una base seria para aplicaciones importantes. Otros hilos de la comunidad sobre overload no prueban por sí solos que el modelo esté roto, y no deberían usarse como hechos duros de producto. Pero sí refuerzan la misma lección operativa: el carril de continuidad sigue siendo utilizable, no sagrado.
Por eso la recomendación práctica es esta:
- no hagas una panic migration solo porque ya existe el replacement
- tampoco idealices el carril viejo como si pudiera durar para siempre
- aprovecha la ventana que queda para migrar de forma intencional
Si quieres más contexto sobre costes y acceso alrededor de esta decisión, puedes seguir con Gemini API free quota 2026, Gemini 3.1 Pro vs Gemini 2.5 Pro y la guía en inglés de Gemini API pricing 2026. Para rate limits no existe aún una versión equivalente en español en este slug, así que aquí dejamos de forma explícita el fallback en inglés.
FAQ
¿gemini-3.1-pro-preview es el reemplazo oficial de gemini-2.5-pro?
Sí. La tabla actual de deprecations de Google lista gemini-3.1-pro-preview como recommended replacement para gemini-2.5-pro.
¿gemini-2.5-pro ya está apagado?
No. A 21 de marzo de 2026, la página oficial marca 17 de junio de 2026 como fecha más temprana de apagado, no como una fecha ya consumada.
¿Existe ya un sucesor estable del mismo nivel?
No en la superficie oficial de migración actual. El sucesor nombrado es gemini-3.1-pro-preview, y sigue siendo Preview.
¿Gemini 3.1 Pro Preview es más barato que Gemini 2.5 Pro?
No. En la pricing page actual, 3.1 Pro Preview cuesta más que 2.5 Pro tanto en la banda estándar como en la de contexto largo.
Si ya estoy satisfecho con Gemini 2.5 Pro, debo cambiar hoy mismo?
En general, no. Para muchos equipos es mejor benchmarkear ahora, mover primero los workloads más difíciles y completar el cutover antes de que se acerque demasiado la ventana del 17 de junio de 2026.
¿Dónde veo la comparativa completa y no solo la respuesta sobre replacement?
En Gemini 3.1 Pro vs Gemini 2.5 Pro. Esta página es intencionalmente más estrecha y está centrada en la migración.