@ai-sdk/google-vertex 5.0.0-beta.24 → 5.0.0-beta.26

package/docs/16-google-vertex.mdx

@@ -5,14 +5,15 @@ description: Learn how to use the Google Vertex AI provider.
 
 # Google Vertex Provider
 
-The Google Vertex provider for the [AI SDK](/docs) contains language model support for the [Google Vertex AI](https://cloud.google.com/vertex-ai) APIs. This includes support for [Google's Gemini models](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/models) and [Anthropic's Claude partner models](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/use-claude).
+The Google Vertex provider for the [AI SDK](/docs) contains language model support for the [Google Vertex AI](https://cloud.google.com/vertex-ai) APIs. This includes support for [Google's Gemini models](https://cloud.google.com/vertex-ai/generative-ai/docs/learn/models), [Anthropic's Claude partner models](https://cloud.google.com/vertex-ai/generative-ai/docs/partner-models/use-claude), and [MaaS (Model as a Service) open models](https://cloud.google.com/vertex-ai/generative-ai/docs/maas/use-open-models).
 
 <Note>
   The Google Vertex provider is compatible with both Node.js and Edge runtimes.
   The Edge runtime is supported through the `@ai-sdk/google-vertex/edge`
   sub-module. More details can be found in the [Google Vertex Edge
-  Runtime](#google-vertex-edge-runtime) and [Google Vertex Anthropic Edge
-  Runtime](#google-vertex-anthropic-edge-runtime) sections below.
+  Runtime](#google-vertex-edge-runtime), [Google Vertex Anthropic Edge
+  Runtime](#google-vertex-anthropic-edge-runtime), and [Google Vertex MaaS Edge
+  Runtime](#google-vertex-maas-edge-runtime) sections below.
 </Note>
 
 ## Setup
@@ -1716,3 +1717,147 @@ See also [Anthropic Model Comparison](https://docs.anthropic.com/en/docs/about-c
   The table above lists popular models. You can also pass any available provider
   model ID as a string if needed.
 </Note>
+
+## Google Vertex MaaS Provider Usage
+
+The Google Vertex MaaS (Model as a Service) provider offers access to partner and open models hosted on Vertex AI through an OpenAI-compatible Chat Completions API. This includes models from DeepSeek, Qwen, Meta, MiniMax, Moonshot, and OpenAI.
+
+For more information, see the [Vertex AI MaaS documentation](https://cloud.google.com/vertex-ai/generative-ai/docs/maas/use-open-models).
+
+### Provider Instance
+
+You can import the default provider instance `vertexMaas` from `@ai-sdk/google-vertex/maas`:
+
+```typescript
+import { vertexMaas } from '@ai-sdk/google-vertex/maas';
+```
+
+If you need a customized setup, you can import `createVertexMaas` from `@ai-sdk/google-vertex/maas` and create a provider instance with your settings:
+
+```typescript
+import { createVertexMaas } from '@ai-sdk/google-vertex/maas';
+
+const vertexMaas = createVertexMaas({
+  project: 'my-project', // optional
+  location: 'us-east5', // optional, defaults to 'global'
+});
+```
+
+#### Node.js Runtime
+
+For Node.js environments, the Google Vertex MaaS provider supports all standard Google Cloud authentication options through the `google-auth-library`:
+
+```typescript
+import { createVertexMaas } from '@ai-sdk/google-vertex/maas';
+
+const vertexMaas = createVertexMaas({
+  googleAuthOptions: {
+    credentials: {
+      client_email: 'my-email',
+      private_key: 'my-private-key',
+    },
+  },
+});
+```
+
+##### Optional Provider Settings
+
+- **project** _string_
+
+  The Google Cloud project ID. Defaults to the `GOOGLE_VERTEX_PROJECT` environment variable.
+
+- **location** _string_
+
+  The Google Cloud location, e.g. `us-east5` or `global`. Defaults to the `GOOGLE_VERTEX_LOCATION` environment variable. If not set, defaults to `global`.
+
+- **googleAuthOptions** _object_
+
+  Optional. The Authentication options used by the [Google Auth Library](https://github.com/googleapis/google-auth-library-nodejs/).
+
+- **headers** _Resolvable&lt;Record&lt;string, string | undefined&gt;&gt;_
+
+  Headers to include in requests.
+
+- **fetch** _(input: RequestInfo, init?: RequestInit) => Promise&lt;Response&gt;_
+
+  Custom [fetch](https://developer.mozilla.org/en-US/docs/Web/API/fetch) implementation.
+
+<a id="google-vertex-maas-edge-runtime"></a>
+
+#### Edge Runtime
+
+For Edge runtimes, import from `@ai-sdk/google-vertex/maas/edge`:
+
+```typescript
+import { vertexMaas } from '@ai-sdk/google-vertex/maas/edge';
+```
+
+```typescript
+import { createVertexMaas } from '@ai-sdk/google-vertex/maas/edge';
+
+const vertexMaas = createVertexMaas({
+  project: 'my-project',
+  location: 'us-east5',
+});
+```
+
+For Edge runtime authentication, set these environment variables:
+
+- `GOOGLE_CLIENT_EMAIL`
+- `GOOGLE_PRIVATE_KEY`
+- `GOOGLE_PRIVATE_KEY_ID` (optional)
+
+### Language Models
+
+You can create models using the provider instance. The first argument is the model ID:
+
+```ts
+import { vertexMaas } from '@ai-sdk/google-vertex/maas';
+import { generateText } from 'ai';
+
+const { text } = await generateText({
+  model: vertexMaas('deepseek-ai/deepseek-v3.2-maas'),
+  prompt: 'Invent a new holiday and describe its traditions.',
+});
+```
+
+Streaming is also supported:
+
+```ts
+import { vertexMaas } from '@ai-sdk/google-vertex/maas';
+import { streamText } from 'ai';
+
+const result = streamText({
+  model: vertexMaas('deepseek-ai/deepseek-v3.2-maas'),
+  prompt: 'Invent a new holiday and describe its traditions.',
+});
+
+for await (const textPart of result.textStream) {
+  process.stdout.write(textPart);
+}
+```
+
+### Available Models
+
+The following models are available through the MaaS provider. You can also pass any valid model ID as a string.
+
+| Model ID                                       | Provider |
+| ---------------------------------------------- | -------- |
+| `deepseek-ai/deepseek-r1-0528-maas`           | DeepSeek |
+| `deepseek-ai/deepseek-v3.1-maas`              | DeepSeek |
+| `deepseek-ai/deepseek-v3.2-maas`              | DeepSeek |
+| `openai/gpt-oss-120b-maas`                    | OpenAI   |
+| `openai/gpt-oss-20b-maas`                     | OpenAI   |
+| `meta/llama-4-maverick-17b-128e-instruct-maas` | Meta     |
+| `meta/llama-4-scout-17b-16e-instruct-maas`    | Meta     |
+| `minimax/minimax-m2-maas`                      | MiniMax  |
+| `qwen/qwen3-coder-480b-a35b-instruct-maas`    | Qwen     |
+| `qwen/qwen3-next-80b-a3b-instruct-maas`       | Qwen     |
+| `qwen/qwen3-next-80b-a3b-thinking-maas`       | Qwen     |
+| `moonshotai/kimi-k2-thinking-maas`             | Moonshot |
+
+<Note>
+  Model availability depends on your Google Cloud project and region. Check the
+  [Vertex AI Model Garden](https://console.cloud.google.com/vertex-ai/model-garden)
+  for the latest available models.
+</Note>

package/maas/edge.d.ts

@@ -0,0 +1 @@
+export * from '../dist/maas/edge/index';

package/maas/index.d.ts

@@ -0,0 +1 @@
+export * from '../dist/maas/index';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/google-vertex",
-  "version": "5.0.0-beta.24",
+  "version": "5.0.0-beta.26",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -18,7 +18,9 @@
     "README.md",
     "edge.d.ts",
     "anthropic/edge.d.ts",
-    "anthropic/index.d.ts"
+    "anthropic/index.d.ts",
+    "maas/edge.d.ts",
+    "maas/index.d.ts"
   ],
   "directories": {
     "doc": "./docs"
@@ -44,13 +46,24 @@
       "types": "./dist/anthropic/edge/index.d.ts",
       "import": "./dist/anthropic/edge/index.mjs",
       "require": "./dist/anthropic/edge/index.js"
+    },
+    "./maas": {
+      "types": "./dist/maas/index.d.ts",
+      "import": "./dist/maas/index.mjs",
+      "require": "./dist/maas/index.js"
+    },
+    "./maas/edge": {
+      "types": "./dist/maas/edge/index.d.ts",
+      "import": "./dist/maas/edge/index.mjs",
+      "require": "./dist/maas/edge/index.js"
     }
   },
   "dependencies": {
     "google-auth-library": "^10.5.0",
-    "@ai-sdk/google": "4.0.0-beta.18",
-    "@ai-sdk/provider": "4.0.0-beta.5",
     "@ai-sdk/anthropic": "4.0.0-beta.12",
+    "@ai-sdk/google": "4.0.0-beta.19",
+    "@ai-sdk/provider": "4.0.0-beta.5",
+    "@ai-sdk/openai-compatible": "3.0.0-beta.10",
     "@ai-sdk/provider-utils": "5.0.0-beta.7"
   },
   "devDependencies": {
@@ -58,8 +71,8 @@
     "tsup": "^8",
     "typescript": "5.8.3",
     "zod": "3.25.76",
-    "@ai-sdk/test-server": "2.0.0-beta.0",
-    "@vercel/ai-tsconfig": "0.0.0"
+    "@vercel/ai-tsconfig": "0.0.0",
+    "@ai-sdk/test-server": "2.0.0-beta.0"
   },
   "peerDependencies": {
     "zod": "^3.25.76 || ^4.1.8"

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

@@ -0,0 +1,65 @@
+import { FetchFunction, resolve } from '@ai-sdk/provider-utils';
+import {
+  generateAuthToken,
+  GoogleCredentials,
+} from '../../edge/google-vertex-auth-edge';
+import {
+  createVertexMaas as createVertexMaasOriginal,
+  GoogleVertexMaasProvider,
+  GoogleVertexMaasProviderSettings as GoogleVertexMaasProviderSettingsOriginal,
+} from '../google-vertex-maas-provider';
+
+export type { GoogleVertexMaasProvider };
+
+export interface GoogleVertexMaasProviderSettings extends GoogleVertexMaasProviderSettingsOriginal {
+  /**
+   * Optional. The Google credentials for the Google Cloud service account. If
+   * not provided, the Google Vertex provider will use environment variables to
+   * load the credentials.
+   */
+  googleCredentials?: GoogleCredentials;
+}
+
+/**
+ * Create a Google Vertex AI MaaS (Model as a Service) provider instance for Edge runtimes.
+ * Uses the OpenAI-compatible Chat Completions API for partner and open models.
+ * Automatically handles Google Cloud authentication.
+ *
+ * @see https://cloud.google.com/vertex-ai/generative-ai/docs/maas/use-open-models
+ */
+export function createVertexMaas(
+  options: GoogleVertexMaasProviderSettings = {},
+): GoogleVertexMaasProvider {
+  // Create a custom fetch wrapper that adds auth headers
+  const customFetch: FetchFunction = async (url, init) => {
+    const token = await generateAuthToken(options.googleCredentials);
+    const resolvedHeaders = await resolve(options.headers);
+    const authHeaders = {
+      ...resolvedHeaders,
+      Authorization: `Bearer ${token}`,
+    };
+
+    // Merge auth headers with existing headers from init
+    const fetchInit = {
+      ...init,
+      headers: {
+        ...init?.headers,
+        ...authHeaders,
+      },
+    };
+
+    // Call the original fetch or user's custom fetch
+    return (options.fetch ?? fetch)(url, fetchInit);
+  };
+
+  return createVertexMaasOriginal({
+    ...options,
+    fetch: customFetch,
+    headers: undefined, // Don't pass headers, we handle them in fetch
+  });
+}
+
+/**
+ * Default Google Vertex AI MaaS provider instance for Edge runtimes.
+ */
+export const vertexMaas = createVertexMaas();

package/src/maas/edge/index.ts

@@ -0,0 +1,9 @@
+export {
+  createVertexMaas,
+  vertexMaas,
+} from './google-vertex-maas-provider-edge';
+export type {
+  GoogleVertexMaasProvider,
+  GoogleVertexMaasProviderSettings,
+} from './google-vertex-maas-provider-edge';
+export type { GoogleVertexMaasModelId } from '../google-vertex-maas-options';

package/src/maas/google-vertex-maas-options.ts

@@ -0,0 +1,15 @@
+// https://cloud.google.com/vertex-ai/generative-ai/docs/maas/use-open-models
+export type GoogleVertexMaasModelId =
+  | 'deepseek-ai/deepseek-r1-0528-maas'
+  | 'deepseek-ai/deepseek-v3.1-maas'
+  | 'deepseek-ai/deepseek-v3.2-maas'
+  | 'openai/gpt-oss-120b-maas'
+  | 'openai/gpt-oss-20b-maas'
+  | 'meta/llama-4-maverick-17b-128e-instruct-maas'
+  | 'meta/llama-4-scout-17b-16e-instruct-maas'
+  | 'minimax/minimax-m2-maas'
+  | 'qwen/qwen3-coder-480b-a35b-instruct-maas'
+  | 'qwen/qwen3-next-80b-a3b-instruct-maas'
+  | 'qwen/qwen3-next-80b-a3b-thinking-maas'
+  | 'moonshotai/kimi-k2-thinking-maas'
+  | (string & {});

package/src/maas/google-vertex-maas-provider-node.ts

@@ -0,0 +1,64 @@
+import { FetchFunction, resolve } from '@ai-sdk/provider-utils';
+import { GoogleAuthOptions } from 'google-auth-library';
+import { generateAuthToken } from '../google-vertex-auth-google-auth-library';
+import {
+  createVertexMaas as createVertexMaasOriginal,
+  GoogleVertexMaasProvider,
+  GoogleVertexMaasProviderSettings as GoogleVertexMaasProviderSettingsOriginal,
+} from './google-vertex-maas-provider';
+
+export type { GoogleVertexMaasProvider };
+
+export interface GoogleVertexMaasProviderSettings extends GoogleVertexMaasProviderSettingsOriginal {
+  /**
+   * Optional. The Authentication options provided by google-auth-library.
+   * Complete list of authentication options is documented in the
+   * GoogleAuthOptions interface:
+   * https://github.com/googleapis/google-auth-library-nodejs/blob/main/src/auth/googleauth.ts.
+   */
+  googleAuthOptions?: GoogleAuthOptions;
+}
+
+/**
+ * Create a Google Vertex AI MaaS (Model as a Service) provider instance for Node.js.
+ * Uses the OpenAI-compatible Chat Completions API for partner and open models.
+ * Automatically handles Google Cloud authentication.
+ *
+ * @see https://cloud.google.com/vertex-ai/generative-ai/docs/maas/use-open-models
+ */
+export function createVertexMaas(
+  options: GoogleVertexMaasProviderSettings = {},
+): GoogleVertexMaasProvider {
+  // Create a custom fetch wrapper that adds auth headers
+  const customFetch: FetchFunction = async (url, init) => {
+    const token = await generateAuthToken(options.googleAuthOptions);
+    const resolvedHeaders = await resolve(options.headers);
+    const authHeaders = {
+      ...resolvedHeaders,
+      Authorization: `Bearer ${token}`,
+    };
+
+    // Merge auth headers with existing headers from init
+    const fetchInit = {
+      ...init,
+      headers: {
+        ...init?.headers,
+        ...authHeaders,
+      },
+    };
+
+    // Call the original fetch or user's custom fetch
+    return (options.fetch ?? fetch)(url, fetchInit);
+  };
+
+  return createVertexMaasOriginal({
+    ...options,
+    fetch: customFetch,
+    headers: undefined, // Don't pass headers, we handle them in fetch
+  });
+}
+
+/**
+ * Default Google Vertex AI MaaS provider instance for Node.js.
+ */
+export const vertexMaas = createVertexMaas();

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

@@ -0,0 +1,111 @@
+import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
+import type { OpenAICompatibleProvider } from '@ai-sdk/openai-compatible';
+import {
+  FetchFunction,
+  loadOptionalSetting,
+  loadSetting,
+  Resolvable,
+  withoutTrailingSlash,
+} from '@ai-sdk/provider-utils';
+import type { GoogleVertexMaasModelId } from './google-vertex-maas-options';
+
+export interface GoogleVertexMaasProvider extends OpenAICompatibleProvider<
+  GoogleVertexMaasModelId,
+  string,
+  string,
+  string
+> {}
+
+export interface GoogleVertexMaasProviderSettings {
+  /**
+   * Google Cloud project ID. Defaults to the value of the `GOOGLE_VERTEX_PROJECT` environment variable.
+   */
+  project?: string;
+
+  /**
+   * Google Cloud location/region. Defaults to the value of the `GOOGLE_VERTEX_LOCATION` environment variable.
+   * Use 'global' for the global endpoint.
+   */
+  location?: string;
+
+  /**
+   * Base URL for the API calls. If not provided, will be constructed from project and location.
+   */
+  baseURL?: string;
+
+  /**
+   * Headers to use for requests. Can be:
+   * - A headers object
+   * - A Promise that resolves to a headers object
+   * - A function that returns a headers object
+   * - A function that returns a Promise of a headers object
+   */
+  headers?: Resolvable<Record<string, string | undefined>>;
+
+  /**
+   * Custom fetch implementation. You can use it as a middleware to intercept requests,
+   * or to provide a custom fetch implementation for e.g. testing.
+   */
+  fetch?: FetchFunction;
+}
+
+/**
+ * Create a Google Vertex AI MaaS (Model as a Service) provider instance.
+ * Uses the OpenAI-compatible Chat Completions API for partner and open models.
+ *
+ * @see https://cloud.google.com/vertex-ai/generative-ai/docs/maas/use-open-models
+ */
+export function createVertexMaas(
+  options: GoogleVertexMaasProviderSettings = {},
+): GoogleVertexMaasProvider {
+  // Lazy-load settings to support loading from environment variables at runtime
+  const loadLocation = () =>
+    loadOptionalSetting({
+      settingValue: options.location,
+      environmentVariableName: 'GOOGLE_VERTEX_LOCATION',
+    });
+
+  const loadProject = () =>
+    loadSetting({
+      settingValue: options.project,
+      settingName: 'project',
+      environmentVariableName: 'GOOGLE_VERTEX_PROJECT',
+      description: 'Google Vertex project',
+    });
+
+  // Construct base URL: https://aiplatform.googleapis.com/v1/projects/{project}/locations/{location}/endpoints/openapi
+  const constructBaseURL = () => {
+    const projectId = loadProject();
+    const location = loadLocation() ?? 'global';
+
+    return `https://aiplatform.googleapis.com/v1/projects/${projectId}/locations/${location}/endpoints/openapi`;
+  };
+
+  const loadBaseURL = () =>
+    withoutTrailingSlash(options.baseURL ?? '') || constructBaseURL();
+
+  let cachedProvider: GoogleVertexMaasProvider | undefined;
+  const getProvider = () =>
+    (cachedProvider ??= createOpenAICompatible({
+      name: 'vertex.maas',
+      baseURL: loadBaseURL(),
+      fetch: options.fetch,
+    }));
+
+  const provider = (modelId: GoogleVertexMaasModelId) => getProvider()(modelId);
+
+  provider.specificationVersion = 'v4' as const;
+  provider.languageModel = (modelId: GoogleVertexMaasModelId) =>
+    getProvider().languageModel(modelId);
+  provider.chatModel = (modelId: GoogleVertexMaasModelId) =>
+    getProvider().chatModel(modelId);
+  provider.completionModel = (modelId: string) =>
+    getProvider().completionModel(modelId);
+  provider.embeddingModel = (modelId: string) =>
+    getProvider().embeddingModel(modelId);
+  provider.textEmbeddingModel = (modelId: string) =>
+    getProvider().textEmbeddingModel(modelId);
+  provider.imageModel = (modelId: string) => getProvider().imageModel(modelId);
+
+  return provider as GoogleVertexMaasProvider;
+}

package/src/maas/index.ts

@@ -0,0 +1,9 @@
+export {
+  createVertexMaas,
+  vertexMaas,
+} from './google-vertex-maas-provider-node';
+export type {
+  GoogleVertexMaasProvider,
+  GoogleVertexMaasProviderSettings,
+} from './google-vertex-maas-provider-node';
+export type { GoogleVertexMaasModelId } from './google-vertex-maas-options';