Agent Upstart

Cool things people are building with agents — and practical help getting the most out of them.

Playbooks · Coding

Gemini Embedding 2: update your model string

Written November 11, 2026

If your code still names gemini-embedding-2-preview, it now runs on the stable model at the stable model's rates. Change the model string.

What changed on November 6

Google's Gemini API changelog records the change under November 6, 2026: gemini-embedding-2-preview is deprecated, and from that date API requests to it route to gemini-embedding-2 at Gemini Embedding 2 rates. The deprecations page lists the same routing. The stable model uses the same API schema, pricing, and embedding space, so Google says no other code changes or vector re-indexing are needed. The remaining step is updating the model string before the preview name is retired, on a date Google has not given.

What to do

Search your code and configuration for gemini-embedding-2-preview and replace it with gemini-embedding-2. The routing means a missed string still works for now, which is exactly why it is easy to leave in place and forget. Update it while the change is in front of you.

The two questions Google does not answer

Google says no re-indexing is needed, but the changelog does not say whether preview vectors and stable vectors are compatible in one index. An index that mixes vectors made by the two models can return unreliable similarity scores, and Google does not say the vectors are compatible. If your index holds preview vectors, treat mixing as unproven until Google says otherwise, and re-embed rather than assume.

The second gap is the retirement date. Google has not said when, or whether, the preview model string stops being accepted. The routing has no published end date, so the model string change is the safe step and the only one with a clear answer.

Related deprecations

The same changelog carries the Gemini 2.5 rerouting: from December 1, 2026, requests to gemini-2.5-pro route to gemini-3.8-flash and requests to gemini-2.5-flash route to gemini-3.5-flash-lite. That is covered on the Gemini 2.5 deprecation page, not here. The November 17 shutdowns of the TTS and audio previews are covered on the Gemini November 17 shutdowns page.

Limits

Related playbooks

Sources

Back to: Coding playbooks hub · Also: Gemini 2.5 Pro and Flash retire December 1 · Gemini's Nov 17 shutdowns: Gems and voices · GPT Image 2 shuts down Feb 10, 2027