Migrating from gemini-2.5-flash-image to gemini-3.1-flash-image
What changes when you move from gemini-2.5-flash-image to gemini-3.1-flash-image: input price +66.7%, context window 65,536 → 131,072 tokens.
- Status
- Deprecated
- Shutdown
- Mar 15, 2027 at the earliest
- Time left
- 151 days
- Status
- Active
- Shutdown
- none announced
- Time left
- —
Prices
USD per 1M tokens, standard tier| Type | gemini-2.5-flash-image | gemini-3.1-flash-image | Change |
|---|---|---|---|
| Input | $0.30first seen October 1, 2026 · source | $0.50first seen October 1, 2026 · source | +66.7% |
| Output | Not published | $3.00first seen October 1, 2026 · source | — |
Other tiers, prompt-size bands and modalities are on each model's page.
Limits
Tokens| Limit | gemini-2.5-flash-image | gemini-3.1-flash-image | Change |
|---|---|---|---|
| Context window | 65,536 tokensin place when tracking began (October 6, 2026) · source | 131,072 tokensin place when tracking began (October 6, 2026) · source | +100% |
| Max output tokens | 32,768 tokensin place when tracking began (October 6, 2026) · source | 32,768 tokensin place when tracking began (October 6, 2026) · source | 0% |
Features and parameters
Compare models- Reasoning / thinking: not supported on gemini-2.5-flash-image, supported on gemini-3.1-flash-image.gemini-2.5-flash-image: in place when tracking began (October 6, 2026) · source · gemini-3.1-flash-image: in place when tracking began (October 6, 2026) · source
- Built-in web search: not supported on gemini-2.5-flash-image, supported on gemini-3.1-flash-image.gemini-2.5-flash-image: in place when tracking began (October 6, 2026) · source · gemini-3.1-flash-image: in place when tracking began (October 6, 2026) · source
Same on both
- Structured outputs: not supported on both.gemini-2.5-flash-image: in place when tracking began (October 6, 2026) · source · gemini-3.1-flash-image: in place when tracking began (October 6, 2026) · source
- Function calling: not supported on both.gemini-2.5-flash-image: in place when tracking began (October 6, 2026) · source · gemini-3.1-flash-image: in place when tracking began (October 6, 2026) · source
- Prompt caching: not supported on both.gemini-2.5-flash-image: in place when tracking began (October 6, 2026) · source · gemini-3.1-flash-image: in place when tracking began (October 6, 2026) · source
- Batch API: supported on both.gemini-2.5-flash-image: in place when tracking began (October 6, 2026) · source · gemini-3.1-flash-image: in place when tracking began (October 6, 2026) · source
- Image input: supported on both.gemini-2.5-flash-image: in place when tracking began (October 6, 2026) · source · gemini-3.1-flash-image: in place when tracking began (October 6, 2026) · source
Not published for gemini-2.5-flash-image: PDF input, Fine-tuning, temperature parameter, top_p parameter, logprobs.
Not published for gemini-3.1-flash-image: Fine-tuning, temperature parameter, top_p parameter, logprobs.
Aliases
All aliasesNo aliases point at either model.
Checklist
- Change the model string from
gemini-2.5-flash-imagetogemini-3.1-flash-image. - Re-check costs: gemini-3.1-flash-image costs more than gemini-2.5-flash-image (input +66.7%).
Compared from AIWire's published data when this page loaded. Each fact links to the page it came from. Model pages: gemini-2.5-flash-image, gemini-3.1-flash-image.