Backport: chore(provider/xai): remove obsolete Grok 2 models now that they are shut down in their API (#13273)

vercel-ai-sdk[bot] · felixarntz · web-flow · commit 55ccbe24f22c · 2026-03-09T19:01:11.000Z
This is an automated backport of #13271 to the release-v6.0 branch. FYI @felixarntz Co-authored-by: Felix Arntz <felix.arntz@vercel.com>
diff --git a/.changeset/cuddly-roses-collect.md b/.changeset/cuddly-roses-collect.md
@@ -0,0 +1,6 @@
+---
+'@ai-sdk/gateway': patch
+'@ai-sdk/xai': patch
+---
+
+chore(provider/xai): remove obsolete Grok 2 models now that they are shut down in their API
diff --git a/content/docs/02-foundations/02-providers-and-models.mdx b/content/docs/02-foundations/02-providers-and-models.mdx
@@ -113,7 +113,6 @@ Here are the capabilities of popular models:
 | [xAI Grok](/providers/ai-sdk-providers/xai)        | `grok-4`                                    | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [xAI Grok](/providers/ai-sdk-providers/xai)        | `grok-3`                                    | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [xAI Grok](/providers/ai-sdk-providers/xai)        | `grok-3-mini`                               | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
-| [xAI Grok](/providers/ai-sdk-providers/xai)        | `grok-2-vision-1212`                        | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [Vercel](/providers/ai-sdk-providers/vercel)       | `v0-1.0-md`                                 | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5.2-pro`                               | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [OpenAI](/providers/ai-sdk-providers/openai)       | `gpt-5.2-chat-latest`                       | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
diff --git a/content/docs/03-ai-sdk-core/35-image-generation.mdx b/content/docs/03-ai-sdk-core/35-image-generation.mdx
@@ -284,7 +284,6 @@ for (const file of result.files) {
 
 | Provider                                                                        | Model                                                        | Support sizes (`width x height`) or aspect ratios (`width : height`)                                                                                                |
 | ------------------------------------------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [xAI Grok](/providers/ai-sdk-providers/xai#image-models)                        | `grok-2-image`                                               | `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `2:1`, `1:2`, `19.5:9`, `9:19.5`, `20:9`, `9:20`, `auto`                                                         |
 | [xAI Grok](/providers/ai-sdk-providers/xai#image-models)                        | `grok-imagine-image`                                         | `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `2:1`, `1:2`, `19.5:9`, `9:19.5`, `20:9`, `9:20`, `auto`                                                         |
 | [OpenAI](/providers/ai-sdk-providers/openai#image-models)                       | `gpt-image-1`                                                | 1024x1024, 1536x1024, 1024x1536                                                                                                                                     |
 | [OpenAI](/providers/ai-sdk-providers/openai#image-models)                       | `dall-e-3`                                                   | 1024x1024, 1792x1024, 1024x1792                                                                                                                                     |
diff --git a/content/providers/01-ai-sdk-providers/01-xai.mdx b/content/providers/01-ai-sdk-providers/01-xai.mdx
@@ -164,7 +164,7 @@ import { xai } from '@ai-sdk/xai';
 import { generateText } from 'ai';
 
 const { text } = await generateText({
-  model: xai.responses('grok-2-vision-1212'),
+  model: xai.responses('grok-3'),
   messages: [
     {
       role: 'user',
@@ -781,9 +781,6 @@ console.log('Sources:', await result.sources);
 | `grok-3-latest`               | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Cross size={18} /> |
 | `grok-3-mini`                 | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | `grok-3-mini-latest`          | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
-| `grok-2-vision`               | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Cross size={18} /> |
-| `grok-2-vision-latest`        | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Cross size={18} /> |
-| `grok-2-vision-1212`          | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Cross size={18} /> |
 
 <Note>
   The table above lists popular models. Please see the [xAI
@@ -800,7 +797,7 @@ import { xai } from '@ai-sdk/xai';
 import { generateImage } from 'ai';
 
 const { image } = await generateImage({
-  model: xai.image('grok-2-image'),
+  model: xai.image('grok-imagine-image'),
   prompt: 'A futuristic cityscape at sunset',
 });
 ```
@@ -813,7 +810,7 @@ const { image } = await generateImage({
 
 ### Image Editing
 
-xAI supports image editing through the `grok-2-image` and `grok-imagine-image` models. Pass input images via `prompt.images` to transform or edit existing images.
+xAI supports image editing through the `grok-imagine-image` model. Pass input images via `prompt.images` to transform or edit existing images.
 
 <Note>
   xAI image editing does not support masks. Editing is prompt-driven - describe
@@ -832,7 +829,7 @@ import { readFileSync } from 'fs';
 const imageBuffer = readFileSync('./input-image.png');
 
 const { images } = await generateImage({
-  model: xai.image('grok-2-image'),
+  model: xai.image('grok-imagine-image'),
   prompt: {
     text: 'Turn the cat into a golden retriever dog',
     images: [imageBuffer],
@@ -869,7 +866,7 @@ Apply artistic styles to an image:
 const imageBuffer = readFileSync('./input-image.png');
 
 const { images } = await generateImage({
-  model: xai.image('grok-2-image'),
+  model: xai.image('grok-imagine-image'),
   prompt: {
     text: 'Transform this into a watercolor painting style',
     images: [imageBuffer],
@@ -892,7 +889,7 @@ import { xai } from '@ai-sdk/xai';
 import { generateImage } from 'ai';
 
 const { images } = await generateImage({
-  model: xai.image('grok-2-image'),
+  model: xai.image('grok-imagine-image'),
   prompt: 'A futuristic cityscape at sunset',
   aspectRatio: '16:9',
   n: 2,
@@ -903,7 +900,6 @@ const { images } = await generateImage({
 
 | Model                | Aspect Ratios                                                                                               | Image Editing       |
 | -------------------- | ----------------------------------------------------------------------------------------------------------- | ------------------- |
-| `grok-2-image`       | `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `2:1`, `1:2`, `19.5:9`, `9:19.5`, `20:9`, `9:20`, `auto` | <Check size={18} /> |
 | `grok-imagine-image` | `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`, `2:1`, `1:2`, `19.5:9`, `9:19.5`, `20:9`, `9:20`, `auto` | <Check size={18} /> |
 
 ## Video Models
diff --git a/content/providers/01-ai-sdk-providers/index.mdx b/content/providers/01-ai-sdk-providers/index.mdx
@@ -23,7 +23,6 @@ Not all providers support all AI SDK features. Here's a quick comparison of the
 | [xAI Grok](/providers/ai-sdk-providers/xai)                              | `grok-4`                                            | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [xAI Grok](/providers/ai-sdk-providers/xai)                              | `grok-3`                                            | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [xAI Grok](/providers/ai-sdk-providers/xai)                              | `grok-3-mini`                                       | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
-| [xAI Grok](/providers/ai-sdk-providers/xai)                              | `grok-2-vision-1212`                                | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [Vercel](/providers/ai-sdk-providers/vercel)                             | `v0-1.0-md`                                         | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [OpenAI](/providers/ai-sdk-providers/openai)                             | `gpt-5.2-pro`                                       | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | [OpenAI](/providers/ai-sdk-providers/openai)                             | `gpt-5.2`                                           | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> | <Check size={18} /> |
diff --git a/examples/ai-functions/src/e2e/xai.test.ts b/examples/ai-functions/src/e2e/xai.test.ts
@@ -28,9 +28,7 @@ createFeatureTestSuite({
       createChatModel('grok-3-mini-beta'),
       createChatModel('grok-3-mini-fast-beta'),
       createChatModel('grok-3'),
-      createChatModel('grok-2-vision-1212'),
       createCompletionModel('grok-3'),
-      createCompletionModel('grok-2-vision-1212'),
     ],
   },
   timeout: 30000,
diff --git a/examples/ai-functions/src/generate-image/xai/basic.ts b/examples/ai-functions/src/generate-image/xai/basic.ts
@@ -5,7 +5,7 @@ import { run } from '../../lib/run';
 
 run(async () => {
   const { image } = await generateImage({
-    model: xai.image('grok-2-image-1212'),
+    model: xai.image('grok-imagine-image'),
     prompt: 'A salamander at dusk in a forest pond surrounded by fireflies.',
   });
 
diff --git a/examples/ai-functions/src/generate-image/xai/many.ts b/examples/ai-functions/src/generate-image/xai/many.ts
@@ -5,7 +5,7 @@ import { run } from '../../lib/run';
 
 run(async () => {
   const { images } = await generateImage({
-    model: xai.image('grok-2-image'),
+    model: xai.image('grok-imagine-image'),
     n: 3,
     prompt: 'A chicken flying into the sunset in the style of anime.',
   });
diff --git a/examples/ai-functions/src/generate-text/gateway/image-base64.ts b/examples/ai-functions/src/generate-text/gateway/image-base64.ts
@@ -4,7 +4,7 @@ import { run } from '../../lib/run';
 
 run(async () => {
   const result = await generateText({
-    model: 'xai/grok-2-vision',
+    model: 'xai/grok-3',
     messages: [
       {
         role: 'user',
diff --git a/examples/ai-functions/src/generate-text/gateway/image-data-url.ts b/examples/ai-functions/src/generate-text/gateway/image-data-url.ts
@@ -9,7 +9,7 @@ run(async () => {
   const dataUrl = `data:image/png;base64,${base64Data}`;
 
   const result = await generateText({
-    model: 'xai/grok-2-vision',
+    model: 'xai/grok-3',
     messages: [
       {
         role: 'user',
diff --git a/examples/ai-functions/src/generate-text/gateway/image-url.ts b/examples/ai-functions/src/generate-text/gateway/image-url.ts
@@ -3,7 +3,7 @@ import { run } from '../../lib/run';
 
 run(async () => {
   const result = await generateText({
-    model: 'xai/grok-2-vision',
+    model: 'xai/grok-3',
     messages: [
       {
         role: 'user',
diff --git a/examples/ai-functions/src/generate-text/xai/responses-image.ts b/examples/ai-functions/src/generate-text/xai/responses-image.ts
@@ -5,7 +5,7 @@ import { run } from '../../lib/run';
 
 run(async () => {
   const result = await generateText({
-    model: xai.responses('grok-2-vision-1212'),
+    model: xai.responses('grok-3'),
     messages: [
       {
         role: 'user',
diff --git a/examples/ai-functions/src/stream-text/xai/image.ts b/examples/ai-functions/src/stream-text/xai/image.ts
@@ -5,7 +5,7 @@ import { run } from '../../lib/run';
 
 run(async () => {
   const result = streamText({
-    model: xai('grok-2-vision-1212'),
+    model: xai('grok-3'),
     messages: [
       {
         role: 'user',
diff --git a/examples/ai-functions/src/stream-text/xai/responses-image.ts b/examples/ai-functions/src/stream-text/xai/responses-image.ts
@@ -5,7 +5,7 @@ import { run } from '../../lib/run';
 
 run(async () => {
   const result = streamText({
-    model: xai.responses('grok-2-vision-1212'),
+    model: xai.responses('grok-3'),
     messages: [
       {
         role: 'user',
diff --git a/packages/gateway/src/gateway-language-model-settings.ts b/packages/gateway/src/gateway-language-model-settings.ts
@@ -150,7 +150,6 @@ export type GatewayModelId =
   | 'prime-intellect/intellect-3'
   | 'vercel/v0-1.0-md'
   | 'vercel/v0-1.5-md'
-  | 'xai/grok-2-vision'
   | 'xai/grok-3'
   | 'xai/grok-3-fast'
   | 'xai/grok-3-mini'
diff --git a/packages/xai/src/xai-chat-options.ts b/packages/xai/src/xai-chat-options.ts
@@ -14,12 +14,6 @@ export type XaiChatModelId =
   | 'grok-3-latest'
   | 'grok-3-mini'
   | 'grok-3-mini-latest'
-  | 'grok-2-vision-1212'
-  | 'grok-2-vision'
-  | 'grok-2-vision-latest'
-  | 'grok-2-image-1212'
-  | 'grok-2-image'
-  | 'grok-2-image-latest'
   | (string & {});
 
 // search source schemas
diff --git a/packages/xai/src/xai-image-model.test.ts b/packages/xai/src/xai-image-model.test.ts
@@ -13,7 +13,7 @@ function createModel({
   headers?: () => Record<string, string>;
   currentDate?: () => Date;
 } = {}) {
-  return new XaiImageModel('grok-2-image-1212', {
+  return new XaiImageModel('grok-imagine-image', {
     provider: 'xai.image',
     baseURL: 'https://api.example.com',
     headers: headers ?? (() => ({ 'api-key': 'test-key' })),
@@ -48,7 +48,7 @@ describe('XaiImageModel', () => {
       const model = createModel();
 
       expect(model.provider).toBe('xai.image');
-      expect(model.modelId).toBe('grok-2-image-1212');
+      expect(model.modelId).toBe('grok-imagine-image');
       expect(model.specificationVersion).toBe('v3');
       expect(model.maxImagesPerCall).toBe(3);
     });
@@ -74,7 +74,7 @@ describe('XaiImageModel', () => {
         'https://api.example.com/images/generations',
       );
       expect(await server.calls[0].requestBodyJson).toStrictEqual({
-        model: 'grok-2-image-1212',
+        model: 'grok-imagine-image',
         prompt,
         n: 1,
         response_format: 'b64_json',
@@ -107,7 +107,7 @@ describe('XaiImageModel', () => {
         'https://api.example.com/images/edits',
       );
       expect(await server.calls[0].requestBodyJson).toStrictEqual({
-        model: 'grok-2-image-1212',
+        model: 'grok-imagine-image',
         prompt: 'Turn the cat into a dog',
         n: 1,
         response_format: 'b64_json',
@@ -138,7 +138,7 @@ describe('XaiImageModel', () => {
       });
 
       expect(await server.calls[0].requestBodyJson).toStrictEqual({
-        model: 'grok-2-image-1212',
+        model: 'grok-imagine-image',
         prompt: 'Edit this image',
         n: 1,
         response_format: 'b64_json',
@@ -170,7 +170,7 @@ describe('XaiImageModel', () => {
       });
 
       expect(await server.calls[0].requestBodyJson).toStrictEqual({
-        model: 'grok-2-image-1212',
+        model: 'grok-imagine-image',
         prompt: 'Edit this image',
         n: 1,
         response_format: 'b64_json',
@@ -212,7 +212,7 @@ describe('XaiImageModel', () => {
         'https://api.example.com/images/edits',
       );
       expect(await server.calls[0].requestBodyJson).toStrictEqual({
-        model: 'grok-2-image-1212',
+        model: 'grok-imagine-image',
         prompt: 'Combine these images',
         n: 1,
         response_format: 'b64_json',
@@ -254,7 +254,7 @@ describe('XaiImageModel', () => {
       });
 
       expect(await server.calls[0].requestBodyJson).toStrictEqual({
-        model: 'grok-2-image-1212',
+        model: 'grok-imagine-image',
         prompt: 'Combine these images',
         n: 1,
         response_format: 'b64_json',
@@ -337,7 +337,7 @@ describe('XaiImageModel', () => {
       });
 
       expect(await server.calls[0].requestBodyJson).toStrictEqual({
-        model: 'grok-2-image-1212',
+        model: 'grok-imagine-image',
         prompt,
         n: 1,
         response_format: 'b64_json',
@@ -365,7 +365,7 @@ describe('XaiImageModel', () => {
       });
 
       expect(await server.calls[0].requestBodyJson).toStrictEqual({
-        model: 'grok-2-image-1212',
+        model: 'grok-imagine-image',
         prompt,
         n: 1,
         response_format: 'b64_json',
@@ -392,7 +392,7 @@ describe('XaiImageModel', () => {
       });
 
       expect(await server.calls[0].requestBodyJson).toStrictEqual({
-        model: 'grok-2-image-1212',
+        model: 'grok-imagine-image',
         prompt,
         n: 1,
         response_format: 'b64_json',
@@ -419,7 +419,7 @@ describe('XaiImageModel', () => {
       });
 
       expect(await server.calls[0].requestBodyJson).toStrictEqual({
-        model: 'grok-2-image-1212',
+        model: 'grok-imagine-image',
         prompt,
         n: 1,
         response_format: 'b64_json',
@@ -475,7 +475,7 @@ describe('XaiImageModel', () => {
 
         expect(result.response).toStrictEqual({
           timestamp: testDate,
-          modelId: 'grok-2-image-1212',
+          modelId: 'grok-imagine-image',
           headers: expect.any(Object),
         });
       });
diff --git a/packages/xai/src/xai-image-settings.ts b/packages/xai/src/xai-image-settings.ts
@@ -1,6 +1,4 @@
 export type XaiImageModelId =
-  | 'grok-2-image'
-  | 'grok-2-image-1212'
   | 'grok-imagine-image'
   | 'grok-imagine-image-pro'
   | (string & {});
diff --git a/packages/xai/src/xai-provider.test.ts b/packages/xai/src/xai-provider.test.ts
@@ -115,7 +115,7 @@ describe('xAIProvider', () => {
   describe('imageModel', () => {
     it('should construct an image model with correct configuration', () => {
       const provider = createXai();
-      const modelId = 'grok-2-image';
+      const modelId = 'grok-imagine-image';
 
       const model = provider.imageModel(modelId);
 
@@ -132,7 +132,7 @@ describe('xAIProvider', () => {
     it('should use custom baseURL for image model', () => {
       const customBaseURL = 'https://custom.xai.api';
       const provider = createXai({ baseURL: customBaseURL });
-      const modelId = 'grok-2-image';
+      const modelId = 'grok-imagine-image';
 
       provider.imageModel(modelId);
 
@@ -145,7 +145,7 @@ describe('xAIProvider', () => {
       const customHeaders = { 'Custom-Header': 'test-value' };
       const provider = createXai({ headers: customHeaders });
 
-      provider.imageModel('grok-2-image-1212');
+      provider.imageModel('grok-imagine-image');
 
       const constructorCall = XaiImageModelMock.mock.calls[0];
       const config = constructorCall[1];

Original file line number	Diff line number	Diff line change
`@@ -4,7 +4,7 @@ import { run } from '../../lib/run';`
`4`	`4`
`5`	`5`	`run(async () => {`
`6`	`6`	`const result = await generateText({`
`7`		`- model: 'xai/grok-2-vision',`
	`7`	`+ model: 'xai/grok-3',`
`8`	`8`	`messages: [`
`9`	`9`	`{`
`10`	`10`	`role: 'user',`
Original file line number	Diff line number	Diff line change
`@@ -9,7 +9,7 @@ run(async () => {`
`9`	`9`	const dataUrl = `data:image/png;base64,${base64Data}`;
`10`	`10`
`11`	`11`	`const result = await generateText({`
`12`		`- model: 'xai/grok-2-vision',`
	`12`	`+ model: 'xai/grok-3',`
`13`	`13`	`messages: [`
`14`	`14`	`{`
`15`	`15`	`role: 'user',`