@ai-sdk/google 4.0.107 → 4.0.108

package/docs/15-google.mdx

@@ -540,7 +540,14 @@ const result = await generateText({
 });
 ```
 
-You can also use YouTube URLs directly:
+You can also use YouTube URLs directly. Pass `videoMetadata` through
+`providerOptions.google` on a video file part to clip a segment or control the
+frame rate. This also works with inline video data and uploaded file references.
+The metadata supports these optional fields:
+
+- `startOffset` (string): Start time as a duration in seconds, e.g. `'60s'` or `'3.5s'`.
+- `endOffset` (string): End time in the same duration format.
+- `fps` (number): Frames per second in the range `(0, 24]`. The default is `1`.
 
 ```ts
 import { google } from '@ai-sdk/google';
@@ -554,12 +561,21 @@ const result = await generateText({
       content: [
         {
           type: 'text',
-          text: 'Summarize this video',
+          text: 'Summarize this part of the video',
         },
         {
           type: 'file',
           data: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
           mediaType: 'video/mp4',
+          providerOptions: {
+            google: {
+              videoMetadata: {
+                startOffset: '60s',
+                endOffset: '600s',
+                fps: 1,
+              },
+            },
+          },
         },
       ],
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/google",
-  "version": "4.0.107",
+  "version": "4.0.108",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -36,7 +36,7 @@
   },
   "dependencies": {
     "@ai-sdk/provider": "4.0.34",
-    "@ai-sdk/provider-utils": "5.0.70"
+    "@ai-sdk/provider-utils": "5.0.71"
   },
   "devDependencies": {
     "@ai-sdk/test-server": "2.0.4",

package/src/convert-to-google-messages.ts

@@ -14,11 +14,12 @@ import {
   resolveProviderReference,
   secureJsonParse,
 } from '@ai-sdk/provider-utils';
-import type {
-  GoogleContent,
-  GoogleContentPart,
-  GoogleFunctionResponsePart,
-  GooglePrompt,
+import {
+  googleVideoMetadataSchema,
+  type GoogleContent,
+  type GoogleContentPart,
+  type GoogleFunctionResponsePart,
+  type GooglePrompt,
 } from './google-prompt';
 import {
   codeExecutionInputSchema,
@@ -330,6 +331,12 @@ export function convertToGoogleMessages(
             }
 
             case 'file': {
+              const rawVideoMetadata = readProviderOpts(part)?.videoMetadata;
+              const videoMetadata =
+                rawVideoMetadata == null
+                  ? undefined
+                  : googleVideoMetadataSchema.parse(rawVideoMetadata);
+
               switch (part.data.type) {
                 case 'url': {
                   parts.push({
@@ -341,6 +348,7 @@ export function convertToGoogleMessages(
                           ? part.data.originalUrl
                           : part.data.url.toString(),
                     },
+                    ...(videoMetadata != null ? { videoMetadata } : {}),
                   });
                   break;
                 }
@@ -359,6 +367,7 @@ export function convertToGoogleMessages(
                         provider: 'google',
                       }),
                     },
+                    ...(videoMetadata != null ? { videoMetadata } : {}),
                   });
                   break;
                 }
@@ -372,6 +381,7 @@ export function convertToGoogleMessages(
                         new TextEncoder().encode(part.data.text),
                       ),
                     },
+                    ...(videoMetadata != null ? { videoMetadata } : {}),
                   });
                   break;
                 }
@@ -381,6 +391,7 @@ export function convertToGoogleMessages(
                       mimeType: resolveFullMediaType({ part }),
                       data: convertToBase64(part.data.data),
                     },
+                    ...(videoMetadata != null ? { videoMetadata } : {}),
                   });
                   break;
                 }

package/src/google-json-accumulator.ts

@@ -74,6 +74,9 @@ export class GoogleJSONAccumulator {
           (existingValue as string) + arg.stringValue,
         );
         delta += escaped;
+        if (arg.willContinue !== true) {
+          delta += this.closeOpenString();
+        }
         continue;
       }
 
@@ -81,8 +84,15 @@ export class GoogleJSONAccumulator {
       if (resolved == null) {
         // A value-less entry for a path without a value is an empty container
         // (an empty container has no leaves to stream). Value-less entries for
-        // existing paths are string or array terminators and are ignored.
-        if (existingValue !== undefined || arg.willContinue === true) continue;
+        // existing paths are string or array terminators. A string terminator
+        // closes the open string, an array terminator is ignored.
+        if (existingValue !== undefined) {
+          if (typeof existingValue === 'string' && arg.willContinue !== true) {
+            delta += this.closeOpenString();
+          }
+          continue;
+        }
+        if (arg.willContinue === true) continue;
 
         setNestedValue(
           this.accumulatedArgs,
@@ -115,6 +125,18 @@ export class GoogleJSONAccumulator {
     return { finalJSON: finalArgs, closingDelta };
   }
 
+  /**
+   * Input: stringOpen=true
+   * Output: '"' (and stringOpen=false), or '' when no string is open
+   */
+  private closeOpenString(): string {
+    if (!this.stringOpen) {
+      return '';
+    }
+    this.stringOpen = false;
+    return '"';
+  }
+
   /**
    * Input: pathStack=[] (first call) or pathStack=[root,...] (subsequent calls)
    * Output: '{' (first call) or '' (subsequent calls)
@@ -139,12 +161,7 @@ export class GoogleJSONAccumulator {
     arg: PartialArg,
     valueJson: string,
   ): string {
-    let fragment = '';
-
-    if (this.stringOpen) {
-      fragment += '"';
-      this.stringOpen = false;
-    }
+    let fragment = this.closeOpenString();
 
     fragment += this.ensureRoot();
 
@@ -172,12 +189,7 @@ export class GoogleJSONAccumulator {
     targetSegments: PathSegment[],
     isArray: boolean,
   ): string {
-    let fragment = '';
-
-    if (this.stringOpen) {
-      fragment += '"';
-      this.stringOpen = false;
-    }
+    let fragment = this.closeOpenString();
 
     fragment += this.ensureRoot();
 

package/src/google-language-model.ts

@@ -1583,6 +1583,15 @@ function getMaxThinkingTokensForGemini25Model(modelId: string): number {
   return 24576;
 }
 
+/**
+ * Gemini 2.5 Pro cannot disable thinking and requires a thinking budget of at
+ * least 128 tokens. Other Gemini 2.5 models can disable thinking with a budget
+ * of 0.
+ */
+function getMinThinkingTokensForGemini25Model(modelId: string): number {
+  return modelId.toLowerCase().includes('2.5-pro') ? 128 : 0;
+}
+
 type GoogleThinkingConfig = NonNullable<
   InferSchema<typeof googleLanguageModelOptions>['thinkingConfig']
 >;
@@ -1624,20 +1633,17 @@ function resolveGemini3ThinkingConfig({
 }): Pick<GoogleThinkingConfig, 'thinkingLevel'> | undefined {
   const minimumThinkingLevel = getMinimumThinkingLevelForGemini3Model(modelId);
 
-  if (reasoning === 'none') {
-    // It's not possible to fully disable thinking with Gemini 3.
-    return { thinkingLevel: minimumThinkingLevel };
-  }
-
+  // It's not possible to fully disable thinking with Gemini 3, so reasoning
+  // 'none' maps to the lowest supported thinking level.
   const thinkingLevel = mapReasoningToProviderEffort({
     reasoning,
     effortMap: {
-      minimal: minimumThinkingLevel,
+      ...(minimumThinkingLevel === 'minimal' && {
+        minimal: 'minimal' as const,
+      }),
       low: 'low',
       medium: 'medium',
       high: 'high',
-      xhigh: 'high',
-      max: 'high',
     },
     warnings,
   });
@@ -1695,8 +1701,10 @@ function resolveGemini25ThinkingConfig({
   >;
   modelId: string;
   warnings: SharedV4Warning[];
-}): Pick<GoogleThinkingConfig, 'thinkingBudget'> | undefined {
-  if (reasoning === 'none') {
+}): Pick<GoogleThinkingConfig, 'thinkingBudget'> {
+  const minThinkingBudget = getMinThinkingTokensForGemini25Model(modelId);
+
+  if (reasoning === 'none' && minThinkingBudget === 0) {
     return { thinkingBudget: 0 };
   }
 
@@ -1704,12 +1712,9 @@ function resolveGemini25ThinkingConfig({
     reasoning,
     maxOutputTokens: getMaxOutputTokensForGemini25Model(),
     maxReasoningBudget: getMaxThinkingTokensForGemini25Model(modelId),
-    minReasoningBudget: 0,
+    minReasoningBudget: minThinkingBudget,
     warnings,
   });
-  if (thinkingBudget == null) {
-    return undefined;
-  }
   return { thinkingBudget };
 }
 

package/src/google-prompt.ts

@@ -1,3 +1,4 @@
+import { z } from 'zod/v4';
 import type {
   GroundingMetadataSchema,
   PromptFeedbackSchema,
@@ -20,10 +21,23 @@ export type GoogleContent = {
   parts: Array<GoogleContentPart>;
 };
 
+export const googleVideoMetadataSchema = z.object({
+  /** Start offset as a duration in seconds, e.g. `'3.5s'`. */
+  startOffset: z.string().optional(),
+  /** End offset as a duration in seconds, e.g. `'10s'`. */
+  endOffset: z.string().optional(),
+  /** Frames per second in the range (0, 24]. Defaults to 1. */
+  fps: z.number().gt(0).max(24).optional(),
+});
+
+/** Metadata for preprocessing video file parts. */
+export type GoogleVideoMetadata = z.infer<typeof googleVideoMetadataSchema>;
+
 export type GoogleContentPart =
   | { text: string; thought?: boolean; thoughtSignature?: string }
   | {
       inlineData: { mimeType: string; data: string };
+      videoMetadata?: GoogleVideoMetadata;
       thought?: boolean;
       thoughtSignature?: string;
     }
@@ -41,6 +55,7 @@ export type GoogleContentPart =
     }
   | {
       fileData: { mimeType: string; fileUri: string };
+      videoMetadata?: GoogleVideoMetadata;
       thought?: boolean;
       thoughtSignature?: string;
     }

package/src/index.ts

@@ -6,6 +6,7 @@ export type {
 } from './google-language-model-options';
 export type {
   GoogleProviderMetadata,
+  GoogleVideoMetadata,
   /** @deprecated Use `GoogleProviderMetadata` instead. */
   GoogleProviderMetadata as GoogleGenerativeAIProviderMetadata,
 } from './google-prompt';