@ai-sdk/openai 4.0.106 → 4.0.107

package/docs/03-openai.mdx

@@ -3543,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"
@@ -3592,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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/openai",
-  "version": "4.0.106",
+  "version": "4.0.107",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,
@@ -36,7 +36,7 @@
   },
   "dependencies": {
     "@ai-sdk/provider": "4.0.35",
-    "@ai-sdk/provider-utils": "5.0.72"
+    "@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/responses/convert-to-openai-responses-input.ts

@@ -8,6 +8,8 @@ import {
   type SharedV4Warning,
 } from '@ai-sdk/provider';
 import {
+  secureJsonParse,
+  stringifyWithBigIntAndCycles,
   lazySchema,
   zodSchema,
   type InferSchema,
@@ -62,7 +64,15 @@ import {
 } from './expand-parallel-tool-call';
 
 function serializeToolCallArguments(input: unknown): string {
-  return JSON.stringify(input === undefined ? {} : input);
+  if (typeof input === 'string') {
+    try {
+      secureJsonParse(input);
+      return input;
+    } catch {
+      return stringifyWithBigIntAndCycles(input);
+    }
+  }
+  return stringifyWithBigIntAndCycles(input === undefined ? {} : input);
 }
 
 function mapToolCaller(
@@ -172,19 +182,23 @@ async function convertFunctionToolResultOutput({
   switch (output.type) {
     case 'text':
       return convertScalarOutput(
-        hasOutputSchema ? JSON.stringify(output.value) : output.value,
+        hasOutputSchema
+          ? stringifyWithBigIntAndCycles(output.value)
+          : output.value,
       );
     case 'error-text':
     case 'error-json':
-      return convertScalarOutput(JSON.stringify({ error: output.value }));
+      return convertScalarOutput(
+        stringifyWithBigIntAndCycles({ error: output.value }),
+      );
     case 'execution-denied': {
       const reason = output.reason ?? 'Tool call execution denied.';
       return convertScalarOutput(
-        hasOutputSchema ? JSON.stringify(reason) : reason,
+        hasOutputSchema ? stringifyWithBigIntAndCycles(reason) : reason,
       );
     }
     case 'json':
-      return convertScalarOutput(JSON.stringify(output.value));
+      return convertScalarOutput(stringifyWithBigIntAndCycles(output.value));
     case 'content':
       return output.value
         .map(item => {
@@ -1074,7 +1088,7 @@ export async function convertToOpenAIResponsesInput({
                   input:
                     typeof part.input === 'string'
                       ? part.input
-                      : JSON.stringify(part.input),
+                      : stringifyWithBigIntAndCycles(part.input),
                   ...(isAsync != null && { async: isAsync }),
                   id,
                 });
@@ -1311,7 +1325,7 @@ export async function convertToOpenAIResponsesInput({
                   } else if (reasoningMessage !== undefined) {
                     warnings.push({
                       type: 'other',
-                      message: `Cannot append empty reasoning part to existing reasoning sequence. Skipping reasoning part: ${JSON.stringify(part)}.`,
+                      message: `Cannot append empty reasoning part to existing reasoning sequence. Skipping reasoning part: ${stringifyWithBigIntAndCycles(part)}.`,
                     });
                   }
 
@@ -1362,7 +1376,7 @@ export async function convertToOpenAIResponsesInput({
                 } else {
                   warnings.push({
                     type: 'other',
-                    message: `Non-OpenAI reasoning parts are not supported. Skipping reasoning part: ${JSON.stringify(part)}.`,
+                    message: `Non-OpenAI reasoning parts are not supported. Skipping reasoning part: ${stringifyWithBigIntAndCycles(part)}.`,
                   });
                 }
               }
@@ -1480,7 +1494,9 @@ export async function convertToOpenAIResponsesInput({
                 }),
               );
               const serializedToolOutputs = toolOutputs.map(({ output }) =>
-                typeof output === 'string' ? output : JSON.stringify(output),
+                typeof output === 'string'
+                  ? output
+                  : stringifyWithBigIntAndCycles(output),
               );
               const hasPromptCacheBreakpoint = toolOutputs.some(
                 ({ promptCacheBreakpoint }) => promptCacheBreakpoint != null,
@@ -1663,7 +1679,7 @@ export async function convertToOpenAIResponsesInput({
               case 'error-text':
               case 'error-json':
                 outputValue = convertScalarOutput(
-                  JSON.stringify({ error: output.value }),
+                  stringifyWithBigIntAndCycles({ error: output.value }),
                 );
                 break;
               case 'execution-denied':
@@ -1672,7 +1688,9 @@ export async function convertToOpenAIResponsesInput({
                 );
                 break;
               case 'json':
-                outputValue = convertScalarOutput(JSON.stringify(output.value));
+                outputValue = convertScalarOutput(
+                  stringifyWithBigIntAndCycles(output.value),
+                );
                 break;
               case 'content':
                 outputValue = output.value

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

@@ -32,6 +32,18 @@ export const openAITranscriptionModelOptions = lazySchema(() =>
        */
       language: z.string().optional(),
 
+      /**
+       * Expected languages for REST transcription, e.g. with gpt-transcribe.
+       * Use this instead of language. The API validates model support.
+       */
+      languages: z.array(z.string()).optional(),
+
+      /**
+       * Vocabulary hints for REST transcription, e.g. names or technical terms.
+       * The API validates model support.
+       */
+      keywords: z.array(z.string()).optional(),
+
       /**
        * An optional text to guide the model's style or continue a previous audio segment.
        */

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

@@ -207,6 +207,8 @@ export class OpenAITranscriptionModel implements TranscriptionModelV4 {
       response_format: responseFormat,
       include: openAIOptions?.include,
       language: openAIOptions?.language,
+      languages: openAIOptions?.languages,
+      keywords: openAIOptions?.keywords,
       prompt: openAIOptions?.prompt,
       temperature: openAIOptions?.temperature,
       timestamp_granularities: timestampGranularities,
@@ -384,6 +386,8 @@ export class OpenAITranscriptionModel implements TranscriptionModelV4 {
     const rawOpenAIOptions = options.providerOptions?.openai ?? {};
     for (const option of [
       'include',
+      'languages',
+      'keywords',
       'prompt',
       'temperature',
       'timestampGranularities',