@ai-sdk/google-vertex 5.0.126 → 5.0.128

package/dist/xai/edge/index.js

@@ -2,7 +2,7 @@ import { getRuntimeEnvironmentUserAgent, loadOptionalSetting, loadSetting, resol
 import { NoSuchModelError } from "@ai-sdk/provider";
 import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
 //#region src/version.ts
-const VERSION = "5.0.126";
+const VERSION = "5.0.128";
 //#endregion
 //#region src/edge/google-vertex-auth-edge.ts
 const loadCredentials = async () => {

package/docs/16-google-vertex.mdx

@@ -292,7 +292,12 @@ const googleVertex = createGoogleVertex({
 
 ##### Optional Provider Settings
 
-- **apiKey** _string_
+- **apiKey** _string | PromiseLike<string> | (() => string | PromiseLike<string>)_
+
+  Pass a callback to resolve the API key before each request. The callback can
+  return a string or a promise; token caching and renewal are handled by the caller.
+  A callback or promise selects API key authentication and must resolve to a
+  non-empty string; lookup failures do not switch authentication methods.
 
   The API key for Google Vertex AI. When provided, the provider uses express mode with API key authentication instead of OAuth.
   It uses the `GOOGLE_VERTEX_API_KEY` environment variable by default.
@@ -764,6 +769,33 @@ const { text } = await generateText({
   files to that location.
 </Note>
 
+For video file parts, pass `videoMetadata` through `providerOptions.googleVertex`
+to control clipping and frame rate. It works with Cloud Storage URLs and inline
+video data:
+
+```ts
+import type { FilePart } from 'ai';
+
+const videoPart = {
+  type: 'file',
+  data: new URL('gs://my-bucket/video.mp4'),
+  mediaType: 'video/mp4',
+  providerOptions: {
+    googleVertex: {
+      videoMetadata: {
+        startOffset: '60s',
+        endOffset: '120s',
+        fps: 1,
+      },
+    },
+  },
+} satisfies FilePart;
+```
+
+All three fields are optional. `startOffset` and `endOffset` are durations in
+seconds, such as `'60s'` or `'3.5s'`. `fps` must be in the range `(0, 24]` and
+defaults to `1`.
+
 See [File Parts](/docs/foundations/prompts#file-parts) for details on how to use files in prompts.
 
 ### Long decode

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/google-vertex",
-  "version": "5.0.126",
+  "version": "5.0.128",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -71,11 +71,11 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/anthropic": "4.0.91",
-    "@ai-sdk/google": "4.0.107",
-    "@ai-sdk/openai-compatible": "3.0.80",
-    "@ai-sdk/provider": "4.0.34",
-    "@ai-sdk/provider-utils": "5.0.70",
+    "@ai-sdk/anthropic": "4.0.93",
+    "@ai-sdk/google": "4.0.109",
+    "@ai-sdk/openai-compatible": "3.0.82",
+    "@ai-sdk/provider": "4.0.35",
+    "@ai-sdk/provider-utils": "5.0.72",
     "google-auth-library": "^11.3.1"
   },
   "devDependencies": {

package/src/edge/google-vertex-provider-edge.ts

@@ -22,10 +22,13 @@ export interface GoogleVertexProviderSettings extends GoogleVertexProviderSettin
 export function createGoogleVertex(
   options: GoogleVertexProviderSettings = {},
 ): GoogleVertexProvider {
-  const apiKey = loadOptionalSetting({
-    settingValue: options.apiKey,
-    environmentVariableName: 'GOOGLE_VERTEX_API_KEY',
-  });
+  const apiKey =
+    typeof options.apiKey === 'string' || options.apiKey == null
+      ? loadOptionalSetting({
+          settingValue: options.apiKey,
+          environmentVariableName: 'GOOGLE_VERTEX_API_KEY',
+        })
+      : options.apiKey;
 
   if (apiKey) {
     return createGoogleVertexOriginal(options);

package/src/google-vertex-provider-base.ts

@@ -8,6 +8,7 @@ import {
 } from '@ai-sdk/google/internal';
 import {
   InvalidArgumentError,
+  LoadAPIKeyError,
   type Experimental_VideoModelV4,
   type ImageModelV4,
   type LanguageModelV4,
@@ -58,15 +59,25 @@ function isEndpointModelId(modelId: string): boolean {
 
 // set `x-goog-api-key` header to API key for express mode
 function createExpressModeFetch(
-  apiKey: string,
+  apiKey: Resolvable<string>,
   customFetch?: FetchFunction,
 ): FetchFunction {
   return async (url, init) => {
+    const resolvedApiKey = await resolve(apiKey);
+    if (
+      typeof apiKey !== 'string' &&
+      (typeof resolvedApiKey !== 'string' || !resolvedApiKey.trim())
+    ) {
+      throw new LoadAPIKeyError({
+        message: 'Google Vertex API key must be a non-empty string.',
+      });
+    }
+
     const modifiedInit: RequestInit = {
       ...init,
       headers: {
         ...(init?.headers ? normalizeHeaders(init.headers) : {}),
-        'x-goog-api-key': apiKey,
+        'x-goog-api-key': resolvedApiKey,
       },
     };
     return (customFetch ?? fetch)(url.toString(), modifiedInit);
@@ -153,8 +164,9 @@ export interface GoogleVertexProviderSettings {
    * Optional. The API key for the Google Cloud project. If provided, the
    * provider will use express mode with API key authentication. Defaults to
    * the value of the `GOOGLE_VERTEX_API_KEY` environment variable.
+   * A callback is resolved before each request and must return a non-empty key.
    */
-  apiKey?: string;
+  apiKey?: Resolvable<string>;
 
   /**
    * Your Google Vertex location. Defaults to the environment variable `GOOGLE_VERTEX_LOCATION`.
@@ -214,10 +226,13 @@ export interface GoogleVertexProviderSettings {
 export function createGoogleVertex(
   options: GoogleVertexProviderSettings = {},
 ): GoogleVertexProvider {
-  const apiKey = loadOptionalSetting({
-    settingValue: options.apiKey,
-    environmentVariableName: 'GOOGLE_VERTEX_API_KEY',
-  });
+  const apiKey =
+    typeof options.apiKey === 'string' || options.apiKey == null
+      ? loadOptionalSetting({
+          settingValue: options.apiKey,
+          environmentVariableName: 'GOOGLE_VERTEX_API_KEY',
+        })
+      : options.apiKey;
 
   const loadGoogleVertexProject = () =>
     loadSetting({

package/src/google-vertex-provider.ts

@@ -21,10 +21,13 @@ export type { GoogleVertexProvider };
 export function createGoogleVertex(
   options: GoogleVertexProviderSettings = {},
 ): GoogleVertexProvider {
-  const apiKey = loadOptionalSetting({
-    settingValue: options.apiKey,
-    environmentVariableName: 'GOOGLE_VERTEX_API_KEY',
-  });
+  const apiKey =
+    typeof options.apiKey === 'string' || options.apiKey == null
+      ? loadOptionalSetting({
+          settingValue: options.apiKey,
+          environmentVariableName: 'GOOGLE_VERTEX_API_KEY',
+        })
+      : options.apiKey;
 
   if (apiKey) {
     return createGoogleVertexOriginal(options);