# 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

```sh
npx @upseam/cli inspect gemini
grep -rnF 'gemini-2.5-flash-image' .
```

## 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. Vendor's notice: https://ai.google.dev/gemini-api/docs/deprecations#nano-banana-models

## Get warned automatically

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

Last updated 2026-10-14