Gemini

gemini-2.5-flash-image: retirement date, replacement, how to migrate

gemini-2.5-flash-image is listed to retire no sooner than 2027-03-15 on the Gemini API; the vendor's named replacement is gemini-3.1-flash-lite-image.

This date is the one in the Gemini notice for the Gemini API. Other platforms that host the same model publish their own dates.

Facts

Earliest retirement date: 2027-03-15
Status: Not final: the notice gives an earliest date
Replacement: gemini-3.1-flash-lite-image
Official notice: https://ai.google.dev/gemini-api/docs/deprecations#nano-banana-models
Record date: 2026-10-14

Find it in your code

npx @upseam/cli inspect gemini

grep -rnF 'gemini-2.5-flash-image' .

The first command reads your repository and the change data bundled in the package; nothing leaves your machine. The second is a plain text search.

Migrate

gemini-2.5-flash-image gemini-3.1-flash-lite-image

Change the id in your code and config to the vendor's named replacement. The record does not say whether outputs, parameters or prices stay the same, so read the vendor's notice before you switch. Open the vendor's notice.

Get warned automatically

Upseam is Dependabot for APIs: it watches vendor changelogs and opens a checked pull request when a change affects your code. See how it works.

Last updated 2026-10-14 · Markdown copy