@ai-sdk/openai 4.0.104 → 4.0.106

package/src/image/openai-image-model.ts

@@ -4,6 +4,7 @@ import type {
   SharedV4Warning,
 } from '@ai-sdk/provider';
 import {
+  resolve,
   combineHeaders,
   convertBase64ToUint8Array,
   convertToFormData,
@@ -18,6 +19,7 @@ import {
 } from '@ai-sdk/provider-utils';
 import type { OpenAIConfig } from '../openai-config';
 import { openaiFailedResponseHandler } from '../openai-error';
+import { getOpenAIImageModelEntry } from '../openai-model-catalog';
 import { openaiImageResponseSchema } from './openai-image-api';
 import {
   getMaxImagesPerCall,
@@ -63,24 +65,9 @@ export class OpenAIImageModel implements ImageModelV4 {
       return this.config.imageInputCapabilities.supportsFileInputs;
     }
 
-    if (
-      [
-        'dall-e-2',
-        'gpt-image-1',
-        'gpt-image-1-mini',
-        'gpt-image-1.5',
-        'gpt-image-2',
-        'gpt-image-2.5-flare',
-        'gpt-image-2.5-flare-2026-09-08',
-        'gpt-image-2.5-sunburst',
-        'gpt-image-2.5-sunburst-2026-09-08',
-        'chatgpt-image-latest',
-      ].includes(this.modelId)
-    ) {
-      return true;
-    }
-
-    return this.modelId === 'dall-e-3' ? false : undefined;
+    const support = getOpenAIImageModelEntry(this.modelId).capabilities.image
+      .fileInput;
+    return typeof support === 'boolean' ? support : undefined;
   }
 
   get supportsMaskInputs(): boolean | undefined {
@@ -88,7 +75,9 @@ export class OpenAIImageModel implements ImageModelV4 {
       return this.config.imageInputCapabilities.supportsMaskInputs;
     }
 
-    return this.supportsFileInputs;
+    const support = getOpenAIImageModelEntry(this.modelId).capabilities.image
+      .maskInput;
+    return typeof support === 'boolean' ? support : undefined;
   }
 
   get provider(): string {
@@ -144,7 +133,7 @@ export class OpenAIImageModel implements ImageModelV4 {
           path: '/images/edits',
           modelId: this.modelId,
         }),
-        headers: combineHeaders(this.config.headers?.(), headers),
+        headers: combineHeaders(await resolve(this.config.headers), headers),
         formData: convertToFormData<OpenAIImageEditInput>({
           model: this.modelId,
           prompt,
@@ -234,7 +223,7 @@ export class OpenAIImageModel implements ImageModelV4 {
         path: '/images/generations',
         modelId: this.modelId,
       }),
-      headers: combineHeaders(this.config.headers?.(), headers),
+      headers: combineHeaders(await resolve(this.config.headers), headers),
       body: {
         model: this.modelId,
         prompt,

package/src/live/openai-realtime-model-live.ts

@@ -4,6 +4,8 @@ import {
   type Experimental_RealtimeModelV4SessionConfig as RealtimeModelV4SessionConfig,
 } from '@ai-sdk/provider';
 import {
+  resolveWith,
+  resolve,
   lazySchema,
   zodSchema,
   createJsonResponseHandler,
@@ -11,6 +13,7 @@ import {
 } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
 import { openaiFailedResponseHandler } from '../openai-error';
+import { openaiLiveRealtimeCapabilities } from '../openai-model-catalog';
 import {
   createOpenAILiveServerEventParser,
   parseOpenAILiveServerEvent,
@@ -36,13 +39,7 @@ const webRTCSessionSchema = lazySchema(() =>
 
 export class OpenAIRealtimeModelLive implements RealtimeModelV4 {
   readonly specificationVersion = 'v4' as const;
-  readonly capabilities = {
-    conversation: 'continuous',
-    transports: ['websocket', 'webrtc'],
-    connections: ['server-websocket', 'webrtc'],
-    startup: 'session-start',
-    finalization: 'session-close',
-  } as const;
+  readonly capabilities = openaiLiveRealtimeCapabilities;
 
   constructor(
     readonly modelId: OpenAIRealtimeModelLiveId,
@@ -57,14 +54,16 @@ export class OpenAIRealtimeModelLive implements RealtimeModelV4 {
     return { dataChannelLabel: 'oai-events' };
   }
 
-  getServerWebSocketConfig(): { url: string; headers: Record<string, string> } {
-    const url = new URL(`${this.config.baseURL}/live/sessions`);
-    url.protocol = url.protocol === 'http:' ? 'ws:' : 'wss:';
-    const headers: Record<string, string> = {};
-    for (const [key, value] of Object.entries(this.config.headers())) {
-      if (value !== undefined) headers[key] = value;
-    }
-    return { url: url.toString(), headers };
+  getServerWebSocketConfig() {
+    return resolveWith(this.config.headers, configHeaders => {
+      const url = new URL(`${this.config.baseURL}/live/sessions`);
+      url.protocol = url.protocol === 'http:' ? 'ws:' : 'wss:';
+      const headers: Record<string, string> = {};
+      for (const [key, value] of Object.entries(configHeaders)) {
+        if (value !== undefined) headers[key] = value;
+      }
+      return { url: url.toString(), headers };
+    });
   }
 
   async doCreateWebRTCSession({
@@ -83,7 +82,7 @@ export class OpenAIRealtimeModelLive implements RealtimeModelV4 {
     );
     const { value } = await postJsonToApi({
       url: `${this.config.baseURL}/live/sessions`,
-      headers: this.config.headers(),
+      headers: await resolve(this.config.headers),
       body: {
         session,
         transport: { type: 'webrtc', sdp: z.string().min(1).parse(sdp) },

package/src/openai-batch.ts

@@ -19,6 +19,7 @@ import {
   type SharedV4Warning,
 } from '@ai-sdk/provider';
 import {
+  resolve,
   combineHeaders,
   convertAsyncIteratorToReadableStream,
   createJsonLinesResponseHandler,
@@ -267,7 +268,10 @@ export class OpenAIBatch implements BatchV4<OpenAIBatchModelIds> {
 
     const { value: uploadedFile } = await postToApi({
       url: this.getUrl('/files'),
-      headers: combineHeaders(this.options.config.headers?.(), options.headers),
+      headers: combineHeaders(
+        await resolve(this.options.config.headers),
+        options.headers,
+      ),
       body: {
         content: formData,
         values: {
@@ -291,7 +295,10 @@ export class OpenAIBatch implements BatchV4<OpenAIBatchModelIds> {
 
     const { value: batch } = await postJsonToApi({
       url: this.getUrl('/batches'),
-      headers: combineHeaders(this.options.config.headers?.(), options.headers),
+      headers: combineHeaders(
+        await resolve(this.options.config.headers),
+        options.headers,
+      ),
       body: {
         input_file_id: uploadedFile.id,
         endpoint: openaiBatchEndpoint,
@@ -357,7 +364,10 @@ export class OpenAIBatch implements BatchV4<OpenAIBatchModelIds> {
       url: this.getUrl(
         `/batches/${encodeURIComponent(options.batchId)}/cancel`,
       ),
-      headers: combineHeaders(this.options.config.headers?.(), options.headers),
+      headers: combineHeaders(
+        await resolve(this.options.config.headers),
+        options.headers,
+      ),
       body: {},
       failedResponseHandler: openaiFailedResponseHandler,
       successfulResponseHandler: createJsonResponseHandler(
@@ -381,7 +391,10 @@ export class OpenAIBatch implements BatchV4<OpenAIBatchModelIds> {
 
     const { value: page } = await getFromApi({
       url: url.toString(),
-      headers: combineHeaders(this.options.config.headers?.(), options.headers),
+      headers: combineHeaders(
+        await resolve(this.options.config.headers),
+        options.headers,
+      ),
       failedResponseHandler: openaiFailedResponseHandler,
       successfulResponseHandler: createJsonResponseHandler(
         openaiBatchListResponseSchema,
@@ -437,7 +450,10 @@ export class OpenAIBatch implements BatchV4<OpenAIBatchModelIds> {
   ): Promise<OpenAIBatchResponse> {
     const { value: batch } = await getFromApi({
       url: this.getUrl(`/batches/${encodeURIComponent(options.batchId)}`),
-      headers: combineHeaders(this.options.config.headers?.(), options.headers),
+      headers: combineHeaders(
+        await resolve(this.options.config.headers),
+        options.headers,
+      ),
       failedResponseHandler: openaiFailedResponseHandler,
       successfulResponseHandler: createJsonResponseHandler(
         openaiBatchResponseSchema,
@@ -461,7 +477,7 @@ export class OpenAIBatch implements BatchV4<OpenAIBatchModelIds> {
       const { value: lines } = await getFromApi({
         url: this.getUrl(`/files/${encodeURIComponent(fileId)}/content`),
         headers: combineHeaders(
-          this.options.config.headers?.(),
+          await resolve(this.options.config.headers),
           options.headers,
         ),
         failedResponseHandler: openaiFailedResponseHandler,

package/src/openai-config.ts

@@ -1,4 +1,5 @@
 import type {
+  Resolvable,
   FetchFunction,
   WebSocketConstructor,
 } from '@ai-sdk/provider-utils';
@@ -15,7 +16,7 @@ export type OpenAIConfig = {
   requestModelId?: string;
   baseURL?: string;
   url: (options: { modelId: string; path: string }) => string;
-  headers?: () => OpenAIHeaders;
+  headers?: Resolvable<OpenAIHeaders>;
   fetch?: FetchFunction;
   webSocket?: WebSocketConstructor;
   generateId?: () => string;

package/src/openai-decision-model-options.ts

@@ -10,6 +10,7 @@ export const openaiDecisionModelOptions = lazySchema(() =>
     z.object({
       /** An opaque end-user identifier for safety monitoring, up to 128 characters. */
       safetyIdentifier: z.string().max(128).optional(),
+      promptCacheKey: z.string().optional(),
     }),
   ),
 );

package/src/openai-decision-model.ts

@@ -4,8 +4,11 @@ import {
   type Experimental_DecisionModelV4 as DecisionModelV4,
   type Experimental_DecisionModelV4Answer as DecisionModelV4Answer,
   type Experimental_DecisionModelV4Input as DecisionModelV4Input,
+  type JSONObject,
+  type JSONValue,
 } from '@ai-sdk/provider';
 import {
+  resolve,
   lazySchema,
   zodSchema,
   combineHeaders,
@@ -144,10 +147,11 @@ export class DecisionOpenAIModel implements DecisionModelV4 {
       responseHeaders,
     } = await postJsonToApi({
       url: this.config.url({ path: '/decisions', modelId: this.modelId }),
-      headers: combineHeaders(this.config.headers?.(), headers),
+      headers: combineHeaders(await resolve(this.config.headers), headers),
       body: {
         model: this.modelId,
         safety_identifier: openaiOptions?.safetyIdentifier,
+        prompt_cache_key: openaiOptions?.promptCacheKey,
         input: [
           {
             role: 'user',
@@ -155,10 +159,9 @@ export class DecisionOpenAIModel implements DecisionModelV4 {
               if (part.type === 'text')
                 return { type: 'input_text', text: part.text };
               if (part.type === 'json')
-                return {
-                  type: 'input_text',
-                  text: JSON.stringify(part.value),
-                };
+                return isInputJsonData(part.value)
+                  ? { type: 'input_json', data: part.value }
+                  : { type: 'input_text', text: JSON.stringify(part.value) };
               if (part.data.type !== 'data') {
                 throw new UnsupportedFunctionalityError({
                   functionality: `OpenAI decision file input: ${part.mediaType} (${part.data.type})`,
@@ -323,7 +326,7 @@ export class DecisionOpenAIModel implements DecisionModelV4 {
           ? [{ type: 'unsupported' as const, feature: 'reasoning' }]
           : []),
         ...Object.keys(providerOptions?.openai ?? {})
-          .filter(option => option !== 'safetyIdentifier')
+          .filter(option => !SUPPORTED_PROVIDER_OPTIONS.has(option))
           .map(option => ({
             type: 'unsupported' as const,
             feature: `providerOptions.openai.${option}`,
@@ -351,6 +354,45 @@ export class DecisionOpenAIModel implements DecisionModelV4 {
   }
 }
 
+const SUPPORTED_PROVIDER_OPTIONS = new Set([
+  'safetyIdentifier',
+  'promptCacheKey',
+]);
+
 function toText(input: DecisionModelV4Input): string {
   return typeof input === 'string' ? input : JSON.stringify(input);
 }
+
+const INPUT_JSON_MAX_DEPTH = 32;
+const INPUT_JSON_MAX_VALUES = 10_000;
+const INPUT_JSON_MAX_BYTES = 256 * 1024;
+
+function isInputJsonData(value: JSONValue): value is JSONObject | JSONObject[] {
+  const hasInputJsonShape = Array.isArray(value)
+    ? value.length > 0 && value.every(isJSONObject)
+    : isJSONObject(value);
+  return hasInputJsonShape && fitsInputJsonLimits(value);
+}
+
+function fitsInputJsonLimits(value: JSONValue): boolean {
+  let count = 0;
+  const visit = (node: JSONValue | undefined, depth: number): boolean => {
+    count += 1;
+    if (count > INPUT_JSON_MAX_VALUES) return false;
+    if (node === null || typeof node !== 'object') return true;
+    if (depth > INPUT_JSON_MAX_DEPTH) return false;
+    const children: readonly (JSONValue | undefined)[] = Array.isArray(node)
+      ? node
+      : Object.values(node);
+    return children.every(child => visit(child, depth + 1));
+  };
+  return (
+    visit(value, 1) &&
+    new TextEncoder().encode(JSON.stringify(value)).length <=
+      INPUT_JSON_MAX_BYTES
+  );
+}
+
+function isJSONObject(value: JSONValue): value is JSONObject {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}