@ai-sdk/openai 4.0.57 → 4.0.58

package/docs/03-openai.mdx

@@ -217,12 +217,13 @@ The following provider options are available:
   `.nullable()`.
 </Note>
 
-- **serviceTier** _'auto' | 'flex' | 'priority' | 'fast' | 'default'_
+- **serviceTier** _'auto' | 'flex' | 'priority' | 'fast' | 'ultrafast' | 'default'_
   Service tier for the request. Set to 'flex' for 50% cheaper processing
   at the cost of increased latency (available for o3, o4-mini, and gpt-5 models).
   Set to 'priority' for faster processing with Enterprise access (available for gpt-4, gpt-5, gpt-5-mini, o3, o4-mini; gpt-5-nano is not supported).
   'fast' is OpenAI's newer name for the 'priority' tier; the two are interchangeable, and responses from
   gpt-5.6 and earlier report `serviceTier: 'priority'` for either.
+  Set to 'ultrafast' for access-controlled Ultrafast processing (available only for gpt-5.6-sol).
 
   Defaults to 'auto'.
 
@@ -2106,13 +2107,14 @@ The following optional provider options are available for OpenAI chat models:
 
   Parameters for prediction mode.
 
-- **serviceTier** _'auto' | 'flex' | 'priority' | 'fast' | 'default'_
+- **serviceTier** _'auto' | 'flex' | 'priority' | 'fast' | 'ultrafast' | 'default'_
 
   Service tier for the request. Set to 'flex' for 50% cheaper processing
   at the cost of increased latency (available for o3, o4-mini, and gpt-5 models).
   Set to 'priority' for faster processing with Enterprise access (available for gpt-4, gpt-5, gpt-5-mini, o3, o4-mini; gpt-5-nano is not supported).
   'fast' is OpenAI's newer name for the 'priority' tier; the two are interchangeable, and responses from
   gpt-5.6 and earlier report `serviceTier: 'priority'` for either.
+  Set to 'ultrafast' for access-controlled Ultrafast processing (available only for gpt-5.6-sol).
 
   Defaults to 'auto'.
 

package/package.json

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

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

@@ -139,12 +139,13 @@ export const openaiLanguageModelChatOptions = lazySchema(() =>
        * - 'flex': 50% cheaper processing at the cost of increased latency. Only available for o3 and o4-mini models.
        * - 'priority': Higher-speed processing with predictably low latency at premium cost. Available for Enterprise customers.
        * - 'fast': OpenAI's newer name for the 'priority' tier. Interchangeable with it.
+       * - 'ultrafast': Access-controlled Ultrafast processing. Only available for gpt-5.6-sol.
        * - 'default': The request will be processed with the standard pricing and performance for the selected model.
        *
        * @default 'auto'
        */
       serviceTier: z
-        .enum(['auto', 'flex', 'priority', 'fast', 'default'])
+        .enum(['auto', 'flex', 'priority', 'fast', 'ultrafast', 'default'])
         .optional(),
 
       /**

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

@@ -601,6 +601,7 @@ export type OpenAIResponsesTool =
     }
   | {
       type: 'image_generation';
+      action: 'generate' | 'edit' | 'auto' | undefined;
       background: 'auto' | 'opaque' | 'transparent' | undefined;
       input_fidelity: 'low' | 'high' | undefined;
       input_image_mask:
@@ -610,12 +611,18 @@ export type OpenAIResponsesTool =
           }
         | undefined;
       model: string | undefined;
-      moderation: 'auto' | undefined;
+      moderation: 'auto' | 'low' | undefined;
       output_compression: number | undefined;
       output_format: 'png' | 'jpeg' | 'webp' | undefined;
       partial_images: number | undefined;
       quality: 'auto' | 'low' | 'medium' | 'high' | undefined;
-      size: 'auto' | '1024x1024' | '1024x1536' | '1536x1024' | undefined;
+      size:
+        | 'auto'
+        | '1024x1024'
+        | '1024x1536'
+        | '1536x1024'
+        | (string & {})
+        | undefined;
     }
 
   /**

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

@@ -294,11 +294,12 @@ export const openaiLanguageModelResponsesOptionsSchema = lazySchema(() =>
        * Set to 'flex' for 50% cheaper processing at the cost of increased latency (available for o3, o4-mini, and gpt-5 models).
        * Set to 'priority' for faster processing with Enterprise access (available for gpt-4, gpt-5, gpt-5-mini, o3, o4-mini; gpt-5-nano is not supported).
        * Set to 'fast' for the same tier as 'priority' (OpenAI's newer name for it).
+       * Set to 'ultrafast' for access-controlled Ultrafast processing (available only for gpt-5.6-sol).
        *
        * Defaults to 'auto'.
        */
       serviceTier: z
-        .enum(['auto', 'flex', 'priority', 'fast', 'default'])
+        .enum(['auto', 'flex', 'priority', 'fast', 'ultrafast', 'default'])
         .nullish(),
 
       /**

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

@@ -302,6 +302,7 @@ export async function prepareResponsesTools({
 
             openaiTools.push({
               type: 'image_generation',
+              action: args.action,
               background: args.background,
               input_fidelity: args.inputFidelity,
               input_image_mask: args.inputImageMask

package/src/tool/image-generation.ts

@@ -9,6 +9,7 @@ export const imageGenerationArgsSchema = lazySchema(() =>
   zodSchema(
     z
       .object({
+        action: z.enum(['generate', 'edit', 'auto']).optional(),
         background: z.enum(['auto', 'opaque', 'transparent']).optional(),
         inputFidelity: z.enum(['low', 'high']).optional(),
         inputImageMask: z
@@ -18,13 +19,16 @@ export const imageGenerationArgsSchema = lazySchema(() =>
           })
           .optional(),
         model: z.string().optional(),
-        moderation: z.enum(['auto']).optional(),
+        moderation: z.enum(['auto', 'low']).optional(),
         outputCompression: z.number().int().min(0).max(100).optional(),
         outputFormat: z.enum(['png', 'jpeg', 'webp']).optional(),
         partialImages: z.number().int().min(0).max(3).optional(),
         quality: z.enum(['auto', 'low', 'medium', 'high']).optional(),
         size: z
-          .enum(['1024x1024', '1024x1536', '1536x1024', 'auto'])
+          .union([
+            z.enum(['1024x1024', '1024x1536', '1536x1024', 'auto']),
+            z.string().regex(/^\d+x\d+$/),
+          ])
           .optional(),
       })
       .strict(),
@@ -38,6 +42,11 @@ export const imageGenerationOutputSchema = lazySchema(() =>
 );
 
 type ImageGenerationArgs = {
+  /**
+   * Whether to generate a new image or edit an existing image. Default: auto.
+   */
+  action?: 'generate' | 'edit' | 'auto';
+
   /**
    * Background type for the generated image. Default is 'auto'.
    */
@@ -70,9 +79,9 @@ type ImageGenerationArgs = {
   model?: string;
 
   /**
-   * Moderation level for the generated image. Default: auto.
+   * Moderation level for the generated image. One of auto or low. Default: auto.
    */
-  moderation?: 'auto';
+  moderation?: 'auto' | 'low';
 
   /**
    * Compression level for the output image. Default: 100.
@@ -98,10 +107,11 @@ type ImageGenerationArgs = {
 
   /**
    * The size of the generated image.
-   * One of 1024x1024, 1024x1536, 1536x1024, or auto.
+   * One of 1024x1024, 1024x1536, 1536x1024, or auto. gpt-image-2 also accepts
+   * arbitrary WIDTHxHEIGHT sizes where both are divisible by 16, e.g. 1536x864.
    * Default: auto.
    */
-  size?: 'auto' | '1024x1024' | '1024x1536' | '1536x1024';
+  size?: 'auto' | '1024x1024' | '1024x1536' | '1536x1024' | (string & {});
 };
 
 const imageGenerationToolFactory = createProviderExecutedToolFactory<