@ai-sdk/openai 4.0.105 → 4.0.107

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
@@ -3469,6 +3543,32 @@ const result = await transcribe({
 });
 ```
 
+For `gpt-transcribe`, use `languages` for expected languages and `keywords` for
+names, acronyms, and domain vocabulary. These hints are sent as repeated
+`languages[]` and `keywords[]` multipart fields:
+
+```ts
+import { transcribe } from 'ai';
+import { openai, type OpenAITranscriptionModelOptions } from '@ai-sdk/openai';
+
+const result = await transcribe({
+  model: openai.transcription('gpt-transcribe'),
+  audio: new Uint8Array([1, 2, 3, 4]),
+  providerOptions: {
+    openai: {
+      languages: ['en', 'fr'],
+      keywords: ['premium plan', 'AC-42'],
+      prompt: 'A customer support call.',
+    } satisfies OpenAITranscriptionModelOptions,
+  },
+});
+```
+
+Use `languages` instead of `language` with `gpt-transcribe`; do not send both.
+The API validates model support and language codes. These two options currently
+apply to REST transcription; the provider reports unsupported-option warnings
+if they are supplied to `experimental_streamTranscribe`.
+
 To get word-level timestamps, specify the granularity:
 
 ```ts highlight="8-9"
@@ -3518,6 +3618,16 @@ The following provider options are available:
   For streaming with `gpt-transcribe` and `gpt-live-transcribe`, it is sent as a single-entry `languages` list.
   Optional.
 
+- **languages** _string[]_
+  Expected languages for REST transcription, such as `['en', 'fr']` for `gpt-transcribe`.
+  Use this instead of `language`; do not send both. The API validates model support.
+  Optional.
+
+- **keywords** _string[]_
+  Vocabulary hints for REST transcription, such as product names, acronyms, or technical terms.
+  Supported by `gpt-transcribe`; the API validates support for other models.
+  Optional.
+
 - **prompt** _string_
   An optional text to guide the model's style or continue a previous audio segment. The prompt should match the audio language.
   Optional.
@@ -3547,6 +3657,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 +3669,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 +3711,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 +3774,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.107",
   "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.73"
   },
   "devDependencies": {
     "@ai-sdk/test-server": "2.0.4",

package/src/chat/convert-to-openai-chat-messages.ts

@@ -6,6 +6,8 @@ import {
 } from '@ai-sdk/provider';
 import type { OpenAIChatPrompt } from './openai-chat-prompt';
 import {
+  secureJsonParse,
+  stringifyWithBigIntAndCycles,
   convertToBase64,
   getTopLevelMediaType,
   resolveFullMediaType,
@@ -13,7 +15,22 @@ import {
 } from '@ai-sdk/provider-utils';
 
 function serializeToolCallArguments(input: unknown): string {
-  return JSON.stringify(
+  if (typeof input === 'string') {
+    try {
+      const parsed = secureJsonParse(input);
+      if (
+        typeof parsed !== 'object' ||
+        parsed === null ||
+        Array.isArray(parsed)
+      ) {
+        return '{}';
+      }
+      return input;
+    } catch {
+      return '{}';
+    }
+  }
+  return stringifyWithBigIntAndCycles(
     typeof input === 'object' && input !== null && !Array.isArray(input)
       ? input
       : {},
@@ -326,14 +343,16 @@ export function convertToOpenAIChatMessages({
               break;
             case 'error-text':
             case 'error-json':
-              contentValue = JSON.stringify({ error: output.value });
+              contentValue = stringifyWithBigIntAndCycles({
+                error: output.value,
+              });
               break;
             case 'execution-denied':
               contentValue = output.reason ?? 'Tool call execution denied.';
               break;
             case 'content':
             case 'json':
-              contentValue = JSON.stringify(output.value);
+              contentValue = stringifyWithBigIntAndCycles(output.value);
               break;
           }
 

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
   );
 }