fix(google-vertex): allow 'vertex' as a key for providerOptions

.changeset/serious-jars-train.md

@@ -0,0 +1,6 @@
+---
+'@ai-sdk/google-vertex': patch
+'@ai-sdk/google': patch
+---
+
+fix(vertex): allow 'vertex' as a key for providerOptions

content/docs/08-migration-guides/24-migration-guide-6-0.mdx

@@ -478,6 +478,52 @@ const result = await generateObject({
 });
 ```
 
+### Google Vertex
+
+#### `providerMetadata` and `providerOptions` Key
+
+The `@ai-sdk/google-vertex` provider now uses `vertex` as the key for `providerMetadata` and `providerOptions` instead of `google`. The `google` key is still supported for `providerOptions` input, but resulting `providerMetadata` output now uses `vertex`.
+
+```tsx filename="AI SDK 5"
+import { vertex } from '@ai-sdk/google-vertex';
+import { generateText } from 'ai';
+
+const result = await generateText({
+  model: vertex('gemini-2.5-flash'),
+  providerOptions: {
+    google: {
+      safetySettings: [
+        /* ... */
+      ],
+    }, // Used 'google' key
+  },
+  prompt: 'Hello',
+});
+
+// Accessed metadata via 'google' key
+console.log(result.providerMetadata?.google?.safetyRatings);
+```
+
+```tsx filename="AI SDK 6"
+import { vertex } from '@ai-sdk/google-vertex';
+import { generateText } from 'ai';
+
+const result = await generateText({
+  model: vertex('gemini-2.5-flash'),
+  providerOptions: {
+    vertex: {
+      safetySettings: [
+        /* ... */
+      ],
+    }, // Now uses 'vertex' key
+  },
+  prompt: 'Hello',
+});
+
+// Access metadata via 'vertex' key
+console.log(result.providerMetadata?.vertex?.safetyRatings);
+```
+
 ## `ai/test`
 
 ### Mock Classes

examples/ai-core/src/generate-text/google-vertex-safety.ts

@@ -4,9 +4,9 @@ import 'dotenv/config';
 
 async function main() {
   const result = await generateText({
-    model: vertex('gemini-1.5-pro'),
+    model: vertex('gemini-2.5-flash'),
     providerOptions: {
-      google: {
+      vertex: {
         safetySettings: [
           {
             category: 'HARM_CATEGORY_UNSPECIFIED',
@@ -22,6 +22,8 @@ async function main() {
   console.log();
   console.log('Token usage:', result.usage);
   console.log('Finish reason:', result.finishReason);
+  console.log();
+  console.log('Request body:', result.request?.body);
 }
 
 main().catch(console.error);

packages/google-vertex/src/google-vertex-embedding-model.test.ts

@@ -138,6 +138,27 @@ describe('GoogleVertexEmbeddingModel', () => {
     });
   });
 
+  it('should accept vertex as provider options key', async () => {
+    prepareJsonResponse();
+
+    await model.doEmbed({
+      values: testValues,
+      providerOptions: { vertex: mockProviderOptions },
+    });
+
+    expect(await server.calls[0].requestBodyJson).toStrictEqual({
+      instances: testValues.map(value => ({
+        content: value,
+        task_type: mockProviderOptions.taskType,
+        title: mockProviderOptions.title,
+      })),
+      parameters: {
+        outputDimensionality: mockProviderOptions.outputDimensionality,
+        autoTruncate: mockProviderOptions.autoTruncate,
+      },
+    });
+  });
+
   it('should pass the taskType setting in instances', async () => {
     prepareJsonResponse();
 

packages/google-vertex/src/google-vertex-embedding-model.ts

@@ -45,13 +45,21 @@ export class GoogleVertexEmbeddingModel implements EmbeddingModelV3 {
   }: Parameters<EmbeddingModelV3['doEmbed']>[0]): Promise<
     Awaited<ReturnType<EmbeddingModelV3['doEmbed']>>
   > {
-    // Parse provider options
-    const googleOptions =
-      (await parseProviderOptions({
+    let googleOptions = await parseProviderOptions({
+      provider: 'vertex',
+      providerOptions,
+      schema: googleVertexEmbeddingProviderOptions,
+    });
+
+    if (googleOptions == null) {
+      googleOptions = await parseProviderOptions({
         provider: 'google',
         providerOptions,
         schema: googleVertexEmbeddingProviderOptions,
-      })) ?? {};
+      });
+    }
+
+    googleOptions = googleOptions ?? {};
 
     if (values.length > this.maxEmbeddingsPerCall) {
       throw new TooManyEmbeddingValuesForCallError({