@ai-sdk/google 3.0.24 → 3.0.25

package/docs/15-google-generative-ai.mdx

@@ -108,6 +108,8 @@ Google Generative AI also supports some model specific settings that are not par
 You can pass them as an options argument:
 
 ```ts
+import { google, type GoogleLanguageModelOptions } from '@ai-sdk/google';
+
 const model = google('gemini-2.5-flash');
 
 await generateText({
@@ -120,7 +122,7 @@ await generateText({
           threshold: 'BLOCK_LOW_AND_ABOVE',
         },
       ],
-    },
+    } satisfies GoogleLanguageModelOptions,
   },
 });
 ```
@@ -256,7 +258,7 @@ The Gemini 2.5 and Gemini 3 series models use an internal "thinking process" tha
 For Gemini 3 models, use the `thinkingLevel` parameter to control the depth of reasoning:
 
 ```ts
-import { google, GoogleGenerativeAIProviderOptions } from '@ai-sdk/google';
+import { google, GoogleLanguageModelOptions } from '@ai-sdk/google';
 import { generateText } from 'ai';
 
 const model = google('gemini-3-pro-preview');
@@ -270,7 +272,7 @@ const { text, reasoning } = await generateText({
         thinkingLevel: 'high',
         includeThoughts: true,
       },
-    } satisfies GoogleGenerativeAIProviderOptions,
+    } satisfies GoogleLanguageModelOptions,
   },
 });
 
@@ -284,7 +286,7 @@ console.log(reasoning); // Reasoning summary
 For Gemini 2.5 models, use the `thinkingBudget` parameter to control the number of thinking tokens:
 
 ```ts
-import { google, GoogleGenerativeAIProviderOptions } from '@ai-sdk/google';
+import { google, GoogleLanguageModelOptions } from '@ai-sdk/google';
 import { generateText } from 'ai';
 
 const model = google('gemini-2.5-flash');
@@ -298,7 +300,7 @@ const { text, reasoning } = await generateText({
         thinkingBudget: 8192,
         includeThoughts: true,
       },
-    } satisfies GoogleGenerativeAIProviderOptions,
+    } satisfies GoogleLanguageModelOptions,
   },
 });
 
@@ -435,7 +437,7 @@ console.log('Cached tokens:', providerMetadata.google);
 For guaranteed cost savings, you can still use explicit caching with Gemini 2.5 and 2.0 models. See the [models page](https://ai.google.dev/gemini-api/docs/models) to check if caching is supported for the used model:
 
 ```ts
-import { google } from '@ai-sdk/google';
+import { google, type GoogleLanguageModelOptions } from '@ai-sdk/google';
 import { GoogleGenAI } from '@google/genai';
 import { generateText } from 'ai';
 
@@ -465,7 +467,7 @@ const { text: veggieLasagnaRecipe } = await generateText({
   providerOptions: {
     google: {
       cachedContent: cache.name,
-    },
+    } satisfies GoogleLanguageModelOptions,
   },
 });
 
@@ -475,7 +477,7 @@ const { text: meatLasagnaRecipe } = await generateText({
   providerOptions: {
     google: {
       cachedContent: cache.name,
-    },
+    } satisfies GoogleLanguageModelOptions,
   },
 });
 ```
@@ -766,7 +768,7 @@ With [Google Maps grounding](https://ai.google.dev/gemini-api/docs/maps-groundin
 the model has access to Google Maps data for location-aware responses. This enables providing local data and geospatial context, such as finding nearby restaurants.
 
 ```ts highlight="7-16"
-import { google } from '@ai-sdk/google';
+import { google, type GoogleLanguageModelOptions } from '@ai-sdk/google';
 import { GoogleGenerativeAIProviderMetadata } from '@ai-sdk/google';
 import { generateText } from 'ai';
 
@@ -780,7 +782,7 @@ const { text, sources, providerMetadata } = await generateText({
       retrievalConfig: {
         latLng: { latitude: 34.090199, longitude: -117.881081 },
       },
-    },
+    } satisfies GoogleLanguageModelOptions,
   },
   prompt:
     'What are the best Italian restaurants within a 15-minute walk from here?',
@@ -1008,7 +1010,7 @@ const { object } = await generateObject({
   providerOptions: {
     google: {
       structuredOutputs: false,
-    },
+    } satisfies GoogleLanguageModelOptions,
   },
   schema: z.object({
     name: z.string(),
@@ -1099,7 +1101,7 @@ The Google Generative AI provider sends API calls to the right endpoint based on
 Google Generative AI embedding models support aditional settings. You can pass them as an options argument:
 
 ```ts
-import { google } from '@ai-sdk/google';
+import { google, type GoogleEmbeddingModelOptions } from '@ai-sdk/google';
 import { embed } from 'ai';
 
 const model = google.embedding('gemini-embedding-001');
@@ -1111,7 +1113,7 @@ const { embedding } = await embed({
     google: {
       outputDimensionality: 512, // optional, number of dimensions for the embedding
       taskType: 'SEMANTIC_SIMILARITY', // optional, specifies the task type for generating embeddings
-    },
+    } satisfies GoogleEmbeddingModelOptions,
   },
 });
 ```
@@ -1158,11 +1160,11 @@ const { image } = await generateImage({
 });
 ```
 
-Further configuration can be done using Google provider options. You can validate the provider options using the `GoogleGenerativeAIImageProviderOptions` type.
+Further configuration can be done using Google provider options. You can validate the provider options using the `GoogleImageModelOptions` type.
 
 ```ts
 import { google } from '@ai-sdk/google';
-import { GoogleGenerativeAIImageProviderOptions } from '@ai-sdk/google';
+import { GoogleImageModelOptions } from '@ai-sdk/google';
 import { generateImage } from 'ai';
 
 const { image } = await generateImage({
@@ -1170,7 +1172,7 @@ const { image } = await generateImage({
   providerOptions: {
     google: {
       personGeneration: 'dont_allow',
-    } satisfies GoogleGenerativeAIImageProviderOptions,
+    } satisfies GoogleImageModelOptions,
   },
   // ...
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/google",
-  "version": "3.0.24",
+  "version": "3.0.25",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",

package/src/google-generative-ai-embedding-model.ts

@@ -16,7 +16,7 @@ import { z } from 'zod/v4';
 import { googleFailedResponseHandler } from './google-error';
 import {
   GoogleGenerativeAIEmbeddingModelId,
-  googleGenerativeAIEmbeddingProviderOptions,
+  googleEmbeddingModelOptions,
 } from './google-generative-ai-embedding-options';
 
 type GoogleGenerativeAIEmbeddingConfig = {
@@ -57,7 +57,7 @@ export class GoogleGenerativeAIEmbeddingModel implements EmbeddingModelV3 {
     const googleOptions = await parseProviderOptions({
       provider: 'google',
       providerOptions,
-      schema: googleGenerativeAIEmbeddingProviderOptions,
+      schema: googleEmbeddingModelOptions,
     });
 
     if (values.length > this.maxEmbeddingsPerCall) {

package/src/google-generative-ai-embedding-options.ts

@@ -10,7 +10,7 @@ export type GoogleGenerativeAIEmbeddingModelId =
   | 'text-embedding-004'
   | (string & {});
 
-export const googleGenerativeAIEmbeddingProviderOptions = lazySchema(() =>
+export const googleEmbeddingModelOptions = lazySchema(() =>
   zodSchema(
     z.object({
       /**
@@ -47,6 +47,6 @@ export const googleGenerativeAIEmbeddingProviderOptions = lazySchema(() =>
   ),
 );
 
-export type GoogleGenerativeAIEmbeddingProviderOptions = InferSchema<
-  typeof googleGenerativeAIEmbeddingProviderOptions
+export type GoogleEmbeddingModelOptions = InferSchema<
+  typeof googleEmbeddingModelOptions
 >;

package/src/google-generative-ai-image-model.ts

@@ -99,7 +99,7 @@ export class GoogleGenerativeAIImageModel implements ImageModelV3 {
     const googleOptions = await parseProviderOptions({
       provider: 'google',
       providerOptions,
-      schema: googleImageProviderOptionsSchema,
+      schema: googleImageModelOptionsSchema,
     });
 
     const currentDate = this.config._internal?.currentDate?.() ?? new Date();
@@ -168,7 +168,7 @@ const googleImageResponseSchema = lazySchema(() =>
 
 // Note: For the initial GA launch of Imagen 3, safety filters are not configurable.
 // https://ai.google.dev/gemini-api/docs/imagen#imagen-model
-const googleImageProviderOptionsSchema = lazySchema(() =>
+const googleImageModelOptionsSchema = lazySchema(() =>
   zodSchema(
     z.object({
       personGeneration: z
@@ -179,6 +179,6 @@ const googleImageProviderOptionsSchema = lazySchema(() =>
   ),
 );
 
-export type GoogleGenerativeAIImageProviderOptions = InferSchema<
-  typeof googleImageProviderOptionsSchema
+export type GoogleImageModelOptions = InferSchema<
+  typeof googleImageModelOptionsSchema
 >;

package/src/google-generative-ai-language-model.ts

@@ -36,7 +36,7 @@ import { getModelPath } from './get-model-path';
 import { googleFailedResponseHandler } from './google-error';
 import {
   GoogleGenerativeAIModelId,
-  googleGenerativeAIProviderOptions,
+  googleLanguageModelOptions,
 } from './google-generative-ai-options';
 import { GoogleGenerativeAIContentPart } from './google-generative-ai-prompt';
 import { prepareTools } from './google-prepare-tools';
@@ -103,14 +103,14 @@ export class GoogleGenerativeAILanguageModel implements LanguageModelV3 {
     let googleOptions = await parseProviderOptions({
       provider: providerOptionsName,
       providerOptions,
-      schema: googleGenerativeAIProviderOptions,
+      schema: googleLanguageModelOptions,
     });
 
     if (googleOptions == null && providerOptionsName !== 'google') {
       googleOptions = await parseProviderOptions({
         provider: 'google',
         providerOptions,
-        schema: googleGenerativeAIProviderOptions,
+        schema: googleLanguageModelOptions,
       });
     }
 

package/src/google-generative-ai-options.ts

@@ -45,7 +45,7 @@ export type GoogleGenerativeAIModelId =
   | 'gemma-3-27b-it'
   | (string & {});
 
-export const googleGenerativeAIProviderOptions = lazySchema(() =>
+export const googleLanguageModelOptions = lazySchema(() =>
   zodSchema(
     z.object({
       responseModalities: z.array(z.enum(['TEXT', 'IMAGE'])).optional(),
@@ -188,6 +188,6 @@ export const googleGenerativeAIProviderOptions = lazySchema(() =>
   ),
 );
 
-export type GoogleGenerativeAIProviderOptions = InferSchema<
-  typeof googleGenerativeAIProviderOptions
+export type GoogleLanguageModelOptions = InferSchema<
+  typeof googleLanguageModelOptions
 >;

package/src/google-generative-ai-video-model.ts

@@ -21,7 +21,7 @@ import { z } from 'zod/v4';
 import { googleFailedResponseHandler } from './google-error';
 import type { GoogleGenerativeAIVideoModelId } from './google-generative-ai-video-settings';
 
-export type GoogleGenerativeAIVideoProviderOptions = {
+export type GoogleVideoModelOptions = {
   // Polling configuration
   pollIntervalMs?: number | null;
   pollTimeoutMs?: number | null;
@@ -76,8 +76,8 @@ export class GoogleGenerativeAIVideoModel implements Experimental_VideoModelV3 {
     const googleOptions = (await parseProviderOptions({
       provider: 'google',
       providerOptions: options.providerOptions,
-      schema: googleVideoProviderOptionsSchema,
-    })) as GoogleGenerativeAIVideoProviderOptions | undefined;
+      schema: googleVideoModelOptionsSchema,
+    })) as GoogleVideoModelOptions | undefined;
 
     const instances: Array<Record<string, unknown>> = [{}];
     const instance = instances[0];
@@ -155,7 +155,7 @@ export class GoogleGenerativeAIVideoModel implements Experimental_VideoModelV3 {
     }
 
     if (googleOptions != null) {
-      const opts = googleOptions as GoogleGenerativeAIVideoProviderOptions;
+      const opts = googleOptions as GoogleVideoModelOptions;
 
       if (
         opts.personGeneration !== undefined &&
@@ -350,7 +350,7 @@ const googleOperationSchema = z.object({
     .nullish(),
 });
 
-const googleVideoProviderOptionsSchema = lazySchema(() =>
+const googleVideoModelOptionsSchema = lazySchema(() =>
   zodSchema(
     z
       .object({

package/src/index.ts

@@ -1,9 +1,25 @@
 export type { GoogleErrorData } from './google-error';
-export type { GoogleGenerativeAIProviderOptions } from './google-generative-ai-options';
+export type {
+  GoogleLanguageModelOptions,
+  /** @deprecated Use `GoogleLanguageModelOptions` instead. */
+  GoogleLanguageModelOptions as GoogleGenerativeAIProviderOptions,
+} from './google-generative-ai-options';
 export type { GoogleGenerativeAIProviderMetadata } from './google-generative-ai-prompt';
-export type { GoogleGenerativeAIImageProviderOptions } from './google-generative-ai-image-model';
-export type { GoogleGenerativeAIEmbeddingProviderOptions } from './google-generative-ai-embedding-options';
-export type { GoogleGenerativeAIVideoProviderOptions } from './google-generative-ai-video-model';
+export type {
+  GoogleImageModelOptions,
+  /** @deprecated Use `GoogleImageModelOptions` instead. */
+  GoogleImageModelOptions as GoogleGenerativeAIImageProviderOptions,
+} from './google-generative-ai-image-model';
+export type {
+  GoogleEmbeddingModelOptions,
+  /** @deprecated Use `GoogleEmbeddingModelOptions` instead. */
+  GoogleEmbeddingModelOptions as GoogleGenerativeAIEmbeddingProviderOptions,
+} from './google-generative-ai-embedding-options';
+export type {
+  GoogleVideoModelOptions,
+  /** @deprecated Use `GoogleVideoModelOptions` instead. */
+  GoogleVideoModelOptions as GoogleGenerativeAIVideoProviderOptions,
+} from './google-generative-ai-video-model';
 export type { GoogleGenerativeAIVideoModelId } from './google-generative-ai-video-settings';
 export { createGoogleGenerativeAI, google } from './google-provider';
 export type {