apiwatch

All changes / Google

Breaking model

From December 1, 2026, Gemini API requests for the deprecated gemini-2.5-pro are routed to gemini-3.8-flash, where prefilled model turns return HTTP 400.

Takes effect · Gemini API model gemini-2.5-pro

Reviewed against the vendor source on Nov 11, 2026 (AI-assisted review). Key facts are re-checked against the source daily.

What changes

Google's November 2, 2026 changelog says gemini-2.5-pro is deprecated and no longer selectable in Google AI Studio, and that 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. The deprecations page lists gemini-2.5-pro (released June 17, 2025) with a shutdown date of December 1, 2026 and gemini-3.8-flash as the replacement, and says API access is limited to existing users who have actively used it. Google lists breaking API changes for the move, including function calling and thought_signature validation, thinking_level replacing thinking_budget, and removed sampling parameters and prefilled model turns. Google's API changes guide says that on gemini-3.8-flash and later models a request whose last non-empty turn is a model turn returns HTTP 400 and temperature, top_p and top_k are ignored, and Google tells callers to review these breaking changes before December 1, 2026.

Breaking: Calls fail after this date.

What to do

Before December 1, 2026, change the model string from gemini-2.5-pro to gemini-3.8-flash, as Google directs, and follow the Gemini 3.8 Flash migration guide. Replace thinking_budget with thinking_level (minimal is not supported on 3.8 Flash), remove temperature, top_p, top_k and candidate_count, stop prefilling model turns (those requests return HTTP 400), and re-test function calling. Re-run your evals on quality and cost, since a different model will answer.

Strings to search for

gemini-2.5-pro

Not affected (matches inside these are ignored): gemini-2.5-pro-preview, gemini-2.5-pro-exp

Source

https://ai.google.dev/gemini-api/docs/deprecations