apiwatch

All changes / Google

Breaking model

Google's deprecations table lists March 15, 2027 as the earliest shutdown date for gemini-2.5-flash-image, with gemini-3.1-flash-lite-image as the replacement; its September 18 release notes say the 2.5 models are not deprecated.

Takes effect · Gemini API model gemini-2.5-flash-image

Reviewed against the vendor source on Oct 7, 2026 (AI-assisted review). Key facts are re-checked against the source daily.

What changes

The Gemini API deprecations page lists gemini-2.5-flash-image (released October 2, 2025) with a shutdown date of March 15, 2027 and gemini-3.1-flash-lite-image as the recommended replacement. The page says its dates are the earliest possible and that Google will give advance notice of the exact date. This record treats it as breaking because the listed shutdown is within 180 days (docs/REVIEW.md). Google's pages disagree, though. The September 18, 2026 release notes say the 2.5 models are not deprecated and will continue to be served until further notice, with access limited to past users. No deprecation announcement for this model appears in the release notes.

Breaking: Calls fail after this date.

What to do

Plan a move to gemini-3.1-flash-lite-image, the replacement the deprecations page lists. Don't move to gemini-3.1-flash-image, which Google deprecated on October 6, 2026. Re-check image quality on your evals.

Strings to search for

gemini-2.5-flash-image

Not affected (matches inside these are ignored): gemini-2.5-flash-image-preview

Source

https://ai.google.dev/gemini-api/docs/deprecations