Migrating from 2.0 → 2.5 → 3.1
🚨 Gemini 2.0 Retired: As of June 1, 2026, all Gemini 2.0 models have been officially retired. Any workloads still targeting Gemini 2.0 endpoints will receive errors. Migrate immediately to Gemini 2.5 or 3.1+.
With Gemini 2.0 now retired, enterprise workloads must migrate to the Gemini 2.5 family (Pro, Flash, and Lite) as a stepping stone, or directly to the latest Gemini 3.1 series.
⚠️ EOL Notice: Gemini 2.5 models are now scheduled for retirement on October 16, 2026. Plan migration to Gemini 3.1 Pro/Flash/Flash-Lite accordingly.
- Gemini 2.5 Pro: Upgraded reasoning and mathematical problem-solving. Still available but approaching EOL.
- Context Caching Economics: Gemini 2.5 introduces massive token discounts, offering up to a 90% discount on cached input tokens compared to previous generations.
- Gemini 3.1 Pro: The new flagship — fully optimized for agentic workflows with MoE architecture and native tool use.