@ai-sdk/openai 3.0.131 → 3.0.133

package/docs/03-openai.mdx

@@ -206,9 +206,9 @@ The following provider options are available:
   Reasoning effort for reasoning models. Defaults to `medium`. If you use `providerOptions` to set the `reasoningEffort` option, this model setting will be ignored.
 
 <Note>
-  Supported reasoning efforts vary by model. GPT-5.6, GPT-6 Sol, and GPT-6 Luna
-  support `'none'`, `'low'`, `'medium'`, `'high'`, `'xhigh'`, and `'max'`. GPT-6
-  Astra and GPT-6.1 Sol do not support `'none'`.
+  Supported reasoning efforts vary by model. GPT-5.6, GPT-6 Sol, GPT-6 Luna, and
+  GPT-6.1 Terra support `'none'`, `'low'`, `'medium'`, `'high'`, `'xhigh'`, and
+  `'max'`. GPT-6 Astra and GPT-6.1 Sol do not support `'none'`.
 </Note>
 
 <Note>
@@ -2562,6 +2562,7 @@ The following optional provider options are available for OpenAI completion mode
 | --------------------- | ------------------- | ------------------- | ------------------- | ------------------- |
 | `gpt-6-astra`         | <Check size={18} /> | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | `gpt-6.1-sol`         | <Check size={18} /> | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> |
+| `gpt-6.1-terra`        | <Check size={18} /> | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | `gpt-6-luna`          | <Check size={18} /> | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | `gpt-6-sol`           | <Check size={18} /> | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> |
 | `gpt-5.6`             | <Check size={18} /> | <Cross size={18} /> | <Check size={18} /> | <Check size={18} /> |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/openai",
-  "version": "3.0.131",
+  "version": "3.0.133",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",

package/src/chat/openai-chat-options.ts

@@ -72,6 +72,7 @@ export type OpenAIChatModelId =
   | 'gpt-5.6-terra'
   | 'gpt-6-astra'
   | 'gpt-6.1-sol'
+  | 'gpt-6.1-terra'
   | 'gpt-6-luna'
   | 'gpt-6-sol'
   | (string & {});

package/src/internal/index.ts

@@ -16,5 +16,6 @@ export * from '../tool/apply-patch';
 export * from '../tool/code-interpreter';
 export * from '../tool/file-search';
 export * from '../tool/image-generation';
+export * from '../tool/tool-search';
 export * from '../tool/web-search';
 export * from '../tool/web-search-preview';

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

@@ -24,7 +24,10 @@ export function getOpenAILanguageModelCapabilities(
   const isGptNanoModel = gptVersion?.variant?.startsWith('nano') ?? false;
   const isGpt6OrLaterModel = gptVersion != null && gptVersion.major >= 6;
 
-  const isGpt6SolOrLuna = modelId === 'gpt-6-sol' || modelId === 'gpt-6-luna';
+  const isGpt6OrLaterModelWithNoneEffort =
+    modelId === 'gpt-6-sol' ||
+    modelId === 'gpt-6-luna' ||
+    modelId === 'gpt-6.1-terra';
 
   const supportsFlexProcessing =
     (oSeriesVersion != null && oSeriesVersion >= 3) ||
@@ -59,7 +62,7 @@ export function getOpenAILanguageModelCapabilities(
     supportsPriorityProcessing,
     supportsConfigurationUpdate: isGpt6OrLaterModel,
     supportsAsyncToolCalling: isGpt6OrLaterModel,
-    supportedReasoningEfforts: isGpt6SolOrLuna
+    supportedReasoningEfforts: isGpt6OrLaterModelWithNoneEffort
       ? ['none', 'low', 'medium', 'high', 'xhigh', 'max']
       : isGpt6OrLaterModel
         ? ['low', 'medium', 'high', 'xhigh', 'max']

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

@@ -271,6 +271,7 @@ export class OpenAIResponsesLanguageModel implements LanguageModelV3 {
       toolNameMapping,
       customProviderToolNames,
       supportsAsyncToolCalling: modelCapabilities.supportsAsyncToolCalling,
+      providerOptionsName,
     });
 
     const configurationUpdateUnsupportedReason =

package/src/responses/openai-responses-options.ts

@@ -59,6 +59,7 @@ export const openaiResponsesReasoningModelIds = [
   'gpt-5.6-terra',
   'gpt-6-astra',
   'gpt-6.1-sol',
+  'gpt-6.1-terra',
   'gpt-6-luna',
   'gpt-6-sol',
 ] as const;
@@ -135,6 +136,7 @@ export type OpenAIResponsesModelId =
   | 'gpt-5.6-terra'
   | 'gpt-6-astra'
   | 'gpt-6.1-sol'
+  | 'gpt-6.1-terra'
   | 'gpt-6-luna'
   | 'gpt-6-sol'
   | 'gpt-5-2025-08-07'

package/src/responses/openai-responses-prepare-tools.ts

@@ -44,6 +44,7 @@ export async function prepareResponsesTools({
   toolNameMapping,
   customProviderToolNames,
   supportsAsyncToolCalling = true,
+  providerOptionsName = 'openai',
 }: {
   tools: LanguageModelV3CallOptions['tools'];
   toolChoice: LanguageModelV3CallOptions['toolChoice'] | undefined;
@@ -54,6 +55,7 @@ export async function prepareResponsesTools({
   toolNameMapping?: ToolNameMapping;
   customProviderToolNames?: Set<string>;
   supportsAsyncToolCalling?: boolean;
+  providerOptionsName?: string;
 }): Promise<{
   tools?: Array<OpenAIResponsesTool>;
   toolChoice?:
@@ -125,9 +127,8 @@ export async function prepareResponsesTools({
   for (const tool of tools) {
     switch (tool.type) {
       case 'function': {
-        const openaiOptions = tool.providerOptions?.openai as
-          | OpenAIToolOptions
-          | undefined;
+        const openaiOptions = (tool.providerOptions?.[providerOptionsName] ??
+          tool.providerOptions?.openai) as OpenAIToolOptions | undefined;
         const openaiFunctionTool = prepareFunctionTool({
           tool,
           options: openaiOptions,

package/src/transcription/openai-transcription-api.ts

@@ -32,6 +32,14 @@ export const openaiTranscriptionResponseSchema = lazySchema(() =>
           }),
         )
         .nullish(),
+      // Lenient: an unexpected usage shape must not fail the transcription.
+      usage: z
+        .object({
+          type: z.string().nullish(),
+          seconds: z.number().nullish(),
+        })
+        .nullish()
+        .catch(undefined),
     }),
   ),
 );

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

@@ -145,12 +145,16 @@ export class OpenAITranscriptionModel implements TranscriptionModelV3 {
         prompt: openAIOptions.prompt,
         // https://platform.openai.com/docs/api-reference/audio/createTranscription#audio_createtranscription-response_format
         // prefer verbose_json to get segments for models that support it
-        response_format: [
-          'gpt-4o-transcribe',
-          'gpt-4o-mini-transcribe',
-        ].includes(this.modelId)
-          ? 'json'
-          : 'verbose_json',
+        // gpt-4o(-mini)-transcribe (incl. snapshots) and gpt-transcribe reject verbose_json:
+        response_format:
+          ['gpt-4o-transcribe', 'gpt-4o-mini-transcribe'].includes(
+            this.modelId,
+          ) ||
+          this.modelId.startsWith('gpt-4o-mini-transcribe-') ||
+          this.modelId === 'gpt-transcribe' ||
+          this.modelId.startsWith('gpt-transcribe-')
+            ? 'json'
+            : 'verbose_json',
         temperature: openAIOptions.temperature,
         timestamp_granularities: openAIOptions.timestampGranularities,
       };
@@ -219,7 +223,12 @@ export class OpenAITranscriptionModel implements TranscriptionModelV3 {
         })) ??
         [],
       language,
-      durationInSeconds: response.duration ?? undefined,
+      // Duration-billed json responses report the duration only in `usage`:
+      durationInSeconds:
+        response.duration ??
+        (response.usage?.type === 'duration'
+          ? (response.usage.seconds ?? undefined)
+          : undefined),
       warnings,
       response: {
         timestamp: currentDate,