@ai-sdk/openai 4.0.105 → 4.0.106

package/docs/03-openai.mdx

@@ -99,11 +99,14 @@ You can use the following optional settings to customize the OpenAI provider ins
   chat models with `openai.chat('model-id')` instead, or use the
   [OpenAI-compatible provider](/providers/openai-compatible-providers).
 
-- **apiKey** _string_
+- **apiKey** _string | PromiseLike<string> | (() => string | PromiseLike<string>)_
 
   API key that is being sent using the `Authorization` header.
   It defaults to the `OPENAI_API_KEY` environment variable.
 
+  A function is called before each request and may return a promise. Use it to
+  supply refreshed credentials; a promise value resolves to the same key each time.
+
 - **name** _string_
 
   The provider name. You can set this when using OpenAI compatible providers
@@ -3065,6 +3068,8 @@ The following optional provider options are available for OpenAI completion mode
 
 ### Model Capabilities
 
+{/* model-capabilities:openai-language:start */}
+
 | Model                 | Image Input | Audio Input | Object Generation | Tool Usage |
 | --------------------- | ----------- | ----------- | ----------------- | ---------- |
 | `gpt-6-astra`         | <Check />   | <Cross />   | <Check />         | <Check />  |
@@ -3101,6 +3106,8 @@ The following optional provider options are available for OpenAI completion mode
 | `gpt-4o`              | <Check />   | <Cross />   | <Check />         | <Check />  |
 | `gpt-4o-mini`         | <Check />   | <Cross />   | <Check />         | <Check />  |
 
+{/* model-capabilities:openai-language:end */}
+
 <Note>
   The table above lists popular models. Please see the [OpenAI
   docs](https://platform.openai.com/docs/models) for a full list of available
@@ -3108,6 +3115,53 @@ The following optional provider options are available for OpenAI completion mode
   provider model ID as a string if needed.
 </Note>
 
+#### Request Capabilities
+
+Reasoning and sampling support depend on the selected model and request options.
+Conditional cells describe when a parameter is supported. "Not declared" means
+the catalog does not enumerate reasoning efforts; it does not mean every effort
+is supported.
+
+{/* model-capabilities:openai-language-request:start */}
+
+| Model                 | Reasoning | Reasoning Efforts                               | Temperature                                      | Top P                                            |
+| --------------------- | --------- | ----------------------------------------------- | ------------------------------------------------ | ------------------------------------------------ |
+| `gpt-6-astra`         | <Check /> | `low`, `medium`, `high`, `xhigh`, `max`         | <Cross />                                        | <Cross />                                        |
+| `gpt-6.1-sol`         | <Check /> | `low`, `medium`, `high`, `xhigh`, `max`         | <Cross />                                        | <Cross />                                        |
+| `gpt-6.1-terra`       | <Check /> | `none`, `low`, `medium`, `high`, `xhigh`, `max` | Conditional: Only when reasoning effort is none. | Conditional: Only when reasoning effort is none. |
+| `gpt-6-luna`          | <Check /> | `none`, `low`, `medium`, `high`, `xhigh`, `max` | Conditional: Only when reasoning effort is none. | Conditional: Only when reasoning effort is none. |
+| `gpt-6-sol`           | <Check /> | `none`, `low`, `medium`, `high`, `xhigh`, `max` | Conditional: Only when reasoning effort is none. | Conditional: Only when reasoning effort is none. |
+| `gpt-5.6`             | <Check /> | `none`, `low`, `medium`, `high`, `xhigh`, `max` | Conditional: Only when reasoning effort is none. | Conditional: Only when reasoning effort is none. |
+| `gpt-5.6-luna`        | <Check /> | `none`, `low`, `medium`, `high`, `xhigh`, `max` | Conditional: Only when reasoning effort is none. | Conditional: Only when reasoning effort is none. |
+| `gpt-5.6-sol`         | <Check /> | `none`, `low`, `medium`, `high`, `xhigh`, `max` | Conditional: Only when reasoning effort is none. | Conditional: Only when reasoning effort is none. |
+| `gpt-5.6-terra`       | <Check /> | `none`, `low`, `medium`, `high`, `xhigh`, `max` | Conditional: Only when reasoning effort is none. | Conditional: Only when reasoning effort is none. |
+| `gpt-5.5`             | <Check /> | `none`, `low`, `medium`, `high`, `xhigh`        | Conditional: Only when reasoning effort is none. | Conditional: Only when reasoning effort is none. |
+| `gpt-5.4-pro`         | <Check /> | Not declared                                    | Conditional: Only when reasoning effort is none. | Conditional: Only when reasoning effort is none. |
+| `gpt-5.4`             | <Check /> | `none`, `low`, `medium`, `high`, `xhigh`        | Conditional: Only when reasoning effort is none. | Conditional: Only when reasoning effort is none. |
+| `gpt-5.4-mini`        | <Check /> | `none`, `low`, `medium`, `high`, `xhigh`        | Conditional: Only when reasoning effort is none. | Conditional: Only when reasoning effort is none. |
+| `gpt-5.4-nano`        | <Check /> | `none`, `low`, `medium`, `high`, `xhigh`        | Conditional: Only when reasoning effort is none. | Conditional: Only when reasoning effort is none. |
+| `gpt-5.3-chat-latest` | <Check /> | Not declared                                    | Conditional: Only when reasoning effort is none. | Conditional: Only when reasoning effort is none. |
+| `gpt-5.2-pro`         | <Check /> | Not declared                                    | Conditional: Only when reasoning effort is none. | Conditional: Only when reasoning effort is none. |
+| `gpt-5.2-chat-latest` | <Check /> | Not declared                                    | Conditional: Only when reasoning effort is none. | Conditional: Only when reasoning effort is none. |
+| `gpt-5.2`             | <Check /> | `none`, `low`, `medium`, `high`, `xhigh`        | Conditional: Only when reasoning effort is none. | Conditional: Only when reasoning effort is none. |
+| `gpt-5.1-codex-mini`  | <Check /> | Not declared                                    | Conditional: Only when reasoning effort is none. | Conditional: Only when reasoning effort is none. |
+| `gpt-5.1-codex`       | <Check /> | Not declared                                    | Conditional: Only when reasoning effort is none. | Conditional: Only when reasoning effort is none. |
+| `gpt-5.1-chat-latest` | <Check /> | Not declared                                    | Conditional: Only when reasoning effort is none. | Conditional: Only when reasoning effort is none. |
+| `gpt-5.1`             | <Check /> | `none`, `low`, `medium`, `high`                 | Conditional: Only when reasoning effort is none. | Conditional: Only when reasoning effort is none. |
+| `gpt-5-pro`           | <Check /> | Not declared                                    | <Cross />                                        | <Cross />                                        |
+| `gpt-5`               | <Check /> | `minimal`, `low`, `medium`, `high`              | <Cross />                                        | <Cross />                                        |
+| `gpt-5-mini`          | <Check /> | `minimal`, `low`, `medium`, `high`              | <Cross />                                        | <Cross />                                        |
+| `gpt-5-nano`          | <Check /> | `minimal`, `low`, `medium`, `high`              | <Cross />                                        | <Cross />                                        |
+| `gpt-5-codex`         | <Check /> | Not declared                                    | <Cross />                                        | <Cross />                                        |
+| `gpt-5-chat-latest`   | <Cross /> | Not declared                                    | <Check />                                        | <Check />                                        |
+| `gpt-4.1`             | <Cross /> | Not declared                                    | <Check />                                        | <Check />                                        |
+| `gpt-4.1-mini`        | <Cross /> | Not declared                                    | <Check />                                        | <Check />                                        |
+| `gpt-4.1-nano`        | <Cross /> | Not declared                                    | <Check />                                        | <Check />                                        |
+| `gpt-4o`              | <Cross /> | Not declared                                    | <Check />                                        | <Check />                                        |
+| `gpt-4o-mini`         | <Cross /> | Not declared                                    | <Check />                                        | <Check />                                        |
+
+{/* model-capabilities:openai-language-request:end */}
+
 ## Realtime Models
 
 <Note type="warning">Realtime is an experimental feature.</Note>
@@ -3136,8 +3190,9 @@ Live supports **browser WSS sessions through an application-owned relay with cli
 delegation**, using `experimental_useRealtime` for the browser runtime, and optional
 browser-direct WebRTC. Your application owns the agent and tool execution; Live
 delegations do not invoke `onToolCall`. For a low-level server adapter, obtain server-only connection
-settings with `liveModel.getServerWebSocketConfig()` and serialize commands with
-`liveModel.serializeClientEvent()`. Create one parser per connection with
+settings with `await liveModel.getServerWebSocketConfig()` and serialize commands with
+`liveModel.serializeClientEvent()`. Connection settings resolve asynchronously when
+using an asynchronous API key supplier. Create one parser per connection with
 `liveModel.createServerEventParser()` and pass incoming JSON to the returned
 function. It returns arrays of normalized events and retains each original event
 in `raw`.
@@ -3227,6 +3282,17 @@ relays. Continuous conversation semantics do not imply browser support for every
 provider codec or transport. The [Realtime guide](/docs/ai-sdk-core/realtime) covers
 legacy token-based, turn-based sessions.
 
+### Model Capabilities
+
+{/* model-capabilities:openai-realtime:start */}
+
+| Model          | Conversation | Transports        |
+| -------------- | ------------ | ----------------- |
+| `gpt-live-1`   | continuous   | websocket, webrtc |
+| `gpt-realtime` | turn-based   | websocket         |
+
+{/* model-capabilities:openai-realtime:end */}
+
 ## Embedding Models
 
 You can create models that call the [OpenAI embeddings API](https://platform.openai.com/docs/api-reference/embeddings)
@@ -3269,12 +3335,16 @@ The following optional provider options are available for OpenAI embedding model
 
 ### Model Capabilities
 
+{/* model-capabilities:openai-embedding:start */}
+
 | Model                    | Default Dimensions | Custom Dimensions |
 | ------------------------ | ------------------ | ----------------- |
 | `text-embedding-3-large` | 3072               | <Check />         |
 | `text-embedding-3-small` | 1536               | <Check />         |
 | `text-embedding-ada-002` | 1536               | <Cross />         |
 
+{/* model-capabilities:openai-embedding:end */}
+
 ## Image Models
 
 You can create models that call the [OpenAI image generation API](https://platform.openai.com/docs/api-reference/images)
@@ -3379,6 +3449,8 @@ const { images } = await generateImage({
 
 ### Model Capabilities
 
+{/* model-capabilities:openai-image:start */}
+
 | Model                    | Sizes                                  |
 | ------------------------ | -------------------------------------- |
 | `gpt-image-2.5-flare`    | Standard presets and custom dimensions |
@@ -3390,6 +3462,8 @@ const { images } = await generateImage({
 | `dall-e-3`               | 1024x1024, 1792x1024, 1024x1792        |
 | `dall-e-2`               | 256x256, 512x512, 1024x1024            |
 
+{/* model-capabilities:openai-image:end */}
+
 Use `gpt-image-2.5-flare` for fast, general-purpose image generation and
 `gpt-image-2.5-sunburst` when editing precision and instruction following are
 the priority. Both models accept custom `WIDTHxHEIGHT` sizes whose dimensions
@@ -3547,6 +3621,8 @@ The following provider options are available:
 
 ### Model Capabilities
 
+{/* model-capabilities:openai-transcription:start */}
+
 | Model                       | Transcription | Streaming | Duration  | Segments  | Language  |
 | --------------------------- | ------------- | --------- | --------- | --------- | --------- |
 | `whisper-1`                 | <Check />     | <Cross /> | <Check /> | <Check /> | <Check /> |
@@ -3557,6 +3633,8 @@ The following provider options are available:
 | `gpt-live-transcribe`       | <Cross />     | <Check /> | <Cross /> | <Cross /> | <Cross /> |
 | `gpt-realtime-whisper`      | <Cross />     | <Check /> | <Cross /> | <Cross /> | <Cross /> |
 
+{/* model-capabilities:openai-transcription:end */}
+
 ## Translation Models
 
 <Note type="warning">Speech translation is an experimental feature.</Note>
@@ -3597,10 +3675,14 @@ Unsupported source and output settings surface as call warnings.
 
 ### Model Capabilities
 
+{/* model-capabilities:openai-speech-translation:start */}
+
 | Model                    | Translated Audio | Translated Text | Source Transcript |
 | ------------------------ | ---------------- | --------------- | ----------------- |
 | `gpt-realtime-translate` | <Check />        | <Check />       | <Check />         |
 
+{/* model-capabilities:openai-speech-translation:end */}
+
 ## Speech Models
 
 You can create models that call the [OpenAI speech API](https://platform.openai.com/docs/api-reference/audio/speech)
@@ -3656,12 +3738,16 @@ const result = await generateSpeech({
 
 ### Model Capabilities
 
+{/* model-capabilities:openai-speech:start */}
+
 | Model             | Instructions |
 | ----------------- | ------------ |
-| `tts-1`           | <Check />    |
-| `tts-1-hd`        | <Check />    |
+| `tts-1`           | <Cross />    |
+| `tts-1-hd`        | <Cross />    |
 | `gpt-4o-mini-tts` | <Check />    |
 
+{/* model-capabilities:openai-speech:end */}
+
 ## Decision Models
 
 Create an experimental decision model with `openai.decisionModel(modelId)`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/openai",
-  "version": "4.0.105",
+  "version": "4.0.106",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -35,8 +35,8 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/provider": "4.0.34",
-    "@ai-sdk/provider-utils": "5.0.71"
+    "@ai-sdk/provider": "4.0.35",
+    "@ai-sdk/provider-utils": "5.0.72"
   },
   "devDependencies": {
     "@ai-sdk/test-server": "2.0.4",

package/src/chat/openai-chat-language-model.ts

@@ -11,6 +11,8 @@ import {
   type SharedV4Warning,
 } from '@ai-sdk/provider';
 import {
+  type Resolvable,
+  resolve,
   StreamingToolCallTracker,
   combineHeaders,
   createEventSourceResponseHandler,
@@ -26,14 +28,12 @@ import {
   type ParseResult,
 } from '@ai-sdk/provider-utils';
 import { openaiFailedResponseHandler } from '../openai-error';
-import {
-  getOpenAILanguageModelCapabilities,
-  resolveOpenAIReasoningEffort,
-} from '../openai-language-model-capabilities';
+import { getOpenAILanguageModelEntry } from '../openai-model-catalog';
 import {
   createOpenAIProviderStreamError,
   throwIfOpenAIStreamErrorBeforeOutput,
 } from '../openai-stream-error';
+import { resolveOpenAIReasoningEffort } from '../resolve-openai-reasoning-effort';
 import {
   convertOpenAIChatUsage,
   type OpenAIChatUsage,
@@ -57,7 +57,7 @@ type OpenAIChatConfig = {
   provider: string;
   /** Model ID sent to the API. Defaults to the model's reported ID. */
   requestModelId?: string;
-  headers?: () => Record<string, string | undefined>;
+  headers?: Resolvable<Record<string, string | undefined>>;
   url: (options: { modelId: string; path: string }) => string;
   fetch?: FetchFunction;
 };
@@ -122,12 +122,15 @@ export class OpenAIChatLanguageModel implements LanguageModelV4 {
         schema: openaiLanguageModelChatOptions,
       })) ?? {};
 
-    const modelCapabilities = getOpenAILanguageModelCapabilities(this.modelId);
+    const {
+      capabilities: { language: modelCapabilities },
+      requestConfig: { language: modelRequestConfig },
+    } = getOpenAILanguageModelEntry(this.modelId);
 
     // Some models reject function tools unless reasoning is disabled, even
     // when no reasoning effort is sent, so reasoning is set to 'none'.
     const requiresNoReasoningEffort =
-      !modelCapabilities.supportsChatFunctionToolsWithReasoning &&
+      !modelCapabilities.endpoints.chat.functionToolsWithReasoning &&
       openaiOptions.reasoningEffort == null &&
       (tools?.some(tool => tool.type === 'function') ?? false);
 
@@ -150,14 +153,15 @@ export class OpenAIChatLanguageModel implements LanguageModelV4 {
           reasoning,
           // Only the Responses API supports `max`.
           supportedReasoningEfforts:
-            modelCapabilities.supportedReasoningEfforts?.filter(
+            modelCapabilities.reasoning.efforts?.filter(
               effort => effort !== 'max',
             ),
           warnings,
         });
 
     const isReasoningModel =
-      openaiOptions.forceReasoning ?? modelCapabilities.isReasoningModel;
+      openaiOptions.forceReasoning ??
+      modelCapabilities.reasoning.support === true;
 
     if (topK != null) {
       warnings.push({ type: 'unsupported', feature: 'topK' });
@@ -181,7 +185,7 @@ export class OpenAIChatLanguageModel implements LanguageModelV4 {
           openaiOptions.systemMessageMode ??
           (isReasoningModel
             ? 'developer'
-            : modelCapabilities.systemMessageMode),
+            : modelRequestConfig.systemMessageMode),
       },
     );
 
@@ -261,7 +265,7 @@ export class OpenAIChatLanguageModel implements LanguageModelV4 {
     };
 
     if (
-      modelCapabilities.supportsConfigurationUpdate &&
+      !modelCapabilities.promptCache.retention &&
       baseArgs.prompt_cache_retention != null
     ) {
       baseArgs.prompt_cache_retention = undefined;
@@ -280,7 +284,7 @@ export class OpenAIChatLanguageModel implements LanguageModelV4 {
       //  https://platform.openai.com/docs/guides/latest-model#gpt-5-1-parameter-compatibility
       if (
         resolvedReasoningEffort !== 'none' ||
-        !modelCapabilities.supportsNonReasoningParameters
+        modelCapabilities.reasoning.sampling !== 'reasoning-effort-none'
       ) {
         if (baseArgs.temperature != null) {
           baseArgs.temperature = undefined;
@@ -346,10 +350,7 @@ export class OpenAIChatLanguageModel implements LanguageModelV4 {
         }
         baseArgs.max_tokens = undefined;
       }
-    } else if (
-      this.modelId.startsWith('gpt-4o-search-preview') ||
-      this.modelId.startsWith('gpt-4o-mini-search-preview')
-    ) {
+    } else if (!modelCapabilities.endpoints.chat.temperatureWithoutReasoning) {
       if (baseArgs.temperature != null) {
         baseArgs.temperature = undefined;
         warnings.push({
@@ -364,7 +365,7 @@ export class OpenAIChatLanguageModel implements LanguageModelV4 {
     // Validate flex processing support
     if (
       openaiOptions.serviceTier === 'flex' &&
-      !modelCapabilities.supportsFlexProcessing
+      !modelCapabilities.serviceTiers.flex
     ) {
       warnings.push({
         type: 'unsupported',
@@ -379,7 +380,7 @@ export class OpenAIChatLanguageModel implements LanguageModelV4 {
     if (
       (openaiOptions.serviceTier === 'priority' ||
         openaiOptions.serviceTier === 'fast') &&
-      !modelCapabilities.supportsPriorityProcessing
+      !modelCapabilities.serviceTiers.priority
     ) {
       warnings.push({
         type: 'unsupported',
@@ -423,7 +424,10 @@ export class OpenAIChatLanguageModel implements LanguageModelV4 {
         path: '/chat/completions',
         modelId: this.config.requestModelId ?? this.modelId,
       }),
-      headers: combineHeaders(this.config.headers?.(), options.headers),
+      headers: combineHeaders(
+        await resolve(this.config.headers),
+        options.headers,
+      ),
       body,
       failedResponseHandler: openaiFailedResponseHandler,
       successfulResponseHandler: createJsonResponseHandler(
@@ -526,7 +530,10 @@ export class OpenAIChatLanguageModel implements LanguageModelV4 {
 
     const { responseHeaders, value: response } = await postJsonToApi({
       url,
-      headers: combineHeaders(this.config.headers?.(), options.headers),
+      headers: combineHeaders(
+        await resolve(this.config.headers),
+        options.headers,
+      ),
       body,
       failedResponseHandler: openaiFailedResponseHandler,
       successfulResponseHandler: createEventSourceResponseHandler(

package/src/completion/openai-completion-language-model.ts

@@ -9,6 +9,8 @@ import type {
   SharedV4Warning,
 } from '@ai-sdk/provider';
 import {
+  type Resolvable,
+  resolve,
   combineHeaders,
   createEventSourceResponseHandler,
   createJsonResponseHandler,
@@ -45,7 +47,7 @@ type OpenAICompletionConfig = {
   provider: string;
   /** Model ID sent to the API. Defaults to the model's reported ID. */
   requestModelId?: string;
-  headers?: () => Record<string, string | undefined>;
+  headers?: Resolvable<Record<string, string | undefined>>;
   url: (options: { modelId: string; path: string }) => string;
   fetch?: FetchFunction;
 };
@@ -196,7 +198,10 @@ export class OpenAICompletionLanguageModel implements LanguageModelV4 {
         path: '/completions',
         modelId: this.config.requestModelId ?? this.modelId,
       }),
-      headers: combineHeaders(this.config.headers?.(), options.headers),
+      headers: combineHeaders(
+        await resolve(this.config.headers),
+        options.headers,
+      ),
       body: args,
       failedResponseHandler: openaiFailedResponseHandler,
       successfulResponseHandler: createJsonResponseHandler(
@@ -253,7 +258,10 @@ export class OpenAICompletionLanguageModel implements LanguageModelV4 {
 
     const { responseHeaders, value: response } = await postJsonToApi({
       url,
-      headers: combineHeaders(this.config.headers?.(), options.headers),
+      headers: combineHeaders(
+        await resolve(this.config.headers),
+        options.headers,
+      ),
       body,
       failedResponseHandler: openaiFailedResponseHandler,
       successfulResponseHandler: createEventSourceResponseHandler(

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

@@ -3,6 +3,7 @@ import {
   type EmbeddingModelV4,
 } from '@ai-sdk/provider';
 import {
+  resolve,
   combineHeaders,
   createJsonResponseHandler,
   EXPERIMENTAL_EMBEDDING_MODEL_MAX_INPUT_BYTES_PER_CALL,
@@ -87,7 +88,7 @@ export class OpenAIEmbeddingModel implements EmbeddingModelV4 {
         path: '/embeddings',
         modelId: this.modelId,
       }),
-      headers: combineHeaders(this.config.headers?.(), headers),
+      headers: combineHeaders(await resolve(this.config.headers), headers),
       body: {
         model: this.modelId,
         input: values,

package/src/files/openai-files.ts

@@ -12,6 +12,8 @@ import {
   type SharedV4ProviderReference,
 } from '@ai-sdk/provider';
 import {
+  type Resolvable,
+  resolve,
   combineHeaders,
   convertInlineFileDataToUint8Array,
   createBinaryStreamResponseHandler,
@@ -39,7 +41,7 @@ import {
 interface OpenAIFilesConfig {
   provider: string;
   baseURL: string;
-  headers: () => Record<string, string | undefined>;
+  headers: Resolvable<Record<string, string | undefined>>;
   fetch?: FetchFunction;
 }
 
@@ -65,10 +67,10 @@ export class OpenAIFiles implements FilesV4 {
     return fileId;
   }
 
-  private getHeaders(
+  private async getHeaders(
     headers: Record<string, string | undefined> | undefined,
-  ): Record<string, string | undefined> {
-    return combineHeaders(this.config.headers(), headers);
+  ): Promise<Record<string, string | undefined>> {
+    return combineHeaders(await resolve(this.config.headers), headers);
   }
 
   async uploadFile({
@@ -95,7 +97,7 @@ export class OpenAIFiles implements FilesV4 {
     }
 
     const purpose = openaiOptions?.purpose ?? 'assistants';
-    const requestHeaders = this.getHeaders(headers);
+    const requestHeaders = await this.getHeaders(headers);
     const url = `${this.config.baseURL}/files`;
 
     let response: OpenAIFilesResponse;
@@ -200,7 +202,7 @@ export class OpenAIFiles implements FilesV4 {
 
     const { value: response } = await getFromApi({
       url: `${this.config.baseURL}/files/${encodePathSegment(fileId)}`,
-      headers: this.getHeaders(headers),
+      headers: await this.getHeaders(headers),
       failedResponseHandler: openaiFailedResponseHandler,
       successfulResponseHandler: createJsonResponseHandler(
         openaiFilesResponseSchema,
@@ -236,7 +238,7 @@ export class OpenAIFiles implements FilesV4 {
 
     const { value: content, responseHeaders } = await getFromApi({
       url: `${this.config.baseURL}/files/${encodePathSegment(fileId)}/content`,
-      headers: this.getHeaders(headers),
+      headers: await this.getHeaders(headers),
       failedResponseHandler: openaiFailedResponseHandler,
       successfulResponseHandler: createBinaryStreamResponseHandler(),
       abortSignal,
@@ -263,7 +265,7 @@ export class OpenAIFiles implements FilesV4 {
 
     const { value: response } = await deleteFromApi({
       url: `${this.config.baseURL}/files/${encodePathSegment(fileId)}`,
-      headers: this.getHeaders(headers),
+      headers: await this.getHeaders(headers),
       failedResponseHandler: openaiFailedResponseHandler,
       successfulResponseHandler: createJsonResponseHandler(
         openaiFileDeleteResponseSchema,

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

@@ -4,6 +4,10 @@ import {
   type InferSchema,
 } from '@ai-sdk/provider-utils';
 import { z } from 'zod/v4';
+import {
+  getOpenAIImageModelEntry,
+  openaiImageModelMaxImagesPerCall,
+} from '../openai-model-catalog';
 
 export type OpenAIImageModelId =
   | 'dall-e-3'
@@ -19,33 +23,19 @@ export type OpenAIImageModelId =
   | 'chatgpt-image-latest'
   | (string & {});
 
-// https://platform.openai.com/docs/guides/images
-export const modelMaxImagesPerCall: Record<OpenAIImageModelId, number> = {
-  'dall-e-3': 1,
-  'dall-e-2': 10,
-  'gpt-image-1': 10,
-  'gpt-image-1-mini': 10,
-  'gpt-image-1.5': 10,
-  'gpt-image-2': 10,
-  'gpt-image-2.5-flare': 10,
-  'gpt-image-2.5-flare-2026-09-08': 10,
-  'gpt-image-2.5-sunburst': 10,
-  'gpt-image-2.5-sunburst-2026-09-08': 10,
-  'chatgpt-image-latest': 10,
-};
-
-const defaultResponseFormatPrefixes = ['chatgpt-image-', 'gpt-image-'];
+export const modelMaxImagesPerCall: Record<OpenAIImageModelId, number> =
+  openaiImageModelMaxImagesPerCall;
 
 export function hasDefaultResponseFormat(modelId: string): boolean {
-  return defaultResponseFormatPrefixes.some(prefix =>
-    modelId.startsWith(prefix),
+  return (
+    getOpenAIImageModelEntry(modelId).requestConfig.image.responseFormat ===
+    'provider-default'
   );
 }
 
 export function getMaxImagesPerCall(modelId: OpenAIImageModelId): number {
   return (
-    modelMaxImagesPerCall[modelId] ??
-    (modelId.startsWith('gpt-image-') ? 10 : 1)
+    getOpenAIImageModelEntry(modelId).capabilities.image.maxImagesPerCall ?? 1
   );
 }
 

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,