@ai-sdk/openai 4.0.104 → 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)`.
@@ -3695,8 +3781,10 @@ include probability distributions. Boolean questions use the API's predicate
 primitive and return P(true). Apply thresholds in application code, for example
 `answers.requestsRefund.probability >= 0.5`.
 
-Structured state, instructions, and criterion descriptions are serialized as JSON
-text. Score levels receive zero-based index labels. Non-null Boolean criteria are
+JSON state parts that hold an object or an array of objects are sent as native
+`input_json` parts when they fit its limits (32 container levels, 10,000 values, and
+256 KiB of compact UTF-8 JSON). Larger JSON state, other JSON state values, structured
+instructions, and criterion descriptions are serialized as JSON text. Score levels receive zero-based index labels. Non-null Boolean criteria are
 appended to predicate instructions under `Criteria for true:` and `Criteria for false:`.
 String criteria are passed through; structured criteria are serialized as JSON text.
 
@@ -3718,11 +3806,15 @@ state: [
 
 The factory respects `createOpenAI` settings, including custom fetch and base URL.
 Set `providerOptions.openai.safetyIdentifier` to an opaque end-user identifier for
-safety monitoring (up to 128 characters). For example:
+safety monitoring (up to 128 characters). Set `providerOptions.openai.promptCacheKey`
+to partition prompt cache reuse across requests that share `state`. For example:
 
 ```ts
 providerOptions: {
-  openai: { safetyIdentifier: 'user-123' } satisfies OpenAIDecisionModelOptions,
+  openai: {
+    safetyIdentifier: 'user-123',
+    promptCacheKey: 'tenant-42',
+  } satisfies OpenAIDecisionModelOptions,
 }
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/openai",
-  "version": "4.0.104",
+  "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.70"
+    "@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,11 +28,12 @@ import {
   type ParseResult,
 } from '@ai-sdk/provider-utils';
 import { openaiFailedResponseHandler } from '../openai-error';
-import { getOpenAILanguageModelCapabilities } 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,
@@ -54,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;
 };
@@ -119,30 +122,46 @@ export class OpenAIChatLanguageModel implements LanguageModelV4 {
         schema: openaiLanguageModelChatOptions,
       })) ?? {};
 
-    const modelCapabilities = getOpenAILanguageModelCapabilities(this.modelId);
+    const {
+      capabilities: { language: modelCapabilities },
+      requestConfig: { language: modelRequestConfig },
+    } = getOpenAILanguageModelEntry(this.modelId);
 
-    // AI SDK reasoning values map directly to the OpenAI reasoning values.
-    let resolvedReasoningEffort =
-      openaiOptions.reasoningEffort ??
-      (isCustomReasoning(reasoning) ? reasoning : undefined);
+    // 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.endpoints.chat.functionToolsWithReasoning &&
+      openaiOptions.reasoningEffort == null &&
+      (tools?.some(tool => tool.type === 'function') ?? false);
 
     if (
-      resolvedReasoningEffort != null &&
-      modelCapabilities.supportedReasoningEfforts != null &&
-      !modelCapabilities.supportedReasoningEfforts.includes(
-        resolvedReasoningEffort,
-      )
+      requiresNoReasoningEffort &&
+      isCustomReasoning(reasoning) &&
+      reasoning !== 'none'
     ) {
       warnings.push({
-        type: 'unsupported',
-        feature: 'reasoningEffort',
-        details: `${this.modelId} only supports the following reasoning efforts: ${modelCapabilities.supportedReasoningEfforts.join(', ')}`,
+        type: 'compatibility',
+        feature: 'reasoning',
+        details: `${this.modelId} does not support function tools with reasoning in the Chat Completions API. reasoning effort set to "none". Use the Responses API to combine reasoning with function tools.`,
       });
-      resolvedReasoningEffort = undefined;
     }
 
+    const resolvedReasoningEffort = requiresNoReasoningEffort
+      ? 'none'
+      : resolveOpenAIReasoningEffort({
+          providerReasoningEffort: openaiOptions.reasoningEffort,
+          reasoning,
+          // Only the Responses API supports `max`.
+          supportedReasoningEfforts:
+            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' });
@@ -166,7 +185,7 @@ export class OpenAIChatLanguageModel implements LanguageModelV4 {
           openaiOptions.systemMessageMode ??
           (isReasoningModel
             ? 'developer'
-            : modelCapabilities.systemMessageMode),
+            : modelRequestConfig.systemMessageMode),
       },
     );
 
@@ -246,7 +265,7 @@ export class OpenAIChatLanguageModel implements LanguageModelV4 {
     };
 
     if (
-      modelCapabilities.supportedReasoningEfforts != null &&
+      !modelCapabilities.promptCache.retention &&
       baseArgs.prompt_cache_retention != null
     ) {
       baseArgs.prompt_cache_retention = undefined;
@@ -265,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;
@@ -331,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({
@@ -349,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',
@@ -364,7 +380,7 @@ export class OpenAIChatLanguageModel implements LanguageModelV4 {
     if (
       (openaiOptions.serviceTier === 'priority' ||
         openaiOptions.serviceTier === 'fast') &&
-      !modelCapabilities.supportsPriorityProcessing
+      !modelCapabilities.serviceTiers.priority
     ) {
       warnings.push({
         type: 'unsupported',
@@ -408,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(
@@ -511,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
   );
 }