gemini-3.1-flash-image-preview — Deprecated

Quick fix — copy & paste

Choose your language. The "before" block matches the deprecated call; the "after" block is the drop-in replacement.

# Gemini: gemini-3.1-flash-image-preview (active)
model = "gemini-3.1-flash-image-preview"

# No direct replacement — see Gemini docs.
# Pick a current model from the provider's available list.

// Gemini: gemini-3.1-flash-image-preview (active)
const model = "gemini-3.1-flash-image-preview";

// No direct replacement — see Gemini docs.
const model = "<choose a current model>";

"model": "gemini-3.1-flash-image-preview"

"model": "<choose a current model>"

This migration was generated automatically from the model rename. If your code does more than swap a model id, double-check request/response shapes against the official Gemini migration guide.

Error messages

Seeing one of these? You're in the right place.

• model_not_found: gemini-3.1-flash-image-preview
• The model `gemini-3.1-flash-image-preview` has been deprecated
• The model `gemini-3.1-flash-image-preview` does not exist or you do not have access to it

Other Gemini deprecations

• gemini-3.1-flash-lite-preview 2026-05-25 · 17d
• gemini-2.0-flash 2026-06-01 · 24d
• gemini-2.0-flash-001 2026-06-01 · 24d
• gemini-2.0-flash-lite 2026-06-01 · 24d
• gemini-2.0-flash-lite-001 2026-06-01 · 24d

What this means for your code

gemini-3.1-flash-image-preview is a general-purpose chat model used through the standard messages or chat completions endpoint. Most production traffic on chat models comes from streaming responses, function calling, and tool use. After the shutdown date, every API call returns an error and your app breaks for end users until the model id is updated.

gemini-3.1-flash-image-preview has been marked deprecated by Gemini. A specific shutdown date has not been published, but deprecated models typically receive 6-12 months of notice before retirement.

Find every call in your codebase

Before you change anything, locate every place the deprecated model id is referenced. Search source files, environment files, feature flags, and config repos. Use these commands from your project root:

grep -rn '"gemini-3.1-flash-image-preview"' --include="*.py" .

grep -rn '"gemini-3.1-flash-image-preview"' --include="*.{js,ts,tsx,jsx}" .

grep -rn "gemini-3.1-flash-image-preview" .

Migration checklist

Steps in order. Skip any that don't apply, but read the whole list — for chat models, the non-obvious steps are usually the ones that break in production.

1. 1. Search for the deprecated model id in your application code, environment variables, and feature flags
2. 2. Update the model id in your API client configuration
3. 3. Re-run integration tests that exercise streaming, function calling, and structured outputs
4. 4. If you use prompt caching, verify the new model supports the same cache scopes
5. 5. Compare token costs on a representative sample of prompts before deploying