
Gemini 3 Pro Preview Is Being Deprecated: How to Migrate to Gemini 3.1 Pro Before March 9

Google has announced that Gemini 3 Pro Preview will be fully retired on March 9, 2026. If you're using this model through the API — whether directly or via a proxy — you need to migrate to Gemini 3.1 Pro Preview before that date.
Here's what's changing, what you gain from the upgrade, and how to make the switch with minimal effort.
Timeline: What's Happening and When
| Date | Event |
|---|---|
| March 6, 2026 | The gemini-pro-latest alias switches from Gemini 3 Pro to Gemini 3.1 Pro |
| March 9, 2026 | Gemini 3 Pro Preview is fully shut down — all API calls to it will fail |
gemini-pro-latest alias, your model will silently change on March 6. If you hardcode gemini-3-pro-preview, your calls will break on March 9.Who Needs to Take Action?
You need to act if any of the following apply:
- You call
gemini-3-pro-previeworgemini-pro-latestin your API requests - You have pipelines, agents, or automation built on Gemini 3 Pro
- You use
thinking_budgetas a parameter (it's been replaced — more on that below)
gemini-3.1-pro-preview, you're good. No action needed.
Gemini 3.1 Pro vs 3 Pro: What's Actually Different?
This isn't just a version bump. Gemini 3.1 Pro Preview brings meaningful improvements, especially in reasoning.
Reasoning Performance
The headline number: Gemini 3.1 Pro scores 77.1% on ARC-AGI-2, more than double the score of Gemini 3 Pro. This translates to noticeably better performance on tasks that require multi-step logic, data synthesis, and complex code generation.
Input & Output
| Capability | Gemini 3.1 Pro Preview |
|---|---|
| Supported inputs | Text, code, images, video, audio, PDF |
| Context window | 1M tokens |
| Max output | 65K tokens |
Features
Gemini 3.1 Pro supports the full feature set you'd expect from a frontier model:
- Thinking mode — built-in chain-of-thought reasoning
- Function calling — structured tool use
- Structured outputs — JSON schema enforcement
- Code execution — run code in a sandbox
- File search — query over uploaded documents
Breaking Change: thinking_budget → thinking_level
thinking_budget parameter has been replaced by thinking_level.| Old (3 Pro) | New (3.1 Pro) |
|---|---|
thinking_budget: 1024 | thinking_level: "low" |
thinking_budget: 8192 | thinking_level: "medium" |
thinking_budget: 32768 | thinking_level: "high" |
Migration Steps
The migration is straightforward — in most cases it's a one-line change.
Step 1: Update the Model String
Replace:
gemini-3-pro-preview
With:
gemini-3.1-pro-preview
Step 2: Update thinking_budget (If Used)
thinking_budget, switch to thinking_level as shown in the table above.Step 3: Test Your Prompts
Gemini 3.1 Pro is generally better, but outputs may differ. Run your eval suite or spot-check critical prompts before going to production.
Code Example: Calling Gemini 3.1 Pro via EvoLink
https://api.evolink.ai instead of Google's endpoint. No SDK changes needed.curl -X POST "https://api.evolink.ai/v1beta/models/gemini-3.1-pro-preview:generateContent" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "Explain the key differences between TCP and UDP, with examples of when to use each."
}
]
}
]
}'generateContent with streamGenerateContent:curl -X POST "https://api.evolink.ai/v1beta/models/gemini-3.1-pro-preview:streamGenerateContent" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "Write a Python function that finds the longest palindromic substring in O(n) time."
}
]
}
]
}'Why Use EvoLink for Gemini 3.1 Pro?
Pricing
| Plan | Input (≤200K) | Output (≤200K) | vs. Google Direct |
|---|---|---|---|
| Standard | $1.60 / 1M tokens | $9.60 / 1M tokens | 20% cheaper |
| Beta | $0.52 / 1M tokens | $3.12 / 1M tokens | 74% cheaper |
The pricing is identical for both Gemini 3 Pro and 3.1 Pro — so migrating doesn't cost you anything extra.
OpenAI SDK Compatibility
No need to learn a new SDK or rewrite your integration. If you're already using the OpenAI Python/Node SDK, you just point it at EvoLink's endpoint and swap the model name.
Both Models Available During Transition
gemini-3-pro-preview and gemini-3.1-pro-preview, so you can test the new model side-by-side before the March 9 deadline.TL;DR
- Gemini 3 Pro Preview dies March 9, 2026. The
gemini-pro-latestalias switches to 3.1 Pro on March 6. - Gemini 3.1 Pro is a significant upgrade — 2x+ reasoning performance, same feature set, same pricing.
- Migration is a one-line change in most cases: swap
gemini-3-pro-preview→gemini-3.1-pro-preview. - Watch for
thinking_budget→thinking_levelif you use the thinking feature. - EvoLink supports both models now, with pricing up to 74% below Google's direct rates.


