Gemini

gemini-2.5-pro-preview-03-25: retirement date, replacement, how to migrate

gemini-2.5-pro-preview-03-25 was retired on 2025-12-02 on the Gemini API; the vendor's named replacement is gemini-3.1-pro-preview.

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-12-02
Status: Retired, 316 days ago
Replacement: gemini-3.1-pro-preview
Official notice: https://ai.google.dev/gemini-api/docs/deprecations#gemini-2.5-pro-models
Record date: 2026-09-23

Find it in your code

npx @upseam/cli inspect gemini

grep -rnF 'gemini-2.5-pro-preview-03-25' .

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-pro-preview-03-25 gemini-3.1-pro-preview

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.

Retiring the same day

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