Google Cloud Vertex AI (Gemini Enterprise Agent Platform) · model

gemini-2.5-flash-image deprecation: shutdown date & replacement

Shuts down March 15, 2027 — in 170 days
Provider
Google Cloud Vertex AI (Gemini Enterprise Agent Platform)
Type
model
Announced
—
Shutdown
Replacement
gemini-3.1-flash-lite-image
Source
Official Google Cloud Vertex AI (Gemini Enterprise Agent Platform) notice

Vertex AI / Gemini Enterprise Agent Platform retirement date (page says timelines may be extended but not moved earlier).

How to migrate off gemini-2.5-flash-image

  1. Find every place that references it:
    grep -rn --exclude-dir={node_modules,.git,dist} "gemini-2.5-flash-image" .
  2. Replace the model ID:
    - model: "gemini-2.5-flash-image"
    + model: "gemini-3.1-flash-lite-image"
  3. Re-run your evals or a sample of real prompts — output style, token usage and pricing can change between models.
  4. Check config outside code too: environment variables, feature flags, prompt-management tools, and fine-tuned model references.
  5. Deploy before March 15, 2027, and add the CI scanner so it cannot come back.

Same model on other platforms

Questions

Is gemini-2.5-flash-image deprecated?

Yes. Google Cloud Vertex AI (Gemini Enterprise Agent Platform) has deprecated gemini-2.5-flash-image. It shuts down on March 15, 2027.

When does gemini-2.5-flash-image shut down?

March 15, 2027, according to Google Cloud Vertex AI (Gemini Enterprise Agent Platform)'s official deprecation notice.

What should I use instead of gemini-2.5-flash-image?

Google Cloud Vertex AI (Gemini Enterprise Agent Platform) recommends gemini-3.1-flash-lite-image. Switch the model ID and re-test your prompts, since outputs, pricing and limits can differ.

What happens to requests to gemini-2.5-flash-image after the shutdown?

Requests using the retired model ID fail with an error, so any code still calling it breaks. Update and deploy before the shutdown date.

ModelSunset Alerts

Hear about a shutdown before your users do

Tell us which models and providers you depend on. We email you (or ping Slack) the day a deprecation is announced, and again 90, 30 and 7 days before shutdown.

  • Watchlist of up to 50 models across all providers
  • Instant alert when a new deprecation is published
  • Reminders 90 / 30 / 7 days before shutdown
  • Slack and email, weekly digest for your team

$5/ month

Early access pricing. Cancel anytime. Payments by Creem.