@tanstack/ai-vercel-gateway 0.0.1

package/dist/esm/tools/function-tool.d.ts

@@ -0,0 +1,16 @@
+import { Tool } from '@tanstack/ai';
+export interface FunctionTool {
+    type: 'function';
+    function: {
+        name: string;
+        description?: string;
+        parameters: Record<string, unknown>;
+        strict?: boolean;
+    };
+}
+/**
+ * Converts a standard Tool to Vercel AI Gateway Chat Completions tool format.
+ *
+ * Tool schemas are already converted to JSON Schema in the ai layer.
+ */
+export declare function convertFunctionToolToAdapterFormat(tool: Tool): FunctionTool;

package/dist/esm/tools/function-tool.js

@@ -0,0 +1,30 @@
+import { makeStructuredOutputCompatible } from "@tanstack/openai-base";
+//#region src/tools/function-tool.ts
+/**
+* Converts a standard Tool to Vercel AI Gateway Chat Completions tool format.
+*
+* Tool schemas are already converted to JSON Schema in the ai layer.
+*/
+function convertFunctionToolToAdapterFormat(tool) {
+	const inputSchema = tool.inputSchema ?? {
+		type: "object",
+		properties: {},
+		required: []
+	};
+	if (inputSchema.type === "object" && !inputSchema.properties) inputSchema.properties = {};
+	const jsonSchema = makeStructuredOutputCompatible(inputSchema, inputSchema.required || []);
+	jsonSchema.additionalProperties = false;
+	return {
+		type: "function",
+		function: {
+			name: tool.name,
+			description: tool.description,
+			parameters: jsonSchema,
+			strict: true
+		}
+	};
+}
+//#endregion
+export { convertFunctionToolToAdapterFormat };
+
+//# sourceMappingURL=function-tool.js.map

package/dist/esm/tools/function-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-tool.js","names":[],"sources":["../../../src/tools/function-tool.ts"],"sourcesContent":["import { makeStructuredOutputCompatible } from '@tanstack/openai-base'\nimport type { JSONSchema, Tool } from '@tanstack/ai'\n\nexport interface FunctionTool {\n  type: 'function'\n  function: {\n    name: string\n    description?: string\n    parameters: Record<string, unknown>\n    strict?: boolean\n  }\n}\n\n/**\n * Converts a standard Tool to Vercel AI Gateway Chat Completions tool format.\n *\n * Tool schemas are already converted to JSON Schema in the ai layer.\n */\nexport function convertFunctionToolToAdapterFormat(tool: Tool): FunctionTool {\n  const inputSchema = (tool.inputSchema ?? {\n    type: 'object',\n    properties: {},\n    required: [],\n  }) as JSONSchema\n\n  if (inputSchema.type === 'object' && !inputSchema.properties) {\n    inputSchema.properties = {}\n  }\n\n  const jsonSchema = makeStructuredOutputCompatible(\n    inputSchema,\n    inputSchema.required || [],\n  )\n\n  jsonSchema.additionalProperties = false\n\n  return {\n    type: 'function',\n    function: {\n      name: tool.name,\n      description: tool.description,\n      parameters: jsonSchema,\n      strict: true,\n    },\n  }\n}\n"],"mappings":";;;;;;;AAkBA,SAAgB,mCAAmC,MAA0B;CAC3E,MAAM,cAAe,KAAK,eAAe;EACvC,MAAM;EACN,YAAY,CAAC;EACb,UAAU,CAAC;CACb;CAEA,IAAI,YAAY,SAAS,YAAY,CAAC,YAAY,YAChD,YAAY,aAAa,CAAC;CAG5B,MAAM,aAAa,+BACjB,aACA,YAAY,YAAY,CAAC,CAC3B;CAEA,WAAW,uBAAuB;CAElC,OAAO;EACL,MAAM;EACN,UAAU;GACR,MAAM,KAAK;GACX,aAAa,KAAK;GAClB,YAAY;GACZ,QAAQ;EACV;CACF;AACF"}

package/dist/esm/tools/index.d.ts

@@ -0,0 +1,2 @@
+export { convertFunctionToolToAdapterFormat, type FunctionTool, } from './function-tool.js';
+export { convertToolsToProviderFormat } from './tool-converter.js';

package/dist/esm/tools/index.js

@@ -0,0 +1,3 @@
+import { convertFunctionToolToAdapterFormat } from "./function-tool.js";
+import { convertToolsToProviderFormat } from "./tool-converter.js";
+export { convertFunctionToolToAdapterFormat, convertToolsToProviderFormat };

package/dist/esm/tools/tool-converter.d.ts

@@ -0,0 +1,7 @@
+import { FunctionTool } from './function-tool.js';
+import { Tool } from '@tanstack/ai';
+/**
+ * Converts an array of standard Tools to Vercel AI Gateway format.
+ * The Gateway Chat Completions API is OpenAI-compatible, so we support function tools.
+ */
+export declare function convertToolsToProviderFormat(tools: Array<Tool>): Array<FunctionTool>;

package/dist/esm/tools/tool-converter.js

@@ -0,0 +1,15 @@
+import { convertFunctionToolToAdapterFormat } from "./function-tool.js";
+//#region src/tools/tool-converter.ts
+/**
+* Converts an array of standard Tools to Vercel AI Gateway format.
+* The Gateway Chat Completions API is OpenAI-compatible, so we support function tools.
+*/
+function convertToolsToProviderFormat(tools) {
+	return tools.map((tool) => {
+		return convertFunctionToolToAdapterFormat(tool);
+	});
+}
+//#endregion
+export { convertToolsToProviderFormat };
+
+//# sourceMappingURL=tool-converter.js.map

package/dist/esm/tools/tool-converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-converter.js","names":[],"sources":["../../../src/tools/tool-converter.ts"],"sourcesContent":["import { convertFunctionToolToAdapterFormat } from './function-tool'\nimport type { FunctionTool } from './function-tool'\nimport type { Tool } from '@tanstack/ai'\n\n/**\n * Converts an array of standard Tools to Vercel AI Gateway format.\n * The Gateway Chat Completions API is OpenAI-compatible, so we support function tools.\n */\nexport function convertToolsToProviderFormat(\n  tools: Array<Tool>,\n): Array<FunctionTool> {\n  return tools.map((tool) => {\n    return convertFunctionToolToAdapterFormat(tool)\n  })\n}\n"],"mappings":";;;;;;AAQA,SAAgB,6BACd,OACqB;CACrB,OAAO,MAAM,KAAK,SAAS;EACzB,OAAO,mCAAmC,IAAI;CAChD,CAAC;AACH"}

package/dist/esm/utils/client.d.ts

@@ -0,0 +1,8 @@
+import { ClientOptions } from 'openai';
+export interface VercelGatewayClientConfig extends Omit<ClientOptions, 'apiKey'> {
+    apiKey: string;
+    httpReferer?: string;
+    xTitle?: string;
+}
+export declare function getVercelGatewayApiKeyFromEnv(): string;
+export declare function withVercelGatewayDefaults(config: VercelGatewayClientConfig): ClientOptions;

package/dist/esm/utils/client.js

@@ -0,0 +1,29 @@
+import { getApiKeyFromEnv } from "@tanstack/ai-utils";
+//#region src/utils/client.ts
+function getVercelGatewayApiKeyFromEnv() {
+	try {
+		return getApiKeyFromEnv("AI_GATEWAY_API_KEY");
+	} catch {
+		try {
+			return getApiKeyFromEnv("VERCEL_OIDC_TOKEN");
+		} catch {
+			throw new Error("AI_GATEWAY_API_KEY or VERCEL_OIDC_TOKEN is required. Set one in the environment or pass apiKey to the factory.");
+		}
+	}
+}
+function withVercelGatewayDefaults(config) {
+	const { httpReferer, xTitle, defaultHeaders, ...rest } = config;
+	return {
+		...rest,
+		baseURL: config.baseURL || "https://ai-gateway.vercel.sh/v1",
+		defaultHeaders: {
+			...httpReferer ? { "http-referer": httpReferer } : {},
+			...xTitle ? { "x-title": xTitle } : {},
+			...defaultHeaders
+		}
+	};
+}
+//#endregion
+export { getVercelGatewayApiKeyFromEnv, withVercelGatewayDefaults };
+
+//# sourceMappingURL=client.js.map

package/dist/esm/utils/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":[],"sources":["../../../src/utils/client.ts"],"sourcesContent":["import { getApiKeyFromEnv } from '@tanstack/ai-utils'\nimport type { ClientOptions } from 'openai'\n\nexport interface VercelGatewayClientConfig extends Omit<\n  ClientOptions,\n  'apiKey'\n> {\n  apiKey: string\n  httpReferer?: string\n  xTitle?: string\n}\n\nexport function getVercelGatewayApiKeyFromEnv(): string {\n  try {\n    return getApiKeyFromEnv('AI_GATEWAY_API_KEY')\n  } catch {\n    try {\n      return getApiKeyFromEnv('VERCEL_OIDC_TOKEN')\n    } catch {\n      throw new Error(\n        'AI_GATEWAY_API_KEY or VERCEL_OIDC_TOKEN is required. Set one in the environment or pass apiKey to the factory.',\n      )\n    }\n  }\n}\n\nexport function withVercelGatewayDefaults(\n  config: VercelGatewayClientConfig,\n): ClientOptions {\n  const { httpReferer, xTitle, defaultHeaders, ...rest } = config\n  return {\n    ...rest,\n    baseURL: config.baseURL || 'https://ai-gateway.vercel.sh/v1',\n    defaultHeaders: {\n      ...(httpReferer ? { 'http-referer': httpReferer } : {}),\n      ...(xTitle ? { 'x-title': xTitle } : {}),\n      ...defaultHeaders,\n    },\n  }\n}\n"],"mappings":";;AAYA,SAAgB,gCAAwC;CACtD,IAAI;EACF,OAAO,iBAAiB,oBAAoB;CAC9C,QAAQ;EACN,IAAI;GACF,OAAO,iBAAiB,mBAAmB;EAC7C,QAAQ;GACN,MAAM,IAAI,MACR,gHACF;EACF;CACF;AACF;AAEA,SAAgB,0BACd,QACe;CACf,MAAM,EAAE,aAAa,QAAQ,gBAAgB,GAAG,SAAS;CACzD,OAAO;EACL,GAAG;EACH,SAAS,OAAO,WAAW;EAC3B,gBAAgB;GACd,GAAI,cAAc,EAAE,gBAAgB,YAAY,IAAI,CAAC;GACrD,GAAI,SAAS,EAAE,WAAW,OAAO,IAAI,CAAC;GACtC,GAAG;EACL;CACF;AACF"}

package/dist/esm/utils/map-gateway-options.d.ts

@@ -0,0 +1,4 @@
+import { VercelGatewayRoutingOptions } from '../text/text-provider-options.js';
+export declare function mapGatewayModelOptions(modelOptions: (Record<string, unknown> & {
+    gateway?: VercelGatewayRoutingOptions;
+}) | undefined): Record<string, unknown>;

package/dist/esm/utils/map-gateway-options.js

@@ -0,0 +1,14 @@
+//#region src/utils/map-gateway-options.ts
+function mapGatewayModelOptions(modelOptions) {
+	if (!modelOptions) return {};
+	const { gateway, ...rest } = modelOptions;
+	if (gateway === void 0) return rest;
+	return {
+		...rest,
+		providerOptions: { gateway }
+	};
+}
+//#endregion
+export { mapGatewayModelOptions };
+
+//# sourceMappingURL=map-gateway-options.js.map

package/dist/esm/utils/map-gateway-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-gateway-options.js","names":[],"sources":["../../../src/utils/map-gateway-options.ts"],"sourcesContent":["import type { VercelGatewayRoutingOptions } from '../text/text-provider-options'\n\nexport function mapGatewayModelOptions(\n  modelOptions:\n    | (Record<string, unknown> & { gateway?: VercelGatewayRoutingOptions })\n    | undefined,\n): Record<string, unknown> {\n  if (!modelOptions) return {}\n  const { gateway, ...rest } = modelOptions\n  if (gateway === undefined) return rest\n  return {\n    ...rest,\n    providerOptions: { gateway },\n  }\n}\n"],"mappings":";AAEA,SAAgB,uBACd,cAGyB;CACzB,IAAI,CAAC,cAAc,OAAO,CAAC;CAC3B,MAAM,EAAE,SAAS,GAAG,SAAS;CAC7B,IAAI,YAAY,KAAA,GAAW,OAAO;CAClC,OAAO;EACL,GAAG;EACH,iBAAiB,EAAE,QAAQ;CAC7B;AACF"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@tanstack/ai-vercel-gateway",
+  "version": "0.0.1",
+  "description": "Vercel AI Gateway adapter for TanStack AI chat, embeddings, and image generation.",
+  "author": "Tanner Linsley",
+  "license": "MIT",
+  "homepage": "https://tanstack.com/ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TanStack/ai.git",
+    "directory": "packages/ai-vercel-gateway"
+  },
+  "bugs": {
+    "url": "https://github.com/TanStack/ai/issues"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/tannerlinsley"
+  },
+  "type": "module",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js"
+    },
+    "./tools": {
+      "types": "./dist/esm/tools/index.d.ts",
+      "import": "./dist/esm/tools/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "keywords": [
+    "ai",
+    "ai-sdk",
+    "typescript",
+    "tanstack",
+    "vercel",
+    "ai-gateway",
+    "adapter",
+    "llm",
+    "chat",
+    "embeddings",
+    "image-generation"
+  ],
+  "devDependencies": {
+    "@vitest/coverage-v8": "4.0.14",
+    "vite": "^8.1.4"
+  },
+  "peerDependencies": {
+    "zod": "^4.0.0",
+    "@tanstack/ai": "^0.44.0"
+  },
+  "dependencies": {
+    "openai": "^6.41.0",
+    "@tanstack/openai-base": "^0.9.12",
+    "@tanstack/ai-utils": "^0.4.0"
+  },
+  "scripts": {
+    "build": "vite build",
+    "clean": "premove ./build ./dist",
+    "lint:fix": "oxlint src --type-aware --fix",
+    "test:build": "publint --strict",
+    "test:oxlint": "oxlint src --type-aware",
+    "test:lib": "vitest run",
+    "test:lib:dev": "pnpm test:lib --watch",
+    "test:types": "tsc"
+  }
+}

package/src/adapters/embedding.ts

@@ -0,0 +1,122 @@
+import OpenAI from 'openai'
+import { BaseEmbeddingAdapter } from '@tanstack/ai/adapters'
+import { toRunErrorPayload } from '@tanstack/ai/adapter-internals'
+import { generateId } from '@tanstack/ai-utils'
+import { requireTextOnlyEmbeddingInput } from '@tanstack/ai'
+import {
+  getVercelGatewayApiKeyFromEnv,
+  withVercelGatewayDefaults,
+} from '../utils/client'
+import { mapGatewayModelOptions } from '../utils/map-gateway-options'
+import type {
+  EmbeddingOptions,
+  EmbeddingResult,
+  TokenUsage,
+} from '@tanstack/ai'
+import type OpenAI_SDK from 'openai'
+import type {
+  VercelGatewayEmbeddingModel,
+  VercelGatewayEmbeddingModelInputModalitiesByName,
+  VercelGatewayEmbeddingModelProviderOptionsByName,
+} from '../model-meta'
+import type { VercelGatewayEmbeddingProviderOptions } from '../embedding/embedding-provider-options'
+import type { VercelGatewayClientConfig } from '../utils/client'
+
+export interface VercelGatewayEmbeddingConfig extends VercelGatewayClientConfig {}
+
+/**
+ * Vercel AI Gateway embedding adapter.
+ *
+ * Talks to `POST /v1/embeddings` on the public OpenAI-compatible Gateway API.
+ */
+export class VercelGatewayEmbeddingAdapter<
+  TModel extends VercelGatewayEmbeddingModel,
+> extends BaseEmbeddingAdapter<
+  TModel,
+  VercelGatewayEmbeddingProviderOptions,
+  VercelGatewayEmbeddingModelProviderOptionsByName,
+  VercelGatewayEmbeddingModelInputModalitiesByName
+> {
+  readonly name = 'vercel-gateway' as const
+
+  protected client: OpenAI
+
+  constructor(config: VercelGatewayEmbeddingConfig, model: TModel) {
+    super(model, {})
+    this.client = new OpenAI(withVercelGatewayDefaults(config))
+  }
+
+  async createEmbeddings(
+    options: EmbeddingOptions<VercelGatewayEmbeddingProviderOptions>,
+  ): Promise<EmbeddingResult> {
+    const { model, logger } = options
+    const texts = requireTextOnlyEmbeddingInput(options.input, this.name, model)
+    const mapped = mapGatewayModelOptions(
+      options.modelOptions as Record<string, unknown> | undefined,
+    )
+
+    try {
+      const request: OpenAI_SDK.EmbeddingCreateParams = {
+        ...mapped,
+        model,
+        input: texts,
+        encoding_format: 'float',
+      }
+      if (options.dimensions !== undefined) {
+        request.dimensions = options.dimensions
+      }
+
+      logger.request(
+        `activity=embed provider=${this.name} model=${model} inputs=${texts.length}`,
+        { provider: this.name, model },
+      )
+
+      const response = await this.client.embeddings.create(request)
+
+      const usage: TokenUsage = {
+        promptTokens: response.usage.prompt_tokens,
+        completionTokens: 0,
+        totalTokens: response.usage.total_tokens,
+      }
+
+      return {
+        id: generateId(this.name),
+        model,
+        embeddings: response.data.map((item) => ({
+          vector: item.embedding,
+          index: item.index,
+        })),
+        usage,
+      }
+    } catch (error: unknown) {
+      logger.errors(`${this.name}.createEmbeddings fatal`, {
+        error: toRunErrorPayload(error, `${this.name}.createEmbeddings failed`),
+        source: `${this.name}.createEmbeddings`,
+      })
+      throw error
+    }
+  }
+}
+
+export function createVercelGatewayEmbedding<
+  TModel extends VercelGatewayEmbeddingModel,
+>(
+  model: TModel,
+  apiKey: string,
+  config?: Omit<VercelGatewayEmbeddingConfig, 'apiKey'>,
+): VercelGatewayEmbeddingAdapter<TModel> {
+  return new VercelGatewayEmbeddingAdapter({ apiKey, ...config }, model)
+}
+
+export function vercelGatewayEmbedding<
+  TModel extends VercelGatewayEmbeddingModel,
+>(
+  model: TModel,
+  config?: Omit<VercelGatewayEmbeddingConfig, 'apiKey'>,
+): VercelGatewayEmbeddingAdapter<TModel> {
+  return createVercelGatewayEmbedding(
+    model,
+    getVercelGatewayApiKeyFromEnv(),
+    config,
+  )
+}

package/src/adapters/factory.ts

@@ -0,0 +1,81 @@
+import { getVercelGatewayApiKeyFromEnv } from '../utils/client'
+import { VercelGatewayTextAdapter } from './text'
+import { VercelGatewayResponsesTextAdapter } from './responses-text'
+import type { VercelGatewayClientConfig } from '../utils/client'
+import type { VercelGatewayTextConfig } from './text'
+import type { VercelGatewayResponsesTextConfig } from './responses-text'
+import type { VercelGatewayChatModel } from '../model-meta'
+
+export type VercelGatewayTextApi = 'responses' | 'chat' | 'chat-completions'
+
+/** Config for the branching factory's Responses mode (default, or api: 'responses'). */
+export type VercelGatewayResponsesApiConfig = Omit<
+  VercelGatewayResponsesTextConfig,
+  'apiKey'
+> & {
+  api?: 'responses'
+}
+
+/** Config for the branching factory's Chat Completions mode (api required). */
+export type VercelGatewayChatApiConfig = Omit<
+  VercelGatewayTextConfig,
+  'apiKey'
+> & {
+  api: 'chat' | 'chat-completions'
+}
+
+type AnyVercelGatewayTextAdapter<TModel extends VercelGatewayChatModel> =
+  | VercelGatewayResponsesTextAdapter<TModel>
+  | VercelGatewayTextAdapter<TModel>
+
+function stripApi<T extends { api?: unknown }>(config: T): Omit<T, 'api'> {
+  const { api, ...rest } = config
+  void api
+  return rest
+}
+
+function build<TModel extends VercelGatewayChatModel>(
+  model: TModel,
+  config: VercelGatewayClientConfig & { api?: VercelGatewayTextApi },
+): AnyVercelGatewayTextAdapter<TModel> {
+  if (config.api === 'chat' || config.api === 'chat-completions') {
+    return new VercelGatewayTextAdapter(stripApi(config), model)
+  }
+  return new VercelGatewayResponsesTextAdapter(stripApi(config), model)
+}
+
+export function createVercelGatewayText<TModel extends VercelGatewayChatModel>(
+  model: TModel,
+  apiKey: string,
+  config?: VercelGatewayResponsesApiConfig,
+): VercelGatewayResponsesTextAdapter<TModel>
+export function createVercelGatewayText<TModel extends VercelGatewayChatModel>(
+  model: TModel,
+  apiKey: string,
+  config: VercelGatewayChatApiConfig,
+): VercelGatewayTextAdapter<TModel>
+export function createVercelGatewayText<TModel extends VercelGatewayChatModel>(
+  model: TModel,
+  apiKey: string,
+  config?: VercelGatewayResponsesApiConfig | VercelGatewayChatApiConfig,
+): AnyVercelGatewayTextAdapter<TModel> {
+  return build(model, { ...config, apiKey })
+}
+
+export function vercelGatewayText<TModel extends VercelGatewayChatModel>(
+  model: TModel,
+  config?: VercelGatewayResponsesApiConfig,
+): VercelGatewayResponsesTextAdapter<TModel>
+export function vercelGatewayText<TModel extends VercelGatewayChatModel>(
+  model: TModel,
+  config: VercelGatewayChatApiConfig,
+): VercelGatewayTextAdapter<TModel>
+export function vercelGatewayText<TModel extends VercelGatewayChatModel>(
+  model: TModel,
+  config?: VercelGatewayResponsesApiConfig | VercelGatewayChatApiConfig,
+): AnyVercelGatewayTextAdapter<TModel> {
+  return build(model, {
+    ...config,
+    apiKey: getVercelGatewayApiKeyFromEnv(),
+  })
+}

package/src/adapters/image.ts

@@ -0,0 +1,156 @@
+import OpenAI from 'openai'
+import { resolveMediaPrompt } from '@tanstack/ai'
+import { BaseImageAdapter } from '@tanstack/ai/adapters'
+import { toRunErrorPayload } from '@tanstack/ai/adapter-internals'
+import { buildImagesUsage } from '@tanstack/openai-base'
+import { generateId } from '@tanstack/ai-utils'
+import {
+  getVercelGatewayApiKeyFromEnv,
+  withVercelGatewayDefaults,
+} from '../utils/client'
+import { mapGatewayModelOptions } from '../utils/map-gateway-options'
+import type {
+  GeneratedImage,
+  ImageGenerationOptions,
+  ImageGenerationResult,
+} from '@tanstack/ai'
+import type OpenAI_SDK from 'openai'
+import type {
+  VercelGatewayImageModel,
+  VercelGatewayImageModelInputModalitiesByName,
+  VercelGatewayImageModelProviderOptionsByName,
+  VercelGatewayImageModelSizeByName,
+} from '../model-meta'
+import type { VercelGatewayImageProviderOptions } from '../image/image-provider-options'
+import type { VercelGatewayClientConfig } from '../utils/client'
+
+export interface VercelGatewayImageConfig extends VercelGatewayClientConfig {}
+
+/**
+ * Vercel AI Gateway image adapter.
+ *
+ * Text-to-image only via `POST /v1/images/generations`.
+ */
+export class VercelGatewayImageAdapter<
+  TModel extends VercelGatewayImageModel,
+> extends BaseImageAdapter<
+  TModel,
+  VercelGatewayImageProviderOptions,
+  VercelGatewayImageModelProviderOptionsByName,
+  VercelGatewayImageModelSizeByName,
+  VercelGatewayImageModelInputModalitiesByName
+> {
+  override readonly kind = 'image' as const
+  readonly name = 'vercel-gateway' as const
+
+  protected client: OpenAI
+
+  constructor(config: VercelGatewayImageConfig, model: TModel) {
+    super(model, {})
+    this.client = new OpenAI(withVercelGatewayDefaults(config))
+  }
+
+  async generateImages(
+    options: ImageGenerationOptions<VercelGatewayImageProviderOptions>,
+  ): Promise<ImageGenerationResult> {
+    const { model, numberOfImages, size, logger } = options
+    const resolved = resolveMediaPrompt(options.prompt)
+    const prompt = resolved.text
+
+    if (resolved.videos.length > 0) {
+      throw new Error(
+        `${this.name}.generateImages does not support video prompt parts (model: ${model}).`,
+      )
+    }
+    if (resolved.audios.length > 0) {
+      throw new Error(
+        `${this.name}.generateImages does not support audio prompt parts (model: ${model}).`,
+      )
+    }
+    if (resolved.images.length > 0) {
+      throw new Error(
+        `${this.name}.generateImages does not support image edits in v1 (model: ${model}).`,
+      )
+    }
+
+    const mapped = mapGatewayModelOptions(
+      options.modelOptions as Record<string, unknown> | undefined,
+    )
+    const request: OpenAI_SDK.Images.ImageGenerateParams = {
+      ...mapped,
+      model,
+      prompt,
+      n: numberOfImages ?? 1,
+    }
+    if (size !== undefined) {
+      request.size = size
+    }
+
+    try {
+      logger.request(
+        `activity=image provider=${this.name} model=${model} n=${request.n ?? 1} size=${request.size ?? 'default'}`,
+        { provider: this.name, model },
+      )
+      const response = await this.client.images.generate({
+        ...request,
+        stream: false,
+      })
+
+      const images: Array<GeneratedImage> = (response.data ?? []).flatMap(
+        (item): Array<GeneratedImage> => {
+          const revisedPromptField =
+            item.revised_prompt !== undefined
+              ? { revisedPrompt: item.revised_prompt }
+              : {}
+          if (item.b64_json) {
+            return [{ b64Json: item.b64_json, ...revisedPromptField }]
+          }
+          if (item.url) {
+            return [{ url: item.url, ...revisedPromptField }]
+          }
+          return []
+        },
+      )
+
+      if (images.length === 0) {
+        throw new Error(`${this.name}: image response contained no images`)
+      }
+
+      const usage = buildImagesUsage(response.usage)
+
+      return {
+        id: generateId(this.name),
+        model,
+        images,
+        ...(usage ? { usage } : {}),
+      }
+    } catch (error: unknown) {
+      logger.errors(`${this.name}.generateImages fatal`, {
+        error: toRunErrorPayload(error, `${this.name}.generateImages failed`),
+        source: `${this.name}.generateImages`,
+      })
+      throw error
+    }
+  }
+}
+
+export function createVercelGatewayImage<
+  TModel extends VercelGatewayImageModel,
+>(
+  model: TModel,
+  apiKey: string,
+  config?: Omit<VercelGatewayImageConfig, 'apiKey'>,
+): VercelGatewayImageAdapter<TModel> {
+  return new VercelGatewayImageAdapter({ apiKey, ...config }, model)
+}
+
+export function vercelGatewayImage<TModel extends VercelGatewayImageModel>(
+  model: TModel,
+  config?: Omit<VercelGatewayImageConfig, 'apiKey'>,
+): VercelGatewayImageAdapter<TModel> {
+  return createVercelGatewayImage(
+    model,
+    getVercelGatewayApiKeyFromEnv(),
+    config,
+  )
+}