Model retirements · Gemini API · checked
gemini-2.0-flash-001 (Gemini API) shutdown date: 1 June 2026
Google listed gemini-2.0-flash-001 on the Gemini API for shutdown no earlier than 1 June 2026 (the earliest date Google gives) and recommends gemini-3.6-flash as the replacement. No price ratio: the retiring model is not listed on the Gemini API pricing page when checked on 8 October 2026, so no ratio is given. Google documents two changes that can break code: a temperature below 1.0 may cause looping; sending thinking_level and thinking_budget together returns a 400 error. It can no longer be asked, so its answers cannot be recorded now; compare the replacement against the outputs you still have.
Find every place your code and config name it, with this page's facts beside each:
$ npx --allow-git=root github:agentwares/model-migrate scan
npx --allow-git=root github:agentwares/model-migrate scan lists every model ID in your code and config that has a shutdown date, with its replacement, price ratio and this page's link. It needs no account and no API key, reads your files on your machine and sends nothing; its one request fetches this data. Free and MIT licensed.
The facts
- Platform
- Gemini API
- Model ID
gemini-2.0-flash-001- Announced
- no date on the page
- Shutdown
- 1 June 2026The earliest possible date; Google says it will confirm the exact date in advance.
- Recommended replacement
gemini-3.6-flash- List price per million tokens, input / output
- The retiring model is not listed on the Gemini API pricing page when checked on 8 October 2026, so no ratio is given.
Prices are the provider's list prices for the standard tier, text input and the shortest context tier. A per-token ratio leaves out how many tokens each model spends on the same prompt; only your own prompts show that.
What changes when you move
- For Gemini 3 models Google recommends keeping temperature at its default of 1.0; setting it below 1.0 may cause looping or degraded performance. source
- Gemini 3 uses thinking_level; sending thinking_level and the legacy thinking_budget in the same request returns a 400 error. source
- Google lists this as the earliest possible shutdown date and says it will give the exact date with advance notice.
How to test the replacement on your own prompts
- Find every call that names
gemini-2.0-flash-001:npx --allow-git=root github:agentwares/model-migrate scanprints each file and line. - gemini-2.0-flash-001 can no longer answer, so use the outputs you already logged, or your current outputs, as the baseline.
- Run the same prompts on
gemini-3.6-flash, a cheaper sibling and a model from another provider, and compare with checks that need no judge: exact or normalised match, JSON validity and schema, tool-call names and arguments, refusals and length.npx --allow-git=root github:agentwares/model-migrate comparedoes this on your keys. - Price the move with the token counts each provider reports for those prompts, not with the list price alone;
comparereports the cost per 1,000 calls. - Make the changes listed above before you switch.
Keep testing until the date
capture and compare run on your keys and keep everything on your machine. To re-run the same prompts against your own endpoint whenever a provider ships a model, with the history kept, npx --allow-git=root github:agentwares/model-migrate export --agentcheck writes them as traces that agentcheck imports onto a target you monitor there. On its Pro plan they become checks that re-run when a provider ships a model, with 90 days of history.
Migration watch is not built. It would re-run your captured prompts on each replacement and each new model until 1 June 2026, with no endpoint needed, and email you what changed. If you would pay for that, say so with one click. The click is counted; nothing else is sent or stored.
Counted. Thank you; nothing else was sent.Also shutting down on 1 June 2026
- gemini-2.0-flash (Gemini API)
- gemini-2.0-flash-lite (Gemini API)
- gemini-2.0-flash-lite-001 (Gemini API)
- gemini-2.0-flash (Vertex AI (Gemini Enterprise Agent Platform))
- gemini-2.0-flash-lite (Vertex AI (Gemini Enterprise Agent Platform))
Other Gemini API retirements
- gemini-3.1-flash-lite — 7 May 2027
- gemini-2.5-computer-use-preview-10-2025 — 28 Jul 2026
- gemini-3.1-flash-lite-preview — 25 May 2026
- gemini-2.5-flash-lite-preview-09-2025 — 31 Mar 2026
- gemini-3-pro-preview — 9 Mar 2026
- gemini-2.5-flash-preview-09-25 — 17 Feb 2026
Every announced shutdown, by date
Sources
- Gemini API deprecations — shutdown date and replacement, read 8 Oct 2026
- ai.google.dev/gemini-api/docs/gemini-3 — the changes above
Built only from the providers' own pages. No vendor intent is implied: a date is what the page says on the day it was read. Data: /models/retirements.json.
model-migrate is a free tool from agentcheck, which re-runs an agent's checks when a provider ships a model and replays recorded traces nightly, so a model change that breaks it arrives as one diff by email.