Gemini

imagen-3.0-generate-002: retirement date, replacement, how to migrate

imagen-3.0-generate-002 was retired on 2025-11-10 on the Gemini API; the vendor's named replacement is imagen-4.0-generate-001.

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

Retirement date: 2025-11-10
Status: Retired, 338 days ago
Replacement: imagen-4.0-generate-001
Official notice: https://ai.google.dev/gemini-api/docs/deprecations#imagen-models
Record date: 2026-09-23

Find it in your code

npx @upseam/cli inspect gemini

grep -rnF 'imagen-3.0-generate-002' .

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

imagen-3.0-generate-002 imagen-4.0-generate-001

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-09-23 · Markdown copy