Google Gemini API · model
gemini-2.5-flash-image deprecation: shutdown date & replacement
- Provider
- Google Gemini API
- Type
- model
- Announced
- —
- Shutdown
- Replacement
gemini-3.1-flash-image-preview- Source
- Official Google Gemini API notice
Page lists announced earliest shutdown date.
How to migrate off gemini-2.5-flash-image
- Find every place that references it:
grep -rn --exclude-dir={node_modules,.git,dist} "gemini-2.5-flash-image" . - Replace the model ID:
- model: "gemini-2.5-flash-image" + model: "gemini-3.1-flash-image-preview" - Re-run your evals or a sample of real prompts — output style, token usage and pricing can change between models.
- Check config outside code too: environment variables, feature flags, prompt-management tools, and fine-tuned model references.
- Deploy before October 2, 2026, and add the CI scanner so it cannot come back.
Same model on other platforms
- Google Cloud Vertex AI (Gemini Enterprise Agent Platform) — March 15, 2027
Questions
Is gemini-2.5-flash-image deprecated?
Yes. Google Gemini API has deprecated gemini-2.5-flash-image. It shuts down on October 2, 2026.
When does gemini-2.5-flash-image shut down?
October 2, 2026, according to Google Gemini API's official deprecation notice.
What should I use instead of gemini-2.5-flash-image?
Google Gemini API recommends gemini-3.1-flash-image-preview. 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.