@ai-sdk/google 4.0.48 → 4.0.50

package/docs/15-google.mdx

@@ -1902,61 +1902,8 @@ The following optional provider options are available for Google embedding model
 You can create image models that call the Google Generative AI API using the `.image()` factory method.
 For more on image generation with the AI SDK see [generateImage()](/docs/reference/ai-sdk-core/generate-image).
 
-The Google provider supports two types of image models:
-
-- **Imagen models**: Dedicated image generation models using the `:predict` API
-- **Gemini image models**: Multimodal language models with image output capabilities using the `:generateContent` API
-
-### Imagen Models
-
-[Imagen](https://ai.google.dev/gemini-api/docs/imagen) models are dedicated image generation models.
-
-```ts
-import { google } from '@ai-sdk/google';
-import { generateImage } from 'ai';
-
-const { image } = await generateImage({
-  model: google.image('imagen-4.0-generate-001'),
-  prompt: 'A futuristic cityscape at sunset',
-  aspectRatio: '16:9',
-});
-```
-
-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 { GoogleImageModelOptions } from '@ai-sdk/google';
-import { generateImage } from 'ai';
-
-const { image } = await generateImage({
-  model: google.image('imagen-4.0-generate-001'),
-  providerOptions: {
-    google: {
-      personGeneration: 'dont_allow',
-    } satisfies GoogleImageModelOptions,
-  },
-  // ...
-});
-```
-
-The following provider options are available for Imagen models:
-
-- **personGeneration** `allow_adult` | `allow_all` | `dont_allow`
-  Whether to allow person generation. Defaults to `allow_adult`.
-
-<Note>
-  Imagen models do not support the `size` parameter. Use the `aspectRatio`
-  parameter instead.
-</Note>
-
-#### Imagen Model Capabilities
-
-| Model                           | Aspect Ratios             |
-| ------------------------------- | ------------------------- |
-| `imagen-4.0-generate-001`       | 1:1, 3:4, 4:3, 9:16, 16:9 |
-| `imagen-4.0-ultra-generate-001` | 1:1, 3:4, 4:3, 9:16, 16:9 |
-| `imagen-4.0-fast-generate-001`  | 1:1, 3:4, 4:3, 9:16, 16:9 |
+The `.image()` factory supports Gemini multimodal language models with image
+output capabilities through the `:generateContent` API.
 
 ### Gemini Image Models
 
@@ -2023,7 +1970,7 @@ const { image } = await generateImage({
 Gemini image models support [Google Search grounding](#google-search) through `providerOptions.google.googleSearch`. The value matches the args of `google.tools.googleSearch(...)`; pass `{}` to enable with defaults, or `{ searchTypes: { imageSearch: {} } }` to ground on reference photos.
 
 ```ts
-import { google } from '@ai-sdk/google';
+import { google, type GoogleImageModelOptions } from '@ai-sdk/google';
 import { generateImage } from 'ai';
 
 const result = await generateImage({
@@ -2033,7 +1980,7 @@ const result = await generateImage({
   providerOptions: {
     google: {
       googleSearch: { searchTypes: { imageSearch: {} } },
-    },
+    } satisfies GoogleImageModelOptions,
   },
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/google",
-  "version": "4.0.48",
+  "version": "4.0.50",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -36,7 +36,7 @@
   },
   "dependencies": {
     "@ai-sdk/provider": "4.0.7",
-    "@ai-sdk/provider-utils": "5.0.28"
+    "@ai-sdk/provider-utils": "5.0.29"
   },
   "devDependencies": {
     "@types/node": "22.19.19",

package/src/google-image-model-options.ts

@@ -1,21 +1,14 @@
-import {
-  lazySchema,
-  zodSchema,
-  type InferSchema,
-} from '@ai-sdk/provider-utils';
+import { lazySchema, zodSchema } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
-import { googleSearchToolArgsBaseSchema } from './tool/google-search';
+import type { GoogleLanguageModelOptions } from './google-language-model-options';
+import {
+  googleSearchToolArgsBaseSchema,
+  type GoogleSearchToolArgs,
+} from './tool/google-search';
 
-// Note: For the initial GA launch of Imagen 3, safety filters are not configurable.
-// https://ai.google.dev/gemini-api/docs/imagen#imagen-model
 export const googleImageModelOptionsSchema = lazySchema(() =>
   zodSchema(
     z.object({
-      personGeneration: z
-        .enum(['dont_allow', 'allow_adult', 'allow_all'])
-        .nullish(),
-      aspectRatio: z.enum(['1:1', '3:4', '4:3', '9:16', '16:9']).nullish(),
-
       /**
        * Enable Google Search grounding for Gemini image models. The value is
        * forwarded as the args of the `google.tools.googleSearch` provider
@@ -30,6 +23,9 @@ export const googleImageModelOptionsSchema = lazySchema(() =>
   ),
 );
 
-export type GoogleImageModelOptions = InferSchema<
-  typeof googleImageModelOptionsSchema
->;
+export type GoogleImageModelOptions = Omit<
+  GoogleLanguageModelOptions,
+  'responseModalities'
+> & {
+  googleSearch?: GoogleSearchToolArgs;
+};

package/src/google-image-model.ts

@@ -4,23 +4,15 @@ import type {
   SharedV4Warning,
 } from '@ai-sdk/provider';
 import {
-  combineHeaders,
   convertToBase64,
-  createJsonResponseHandler,
   generateId as defaultGenerateId,
-  lazySchema,
   parseProviderOptions,
-  postJsonToApi,
-  resolve,
   serializeModelOptions,
   WORKFLOW_SERIALIZE,
   WORKFLOW_DESERIALIZE,
-  zodSchema,
   type FetchFunction,
   type Resolvable,
 } from '@ai-sdk/provider-utils';
-import { z } from 'zod/v4';
-import { googleFailedResponseHandler } from './google-error';
 import { googleImageModelOptionsSchema } from './google-image-model-options';
 import type {
   GoogleImageModelId,
@@ -61,12 +53,7 @@ export class GoogleImageModel implements ImageModelV4 {
     if (this.settings.maxImagesPerCall != null) {
       return this.settings.maxImagesPerCall;
     }
-    // https://docs.cloud.google.com/vertex-ai/generative-ai/docs/models/gemini/2-5-flash-image
-    if (isGeminiModel(this.modelId)) {
-      return 10;
-    }
-    // https://ai.google.dev/gemini-api/docs/imagen#imagen-model
-    return 4;
+    return 10;
   }
 
   get provider(): string {
@@ -82,137 +69,12 @@ export class GoogleImageModel implements ImageModelV4 {
   async doGenerate(
     options: Parameters<ImageModelV4['doGenerate']>[0],
   ): Promise<Awaited<ReturnType<ImageModelV4['doGenerate']>>> {
-    // Gemini image models use the language model API internally
-    if (isGeminiModel(this.modelId)) {
-      return this.doGenerateGemini(options);
-    }
-    return this.doGenerateImagen(options);
-  }
-
-  private async doGenerateImagen(
-    options: Parameters<ImageModelV4['doGenerate']>[0],
-  ): Promise<Awaited<ReturnType<ImageModelV4['doGenerate']>>> {
-    const {
-      prompt,
-      n = 1,
-      size,
-      aspectRatio = '1:1',
-      seed,
-      providerOptions,
-      headers,
-      abortSignal,
-      files,
-      mask,
-    } = options;
-    const warnings: Array<SharedV4Warning> = [];
-
-    // Imagen API endpoints do not support image editing
-    if (files != null && files.length > 0) {
-      throw new Error(
-        'Google Gemini API does not support image editing with Imagen models. ' +
-          'Use Google Vertex AI (@ai-sdk/google-vertex) for image editing capabilities.',
-      );
-    }
-
-    if (mask != null) {
+    if (!this.modelId.startsWith('gemini-')) {
       throw new Error(
-        'Google Gemini API does not support image editing with masks. ' +
-          'Use Google Vertex AI (@ai-sdk/google-vertex) for image editing capabilities.',
+        'Google image models other than Gemini are no longer supported. Use a model ID that starts with `gemini-`.',
       );
     }
 
-    if (size != null) {
-      warnings.push({
-        type: 'unsupported',
-        feature: 'size',
-        details:
-          'This model does not support the `size` option. Use `aspectRatio` instead.',
-      });
-    }
-
-    if (seed != null) {
-      warnings.push({
-        type: 'unsupported',
-        feature: 'seed',
-        details:
-          'This model does not support the `seed` option through this provider.',
-      });
-    }
-
-    const googleOptions = await parseProviderOptions({
-      provider: 'google',
-      providerOptions,
-      schema: googleImageModelOptionsSchema,
-    });
-
-    const currentDate = this.config._internal?.currentDate?.() ?? new Date();
-
-    const parameters: Record<string, unknown> = {
-      sampleCount: n,
-    };
-
-    if (aspectRatio != null) {
-      parameters.aspectRatio = aspectRatio;
-    }
-
-    if (googleOptions) {
-      const { googleSearch: imagenGoogleSearch, ...imagenOptions } =
-        googleOptions;
-      if (imagenGoogleSearch != null) {
-        warnings.push({
-          type: 'unsupported',
-          feature: 'googleSearch',
-          details:
-            'Google Search grounding is only supported on Gemini image models.',
-        });
-      }
-      Object.assign(parameters, imagenOptions);
-    }
-
-    const body = {
-      instances: [{ prompt }],
-      parameters,
-    };
-
-    const { responseHeaders, value: response } = await postJsonToApi<{
-      predictions: Array<{ bytesBase64Encoded: string }>;
-    }>({
-      url: `${this.config.baseURL}/models/${this.modelId}:predict`,
-      headers: combineHeaders(
-        this.config.headers ? await resolve(this.config.headers) : undefined,
-        headers,
-      ),
-      body,
-      failedResponseHandler: googleFailedResponseHandler,
-      successfulResponseHandler: createJsonResponseHandler(
-        googleImageResponseSchema,
-      ),
-      abortSignal,
-      fetch: this.config.fetch,
-    });
-    return {
-      images: response.predictions.map(
-        (p: { bytesBase64Encoded: string }) => p.bytesBase64Encoded,
-      ),
-      warnings,
-      providerMetadata: {
-        google: {
-          images: response.predictions.map(() => ({
-            // Add any prediction-specific metadata here
-          })),
-        },
-      },
-      response: {
-        timestamp: currentDate,
-        modelId: this.modelId,
-        headers: responseHeaders,
-      },
-    };
-  }
-
-  private async doGenerateGemini(
-    options: Parameters<ImageModelV4['doGenerate']>[0],
-  ): Promise<Awaited<ReturnType<ImageModelV4['doGenerate']>>> {
     const {
       prompt,
       n,
@@ -302,8 +164,12 @@ export class GoogleImageModel implements ImageModelV4 {
       schema: googleImageModelOptionsSchema,
     });
 
-    const { googleSearch: _strippedGoogleSearch, ...passthroughGoogleOptions } =
-      providerOptions?.google ?? {};
+    const {
+      googleSearch: _strippedGoogleSearch,
+      responseModalities: _strippedResponseModalities,
+      imageConfig: userImageConfig,
+      ...passthroughGoogleOptions
+    } = providerOptions?.google ?? {};
 
     // Instantiate language model
     const languageModel = new GoogleLanguageModel(this.modelId, {
@@ -320,18 +186,26 @@ export class GoogleImageModel implements ImageModelV4 {
       seed,
       providerOptions: {
         google: {
-          responseModalities: ['IMAGE'],
-          imageConfig: aspectRatio
-            ? {
-                aspectRatio: aspectRatio as NonNullable<
-                  GoogleLanguageModelOptions['imageConfig']
-                >['aspectRatio'],
-              }
-            : undefined,
           ...(passthroughGoogleOptions as Omit<
             GoogleLanguageModelOptions,
             'responseModalities' | 'imageConfig'
           >),
+          responseModalities: ['IMAGE'],
+          imageConfig:
+            aspectRatio != null || userImageConfig != null
+              ? {
+                  ...(userImageConfig as NonNullable<
+                    GoogleLanguageModelOptions['imageConfig']
+                  >),
+                  ...(aspectRatio != null
+                    ? {
+                        aspectRatio: aspectRatio as NonNullable<
+                          GoogleLanguageModelOptions['imageConfig']
+                        >['aspectRatio'],
+                      }
+                    : {}),
+                }
+              : undefined,
         } satisfies GoogleLanguageModelOptions,
       },
       tools:
@@ -393,18 +267,3 @@ export class GoogleImageModel implements ImageModelV4 {
     };
   }
 }
-
-function isGeminiModel(modelId: string): boolean {
-  return modelId.startsWith('gemini-');
-}
-
-// minimal version of the schema
-const googleImageResponseSchema = lazySchema(() =>
-  zodSchema(
-    z.object({
-      predictions: z
-        .array(z.object({ bytesBase64Encoded: z.string() }))
-        .default([]),
-    }),
-  ),
-);

package/src/google-image-settings.ts

@@ -1,8 +1,4 @@
 export type GoogleImageModelId =
-  // Imagen models (use :predict API)
-  | 'imagen-4.0-generate-001'
-  | 'imagen-4.0-ultra-generate-001'
-  | 'imagen-4.0-fast-generate-001'
   // Gemini image models (technically multimodal output language models, use :generateContent API)
   | 'gemini-2.5-flash-image'
   | 'gemini-3-pro-image-preview'
@@ -11,7 +7,7 @@ export type GoogleImageModelId =
 
 export interface GoogleImageSettings {
   /**
-   * Override the maximum number of images per call (default 4)
+   * Override the maximum number of images per call (default 10)
    */
   maxImagesPerCall?: number;
 }