feat(provider/google): add support for gemini-3.1-pro-preview (#12695)

## Background

Google released `gemini-3.1-pro-preview`, which needs to be added to the
AI SDK provider packages and documentation.

See:
https://blog.google/innovation-and-ai/models-and-research/gemini-models/gemini-3-1-pro/

## Summary

Adds `gemini-3.1-pro-preview` as a supported model ID to
`@ai-sdk/google`, `@ai-sdk/google-vertex`, and `@ai-sdk/gateway`, and
updates documentation and examples to reference the new model where it
makes sense. Updates `thinkingLevel` docs to note that Gemini 3.1 Pro
supports 'low', 'medium', and 'high' levels.

## Manual Verification

N/A

## Checklist

- [x] Tests have been added / updated (for bug fixes / features)
- [x] Documentation has been added / updated (for bug fixes / features)
- [x] A _patch_ changeset for relevant packages has been added (for bug
fixes / features - run `pnpm changeset` in the project root)
- [x] I have reviewed this pull request (self-review)

## Future Work

N/A

## Related Issues

N/A

Author: felixarntz

.changeset/flat-olives-talk.md

@@ -0,0 +1,7 @@
+---
+'@ai-sdk/google-vertex': patch
+'@ai-sdk/gateway': patch
+'@ai-sdk/google': patch
+---
+
+feat(provider/google): add support for `gemini-3.1-pro-preview`

content/providers/01-ai-sdk-providers/15-google-generative-ai.mdx

@@ -180,7 +180,7 @@ The following optional provider options are available for Google Generative AI m
 
   - **thinkingLevel** _'minimal' | 'low' | 'medium' | 'high'_
 
-    Optional. Controls the thinking depth for Gemini 3 models. Gemini 3 Pro supports 'low' and 'high', while Gemini 3 Flash supports all four levels: 'minimal', 'low', 'medium', and 'high'. Only supported by Gemini 3 models (`gemini-3-pro-preview` and later).
+    Optional. Controls the thinking depth for Gemini 3 models. Gemini 3.1 Pro supports 'low', 'medium', and 'high', Gemini 3 Pro supports 'low' and 'high', while Gemini 3 Flash supports all four levels: 'minimal', 'low', 'medium', and 'high'. Only supported by Gemini 3 models.
 
   - **thinkingBudget** _number_
 
@@ -261,7 +261,7 @@ For Gemini 3 models, use the `thinkingLevel` parameter to control the depth of r
 import { google, GoogleLanguageModelOptions } from '@ai-sdk/google';
 import { generateText } from 'ai';
 
-const model = google('gemini-3-pro-preview');
+const model = google('gemini-3.1-pro-preview');
 
 const { text, reasoning } = await generateText({
   model: model,
@@ -1045,6 +1045,7 @@ The following Zod features are known to not work with Google Generative AI:
 
 | Model                                 | Image Input         | Object Generation   | Tool Usage          | Tool Streaming      | Google Search       | URL Context         |
 | ------------------------------------- | ------------------- | ------------------- | ------------------- | ------------------- | ------------------- | ------------------- |
+| `gemini-3.1-pro-preview`              | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | `gemini-3-pro-preview`                | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | `gemini-3-pro-image-preview`          | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | `gemini-3-flash-preview`              | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |

content/providers/01-ai-sdk-providers/index.mdx

@@ -45,9 +45,11 @@ Not all providers support all AI SDK features. Here's a quick comparison of the
 | [Anthropic](/providers/ai-sdk-providers/anthropic)                       | `claude-sonnet-4-0`                                 | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [Anthropic](/providers/ai-sdk-providers/anthropic)                       | `claude-3-7-sonnet-latest`                          | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [Anthropic](/providers/ai-sdk-providers/anthropic)                       | `claude-3-5-haiku-latest`                           | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
+| [Google Generative AI](/providers/ai-sdk-providers/google-generative-ai) | `gemini-3.1-pro-preview`                            | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [Google Generative AI](/providers/ai-sdk-providers/google-generative-ai) | `gemini-3-pro-preview`                              | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [Google Generative AI](/providers/ai-sdk-providers/google-generative-ai) | `gemini-2.5-pro`                                    | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [Google Generative AI](/providers/ai-sdk-providers/google-generative-ai) | `gemini-2.5-flash`                                  | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
+| [Google Vertex](/providers/ai-sdk-providers/google-vertex)               | `gemini-3.1-pro-preview`                            | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [Google Vertex](/providers/ai-sdk-providers/google-vertex)               | `gemini-3-pro-preview`                              | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [Google Vertex](/providers/ai-sdk-providers/google-vertex)               | `gemini-2.5-pro`                                    | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [Google Vertex](/providers/ai-sdk-providers/google-vertex)               | `gemini-2.5-flash`                                  | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |

content/providers/03-community-providers/18-gemini-cli.mdx

@@ -94,7 +94,7 @@ const model = gemini('gemini-2.5-pro');
 
 Supported models:
 
-- **gemini-3-pro-preview**: Latest model with enhanced reasoning (supports `thinkingLevel`)
+- **gemini-3.1-pro-preview**: Latest model with enhanced reasoning (supports `thinkingLevel`)
 - **gemini-3-flash-preview**: Fast Gemini 3 model (supports `thinkingLevel`)
 - **gemini-2.5-pro**: Production-ready model with 64K output tokens (supports `thinkingBudget`)
 - **gemini-2.5-flash**: Fast, efficient model with 64K output tokens (supports `thinkingBudget`)
@@ -118,7 +118,7 @@ const { text } = await generateText({
 ### Model Settings
 
 ```ts
-const model = gemini('gemini-3-pro-preview', {
+const model = gemini('gemini-3.1-pro-preview', {
   temperature: 0.7,
   topP: 0.95,
   topK: 40,
@@ -135,6 +135,7 @@ const model = gemini('gemini-3-pro-preview', {
 
 | Model                    | Image Input         | Object Generation   | Tool Usage          | Tool Streaming      |
 | ------------------------ | ------------------- | ------------------- | ------------------- | ------------------- |
+| `gemini-3.1-pro-preview` | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | `gemini-3-pro-preview`   | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | `gemini-3-flash-preview` | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | `gemini-2.5-pro`         | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |

content/providers/03-community-providers/31-opencode-sdk.mdx

@@ -92,7 +92,7 @@ opencode(OpencodeModels['gpt-4o']); // openai/gpt-4o
 opencode(OpencodeModels['gpt-4o-mini']); // openai/gpt-4o-mini
 
 // Google Gemini
-opencode(OpencodeModels['gemini-3-pro']); // google/gemini-3-pro-preview
+opencode(OpencodeModels['gemini-3.1-pro-preview']); // google/gemini-3.1-pro-preview
 opencode(OpencodeModels['gemini-2.5-pro']); // google/gemini-2.5-pro
 opencode(OpencodeModels['gemini-2.5-flash']); // google/gemini-2.5-flash
 opencode(OpencodeModels['gemini-2.0-flash']); // google/gemini-2.0-flash
@@ -103,7 +103,7 @@ You can also use full model identifiers:
 ```ts
 opencode('openai/gpt-5.1-codex');
 opencode('openai/gpt-5.1-codex-max');
-opencode('google/gemini-3-pro-preview');
+opencode('google/gemini-3.1-pro-preview');
 ```
 
 ### Example

content/providers/03-community-providers/47-apertis.mdx

@@ -63,7 +63,7 @@ const model = apertis.chat('claude-sonnet-4.5');
 
 - **OpenAI**: `gpt-5.2`, `gpt-5.2-chat`, `gpt-5.2-pro`
 - **Anthropic**: `claude-opus-4-5-20251101`, `claude-sonnet-4.5`, `claude-haiku-4.5`
-- **Google**: `gemini-3-pro-preview`, `gemini-3-flash-preview`, `gemini-2.5-pro`
+- **Google**: `gemini-3.1-pro-preview`, `gemini-3-flash-preview`, `gemini-2.5-pro`
 - **Other**: `glm-4.7`, `minimax-m2.1`, and 470+ more
 
 ## Embedding Models

content/providers/03-community-providers/49-cencori.mdx

@@ -64,7 +64,7 @@ const opus = cencori('claude-3-opus');
 
 // Google Gemini models
 const gemini = cencori('gemini-2.5-flash');
-const geminiPro = cencori('gemini-3-pro');
+const geminiPro = cencori('gemini-3.1-pro-preview');
 
 // Other providers
 const mistral = cencori('mistral-large');

examples/ai-functions/src/generate-text/google-vertex-tool-call.ts

@@ -5,7 +5,7 @@ import { run } from '../lib/run';
 
 run(async () => {
   const { text } = await generateText({
-    model: vertex('gemini-3-pro-preview'),
+    model: vertex('gemini-3.1-pro-preview'),
     prompt: 'What is the weather in New York City? ',
     tools: {
       weather: tool({

examples/ai-functions/src/generate-text/openai-compatible-google-thought-signatures.ts

@@ -12,7 +12,7 @@ run(async () => {
     },
   });
 
-  const model = googleOpenAI.chatModel('gemini-3-pro-preview');
+  const model = googleOpenAI.chatModel('gemini-3.1-pro-preview');
 
   const tools = {
     check_flight: tool({

examples/ai-functions/src/stream-text/google-multiturn-tool-error.ts

@@ -15,7 +15,7 @@ run(async () => {
 
   console.log('=== turn 1: tool call that will naturally fail ===');
   const turn1 = streamText({
-    model: google('gemini-3-pro-preview'),
+    model: google('gemini-3.1-pro-preview'),
     tools: {
       readuserdata: tool({
         description: 'read user data from file',
@@ -127,7 +127,7 @@ run(async () => {
 
   try {
     const turn2 = streamText({
-      model: google('gemini-3-pro-preview'),
+      model: google('gemini-3.1-pro-preview'),
       messages: messagesForTurn2,
       includeRawChunks: true,
       tools: {
@@ -181,7 +181,7 @@ run(async () => {
     ];
 
     const turn3 = streamText({
-      model: google('gemini-3-pro-preview'),
+      model: google('gemini-3.1-pro-preview'),
       messages: messagesForTurn3,
       includeRawChunks: true,
       tools: {