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
- The preview name still works because requests route to the stable model. There is no published date for when that stops.
- Vector compatibility between the preview and stable models is not stated by Google. Do not mix old preview vectors with new stable vectors in one index on an assumption.
Related playbooks
- Gemini Decision: a model and API for choices
- Gemini 2.5 Pro and Flash retire December 1
- Gemini CLI 0.68 preview: extension checks
- Gemini CLI 0.69.0-preview.0: /stats heatmap for token use
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