@ai-sdk/openai 4.0.32 → 4.0.34

package/docs/03-openai.mdx

@@ -1858,6 +1858,44 @@ The metadata includes the following fields:
 - **itemId** _string_ — The ID of the compaction item in the Responses API
 - **encryptedContent** _string_ (optional) — The encrypted compaction state. This is automatically sent back to the API when the message is included in subsequent requests.
 
+### Text Batches
+
+<Note type="warning">
+  Text batch APIs are experimental and may change in future releases.
+</Note>
+
+The OpenAI provider supports the [Batch API](https://developers.openai.com/api/docs/guides/batch) for text generation.
+
+```ts
+import { openai } from '@ai-sdk/openai';
+import {
+  experimental_startTextBatch as startTextBatch,
+  experimental_getBatchResults as getBatchResults,
+  experimental_getBatchStatus as getBatchStatus,
+} from 'ai';
+
+const model = openai('gpt-4.1-nano');
+
+const batch = await startTextBatch({
+  model,
+  requests: [
+    { id: 'france', prompt: 'What is the capital of France?' },
+    { id: 'germany', prompt: 'What is the capital of Germany?' },
+  ],
+});
+
+// Persist `batch` and check its status later, or poll for status updates.
+const { status } = await getBatchStatus({ model, batch });
+
+if (status !== 'pending') {
+  for await (const result of getBatchResults({ model, batch })) {
+    console.log(result);
+  }
+}
+```
+
+Starting a batch returns a serializable reference that can be persisted and used to retrieve the batch results later, or poll for status updates.
+
 ### Chat Models
 
 You can create models that call the [OpenAI chat API](https://platform.openai.com/docs/api-reference/chat) using the `.chat()` factory method.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/openai",
-  "version": "4.0.32",
+  "version": "4.0.34",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,

package/src/index.ts

@@ -22,11 +22,19 @@ export type { OpenAILanguageModelCompletionOptions } from './completion/openai-c
 export type { OpenAIEmbeddingModelOptions } from './embedding/openai-embedding-model-options';
 export type { OpenAISpeechModelOptions } from './speech/openai-speech-model-options';
 export type { OpenAITranscriptionModelOptions } from './transcription/openai-transcription-model-options';
-export { OpenAITranslationModel as Experimental_OpenAITranslationModel } from './translation/openai-translation-model';
+export {
+  OpenAISpeechTranslationModel as Experimental_OpenAISpeechTranslationModel,
+  /** @deprecated Use `Experimental_OpenAISpeechTranslationModel` instead. */
+  OpenAISpeechTranslationModel as Experimental_OpenAITranslationModel,
+} from './speech-translation/openai-speech-translation-model';
 export type {
-  OpenAITranslationModelId as Experimental_OpenAITranslationModelId,
-  OpenAITranslationModelOptions as Experimental_OpenAITranslationModelOptions,
-} from './translation/openai-translation-model-options';
+  OpenAISpeechTranslationModelId as Experimental_OpenAISpeechTranslationModelId,
+  /** @deprecated Use `Experimental_OpenAISpeechTranslationModelId` instead. */
+  OpenAISpeechTranslationModelId as Experimental_OpenAITranslationModelId,
+  OpenAISpeechTranslationModelOptions as Experimental_OpenAISpeechTranslationModelOptions,
+  /** @deprecated Use `Experimental_OpenAISpeechTranslationModelOptions` instead. */
+  OpenAISpeechTranslationModelOptions as Experimental_OpenAITranslationModelOptions,
+} from './speech-translation/openai-speech-translation-model-options';
 export type { OpenAIFilesOptions } from './files/openai-files-options';
 export type {
   OpenAIComputerAction,

package/src/openai-provider.ts

@@ -1,5 +1,6 @@
 import type {
   EmbeddingModelV4,
+  Experimental_BatchLanguageModelV4 as BatchLanguageModelV4,
   FilesV4,
   ImageModelV4,
   LanguageModelV4,
@@ -30,25 +31,25 @@ import type { OpenAIEmbeddingModelId } from './embedding/openai-embedding-model-
 import { OpenAIImageModel } from './image/openai-image-model';
 import type { OpenAIImageModelId } from './image/openai-image-model-options';
 import { openaiTools } from './openai-tools';
+import { OpenAIResponsesBatchLanguageModel } from './openai-responses-batch';
 import { OpenAIRealtimeModel } from './realtime/openai-realtime-model';
-import { OpenAIResponsesLanguageModel } from './responses/openai-responses-language-model';
 import type { OpenAIResponsesModelId } from './responses/openai-responses-language-model-options';
 import { OpenAISpeechModel } from './speech/openai-speech-model';
 import type { OpenAISpeechModelId } from './speech/openai-speech-model-options';
 import { OpenAITranscriptionModel } from './transcription/openai-transcription-model';
 import type { OpenAITranscriptionModelId } from './transcription/openai-transcription-model-options';
-import { OpenAITranslationModel } from './translation/openai-translation-model';
-import type { OpenAITranslationModelId } from './translation/openai-translation-model-options';
+import { OpenAISpeechTranslationModel } from './speech-translation/openai-speech-translation-model';
+import type { OpenAISpeechTranslationModelId } from './speech-translation/openai-speech-translation-model-options';
 import { OpenAISkills } from './skills/openai-skills';
 import { VERSION } from './version';
 
 export interface OpenAIProvider extends ProviderV4 {
-  (modelId: OpenAIResponsesModelId): LanguageModelV4;
+  (modelId: OpenAIResponsesModelId): BatchLanguageModelV4;
 
   /**
    * Creates an OpenAI model for text generation.
    */
-  languageModel(modelId: OpenAIResponsesModelId): LanguageModelV4;
+  languageModel(modelId: OpenAIResponsesModelId): BatchLanguageModelV4;
 
   /**
    * Creates an OpenAI chat model for text generation.
@@ -58,7 +59,7 @@ export interface OpenAIProvider extends ProviderV4 {
   /**
    * Creates an OpenAI responses API model for text generation.
    */
-  responses(modelId: OpenAIResponsesModelId): LanguageModelV4;
+  responses(modelId: OpenAIResponsesModelId): BatchLanguageModelV4;
 
   /**
    * Creates an OpenAI completion model for text generation.
@@ -103,13 +104,15 @@ export interface OpenAIProvider extends ProviderV4 {
   /**
    * Creates an experimental model for streaming speech translation.
    */
-  translation(modelId: OpenAITranslationModelId): SpeechTranslationModelV4;
+  translation(
+    modelId: OpenAISpeechTranslationModelId,
+  ): SpeechTranslationModelV4;
 
   /**
    * Creates an experimental model for streaming speech translation.
    */
   speechTranslationModel(
-    modelId: OpenAITranslationModelId,
+    modelId: OpenAISpeechTranslationModelId,
   ): SpeechTranslationModelV4;
 
   /**
@@ -257,9 +260,11 @@ export function createOpenAI(
       webSocket: options.webSocket,
     });
 
-  const createTranslationModel = (modelId: OpenAITranslationModelId) =>
-    new OpenAITranslationModel(modelId, {
-      provider: `${providerName}.translation`,
+  const createSpeechTranslationModel = (
+    modelId: OpenAISpeechTranslationModelId,
+  ) =>
+    new OpenAISpeechTranslationModel(modelId, {
+      provider: `${providerName}.speech-translation`,
       url: ({ path }) => `${baseURL}${path}`,
       headers: getHeaders,
       fetch: options.fetch,
@@ -301,7 +306,7 @@ export function createOpenAI(
   };
 
   const createResponsesModel = (modelId: OpenAIResponsesModelId) => {
-    return new OpenAIResponsesLanguageModel(modelId, {
+    return new OpenAIResponsesBatchLanguageModel(modelId, {
       provider: `${providerName}.responses`,
       url: ({ path }) => `${baseURL}${path}`,
       headers: getHeaders,
@@ -358,8 +363,8 @@ export function createOpenAI(
   provider.transcription = createTranscriptionModel;
   provider.transcriptionModel = createTranscriptionModel;
 
-  provider.translation = createTranslationModel;
-  provider.speechTranslationModel = createTranslationModel;
+  provider.translation = createSpeechTranslationModel;
+  provider.speechTranslationModel = createSpeechTranslationModel;
 
   provider.speech = createSpeechModel;
   provider.speechModel = createSpeechModel;