November 5, 2026. Google deprecated Gemini 2.5 Pro and Gemini 2.5 Flash in its Gemini API release notes on November 2, 2026. From December 1, every API request that still names gemini-2.5-pro is answered by gemini-3.8-flash, and every request that names gemini-2.5-flash is answered by gemini-3.5-flash-lite, each billed at the new model's rates. The model names keep resolving, but to models that reject some request shapes, and routed 2.5 Pro calls are billed at different rates, so a workflow pinned to 2.5 can change its output, and for Pro its cost, on December 1 without anyone editing it. That is 26 days from today.

Key numbers
| Item | Number |
|---|---|
| Deprecation announced (Gemini API release notes) | November 2, 2026 |
| Requests start routing (26 days after this article) | December 1, 2026 |
| gemini-2.5-pro routes to | gemini-3.8-flash |
| gemini-2.5-flash routes to | gemini-3.5-flash-lite |
| Gemini 2.5 Pro, per 1M tokens (prompts up to 200K tokens) | $1.25 in, $10.00 out |
| Gemini 3.8 Flash to December 31, per 1M tokens | $0.75 in, $3.75 out |
| Gemini 3.8 Flash from January 1, 2027 | $1.50 in, $7.50 out |
| Gemini 2.5 Flash and 3.5 Flash-Lite, per 1M tokens (text, image and video input) | $0.30 in, $2.50 out |
| Search grounding, Gemini 2.5 Pro and 2.5 Flash (paid tier, then $35 per 1,000 grounded prompts) | 1,500 a day free |
| Search grounding, Gemini 3 and newer (shared across models, then $14 per 1,000 requests) | 5,000 a month free |
Gemini API release notes, deprecations page, pricing page and migration guides, read on 5 November 2026 (Standard paid tier).
What Google changed on November 2
- Gemini 2.5 Pro routes to Gemini 3.8 Flash. Google's deprecations page says: "Effective December 1, 2026, all API requests to gemini-2.5-pro will automatically route to gemini-3.8-flash and be billed at Gemini 3.8 Flash rates." It adds that API access "is limited to existing users who have actively used it in the past."
- Gemini 2.5 Flash routes to Gemini 3.5 Flash-Lite. Same date, billed at Gemini 3.5 Flash-Lite rates. The replacement is a Flash-Lite model, not 3.8 Flash.
- Neither model can be picked in Google AI Studio. Both notices say the model "is no longer available to select in Google AI Studio".
- Gemini 2.5 Flash-Lite is not part of it. Google says
gemini-2.5-flash-lite"is not deprecated and remains available through the API until further notice." - Google names the breaking changes itself. The release note says the breaking API changes include "function calling and thought_signature validation, thinking_level replacing thinking_budget, and removed sampling parameters and prefilled model turns."
Data Studios' independent write-up reads the same routing from the release notes and points out that the notices cover the Gemini Developer API and "do not describe the model lifecycle on Vertex AI, which Google documents separately."
What the replacement models change in your requests
Google's migration guides for Gemini 3.5 Flash-Lite and Gemini 3.8 Flash list what changes inside the request. These are the items most likely to touch an existing automation:
- Sampling parameters. "temperature, top_p, and top_k are deprecated and ignored", and "In future model generations, supplying these parameters returns an HTTP 400 error." A step that relied on a low temperature for consistent answers loses that control. Google's advice is a system instruction "with explicit rules for your specific use case."
- Prefilled model turns. "If the last non-empty turn in the request is a model turn, the API returns a 400 error." Google says workflows that prefilled a reply to force JSON should use system_instruction or structured outputs instead.
- Thinking settings. Both guides say to replace thinking_budget with thinking_level. Gemini 3.5 Flash-Lite's default is "minimal", and Google recommends "medium" or "high" for subagents with tool calls "to prevent premature tool termination." Gemini 3.8 Flash defaults to medium and does not support minimal.
- Function calling. Both guides say to audit function calls. The 3.8 Flash guide adds, for generateContent users: "Ensure all FunctionResponse objects include call_id and name." candidate_count is unsupported from Gemini 3 on.
- Token use. Google says Gemini 3.8 Flash "can use more tokens on longer running and complex tasks, by design", because it "takes smaller reasoning steps, calls tools iteratively, and verifies its work along the way." As on 2.5, thinking tokens are billed as output.
Google also publishes a quality claim for the Flash route: its guide says 3.5 Flash-Lite beats 2.5 Flash on HLE (18.0% versus 11.0%) and CharXIV (74.5% versus 63.7%). Those are Google's benchmarks for a model it sells, not a test of your prompts.
What the bill looks like after December 1
Standard paid-tier prices per million tokens on Google's Gemini API pricing page, read November 5, 2026:
| Model | Input | Output | Cached input |
|---|---|---|---|
| Gemini 2.5 Pro until November 30, prompts up to 200K tokens | $1.25 | $10.00 | $0.125 |
| Gemini 2.5 Pro until November 30, prompts over 200K tokens | $2.50 | $15.00 | $0.25 |
| Gemini 3.8 Flash, December 1 to 31 | $0.75 | $3.75 | $0.075 |
| Gemini 3.8 Flash from January 1, 2027 | $1.50 | $7.50 | $0.15 |
| Gemini 2.5 Flash until November 30 | $0.30 text, image, video; $1.00 audio | $2.50 | $0.03 text, image, video; $0.10 audio |
| Gemini 3.5 Flash-Lite | $0.30, audio included | $2.50 | $0.03 |
For 2.5 Flash users the token price does not move for text, image and video, and audio input falls from $1.00 to $0.30, 70 percent less. For 2.5 Pro users December is cheaper and January is mixed: the 3.8 Flash January input price, $1.50, is 20 percent above 2.5 Pro's $1.25 for prompts up to 200K tokens, while its output price, $7.50, is 25 percent below 2.5 Pro's $10.00. The 3.8 Flash table shows one rate with no 200K band.
Two hypothetical monthly workloads with prompts up to 200K tokens, priced at Standard rates with the same token counts on each model:
- Document reading, 50 million input and 1 million output tokens: $72.50 on 2.5 Pro today, $41.25 on 3.8 Flash in December, $82.50 on 3.8 Flash from January 1.
- Agent writing, 10 million input and 2 million output tokens: $32.50 on 2.5 Pro today, $15.00 in December, $30.00 from January 1.
The arithmetic gives a rule of thumb for prompts up to 200K tokens: at equal token counts, a step that reads more than 10 input tokens for every output token costs more on 3.8 Flash at the January rate than it did on 2.5 Pro. Token counts may not stay equal, since Google says 3.8 Flash can use more tokens by design.

Grounding with Google Search is billed differently
On the paid tier, 2.5 Pro and 2.5 Flash include 1,500 grounded prompts a day free (for 2.5 Flash the limit is shared with Flash-Lite), then charge $35 per 1,000 grounded prompts. Gemini 3.8 Flash and 3.5 Flash-Lite include "5,000 free search requests per month (shared across all Gemini 3 and newer models)", then charge $14 per 1,000 requests, with a daily cap of 1,500 requests. The unit changes as well: a footnote on the 3.5 Flash-Lite table says a request "may result in one or more queries to Google Search. You will be charged for each individual search query performed."
Take a hypothetical workflow that grounds 1,000 prompts a day, 30,000 a month. Under 2.5's daily allowance it pays nothing for search. On the new models it pays $14 per 1,000 on the 25,000 searches left after the 5,000 free ones, $350 a month, if each prompt runs one search, and more if prompts run several. On the free tier, 2.5 Flash included grounding up to 500 requests a day; the 3.5 Flash-Lite free tier lists grounding as "Not available".
Who is affected, and who is not
- Affected: any Gemini Developer API request that names
gemini-2.5-proorgemini-2.5-flash, whether it comes from your own code, an SDK or an automation tool's Gemini step, as long as it calls the Gemini Developer API. Google's wording covers "all API requests" to those names. - Not affected by this notice:
gemini-2.5-flash-lite. Gemini 2.5 Flash Image has its own notice, with shutdown on March 15, 2027. - Check separately: Gemini on Vertex AI. Data Studios notes that these notices do not describe the Vertex AI lifecycle, which Google documents separately.
What it means for agencies and the workflows they run
The routing makes the switch for you, on Google's date and to Google's choice of model. We would rather make it on our own schedule. Here is the order we suggest:
- Find every model string. Search workflows, code and environment variables for
gemini-2.5-proandgemini-2.5-flash. A plain text search for the Flash name also matchesgemini-2.5-flash-lite, which is not deprecated, andgemini-2.5-flash-image, which has its own March 15, 2027 shutdown, so treat those separately. - Pick the target model yourself. Run your own test set on 3.5 Flash-Lite or 3.8 Flash, or on another model, then change the string explicitly before December 1.
- Clean the request. Remove temperature, top_p, top_k and candidate_count, replace prefilled model turns with a system instruction or structured outputs, and set thinking_level. On Flash-Lite, Google advises "medium" or "high" for autonomous subagents with tool calls, code execution or multi-step reasoning.
- Re-price at the January rate. Pro workloads that read far more than they write need the 10 to 1 check above, and grounded workflows need a look at the 5,000 monthly allowance.
- Tell clients before the invoice does. Retainers that include model costs should show the December and January numbers now.
This is general information from Google's documentation as of November 5; recheck the release notes before you commit a client budget.
If you would rather hand the audit off, our n8n developers can help find and re-point model calls inside existing workflows, and our AI automation agency team can re-test and re-price client stacks across providers. A step that writes call summaries or qualifies leads behind an AI receptionist is caught by this too if it runs on Gemini 2.5; see how we set up AI call answering for home services. Related: the Gemini Flash price increase on January 1, Gemini API free tier limits and the Claude Sonnet 4.5 retirement.
What we do not know yet
Google's guides say to replace thinking_budget but do not say whether a routed request that still sends it gets an error or has it ignored, or whether routed 2.5 Flash calls take 3.5 Flash-Lite's minimal default. This article uses Standard prices; Batch, Flex and Priority rates are listed separately on Google's pricing page.
Frequently Asked Questions
Google deprecated gemini-2.5-flash on November 2, 2026. From December 1, 2026, API requests to it route to gemini-3.5-flash-lite and are billed at Gemini 3.5 Flash-Lite rates, $0.30 input and $2.50 output per million tokens on the Standard paid tier. It can no longer be selected in Google AI Studio.
The model name keeps resolving: Google says requests to gemini-2.5-pro will automatically route to gemini-3.8-flash. But Google's Gemini 3 migration guidance says a request that ends with a prefilled model turn gets a 400 error and that temperature, top_p and top_k are ignored, so some requests may fail or behave differently. Google does not say whether a leftover thinking_budget is rejected or ignored.
Routed calls are billed at Gemini 3.8 Flash rates: $0.75 input and $3.75 output per million tokens through December 31, 2026, then $1.50 and $7.50 from January 1, 2027. Gemini 2.5 Pro costs $1.25 input and $10.00 output for prompts up to 200K tokens, so from January the input side costs 20 percent more and the output side 25 percent less.
No. Google's deprecations page says gemini-2.5-flash-lite is not deprecated and remains available through the API until further notice.
Google's November 2 notices are in the Gemini Developer API documentation. Data Studios, which reported the change, notes they do not describe the model lifecycle on Vertex AI, which Google documents separately, so check Google's Vertex AI documentation before assuming the same dates.
Change the model string, remove temperature, top_p, top_k and candidate_count, remove prefilled model turns, replace thinking_budget with thinking_level, and audit function calling. On 3.8 Flash with the generateContent API, every FunctionResponse needs call_id and name.