@ai-sdk/openai 3.0.136 → 3.0.137

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ai-sdk/openai
 
+## 3.0.137
+
+### Patch Changes
+
+- afde897: feat(openai): support GPT Image 2.6 models with `complexity`, markup-guided edits (`markup`), animated GIF output (`outputFormat: 'gif'`, `frameCount`, `frameDurationMs`), and `safetyIdentifier` for image models
+
 ## 3.0.136
 
 ### Patch Changes

package/dist/index.d.mts

@@ -46,22 +46,28 @@ declare const openaiEmbeddingModelOptions: _ai_sdk_provider_utils.LazySchema<{
 }>;
 type OpenAIEmbeddingModelOptions = InferSchema<typeof openaiEmbeddingModelOptions>;
 
-type OpenAIImageModelId = 'dall-e-3' | 'dall-e-2' | 'gpt-image-1' | 'gpt-image-1-mini' | 'gpt-image-1.5' | 'gpt-image-2' | 'gpt-image-2.5-flare' | 'gpt-image-2.5-flare-2026-09-08' | 'gpt-image-2.5-sunburst' | 'gpt-image-2.5-sunburst-2026-09-08' | 'chatgpt-image-latest' | (string & {});
+type OpenAIImageModelId = 'dall-e-3' | 'dall-e-2' | 'gpt-image-1' | 'gpt-image-1-mini' | 'gpt-image-1.5' | 'gpt-image-2' | 'gpt-image-2.6-flare' | 'gpt-image-2.6-sunburst' | 'gpt-image-2.5-flare' | 'gpt-image-2.5-flare-2026-09-08' | 'gpt-image-2.5-sunburst' | 'gpt-image-2.5-sunburst-2026-09-08' | 'chatgpt-image-latest' | (string & {});
 declare const openaiImageModelOptions: _ai_sdk_provider_utils.LazySchema<{
     quality?: "low" | "medium" | "high" | "xhigh" | "max" | "auto" | "standard" | "hd" | undefined;
     background?: "auto" | "transparent" | "opaque" | undefined;
     outputFormat?: "png" | "jpeg" | "webp" | undefined;
+    complexity?: "low" | "medium" | "high" | undefined;
     outputCompression?: number | undefined;
     user?: string | undefined;
+    safetyIdentifier?: string | undefined;
 }>;
 type OpenAIImageModelOptions = InferSchema<typeof openaiImageModelOptions>;
 declare const openaiImageModelGenerationOptions: _ai_sdk_provider_utils.LazySchema<{
     quality?: "low" | "medium" | "high" | "xhigh" | "max" | "auto" | "standard" | "hd" | undefined;
     background?: "auto" | "transparent" | "opaque" | undefined;
-    outputFormat?: "png" | "jpeg" | "webp" | undefined;
+    complexity?: "low" | "medium" | "high" | undefined;
     outputCompression?: number | undefined;
     user?: string | undefined;
+    safetyIdentifier?: string | undefined;
     style?: "vivid" | "natural" | undefined;
+    outputFormat?: "png" | "jpeg" | "webp" | "gif" | undefined;
+    frameCount?: number | undefined;
+    frameDurationMs?: number | undefined;
     moderation?: "low" | "auto" | undefined;
 }>;
 type OpenAIImageModelGenerationOptions = InferSchema<typeof openaiImageModelGenerationOptions>;
@@ -69,9 +75,12 @@ declare const openaiImageModelEditOptions: _ai_sdk_provider_utils.LazySchema<{
     quality?: "low" | "medium" | "high" | "xhigh" | "max" | "auto" | "standard" | "hd" | undefined;
     background?: "auto" | "transparent" | "opaque" | undefined;
     outputFormat?: "png" | "jpeg" | "webp" | undefined;
+    complexity?: "low" | "medium" | "high" | undefined;
     outputCompression?: number | undefined;
     user?: string | undefined;
+    safetyIdentifier?: string | undefined;
     inputFidelity?: "low" | "high" | undefined;
+    markup?: string | undefined;
 }>;
 type OpenAIImageModelEditOptions = InferSchema<typeof openaiImageModelEditOptions>;
 

package/dist/index.d.ts

@@ -46,22 +46,28 @@ declare const openaiEmbeddingModelOptions: _ai_sdk_provider_utils.LazySchema<{
 }>;
 type OpenAIEmbeddingModelOptions = InferSchema<typeof openaiEmbeddingModelOptions>;
 
-type OpenAIImageModelId = 'dall-e-3' | 'dall-e-2' | 'gpt-image-1' | 'gpt-image-1-mini' | 'gpt-image-1.5' | 'gpt-image-2' | 'gpt-image-2.5-flare' | 'gpt-image-2.5-flare-2026-09-08' | 'gpt-image-2.5-sunburst' | 'gpt-image-2.5-sunburst-2026-09-08' | 'chatgpt-image-latest' | (string & {});
+type OpenAIImageModelId = 'dall-e-3' | 'dall-e-2' | 'gpt-image-1' | 'gpt-image-1-mini' | 'gpt-image-1.5' | 'gpt-image-2' | 'gpt-image-2.6-flare' | 'gpt-image-2.6-sunburst' | 'gpt-image-2.5-flare' | 'gpt-image-2.5-flare-2026-09-08' | 'gpt-image-2.5-sunburst' | 'gpt-image-2.5-sunburst-2026-09-08' | 'chatgpt-image-latest' | (string & {});
 declare const openaiImageModelOptions: _ai_sdk_provider_utils.LazySchema<{
     quality?: "low" | "medium" | "high" | "xhigh" | "max" | "auto" | "standard" | "hd" | undefined;
     background?: "auto" | "transparent" | "opaque" | undefined;
     outputFormat?: "png" | "jpeg" | "webp" | undefined;
+    complexity?: "low" | "medium" | "high" | undefined;
     outputCompression?: number | undefined;
     user?: string | undefined;
+    safetyIdentifier?: string | undefined;
 }>;
 type OpenAIImageModelOptions = InferSchema<typeof openaiImageModelOptions>;
 declare const openaiImageModelGenerationOptions: _ai_sdk_provider_utils.LazySchema<{
     quality?: "low" | "medium" | "high" | "xhigh" | "max" | "auto" | "standard" | "hd" | undefined;
     background?: "auto" | "transparent" | "opaque" | undefined;
-    outputFormat?: "png" | "jpeg" | "webp" | undefined;
+    complexity?: "low" | "medium" | "high" | undefined;
     outputCompression?: number | undefined;
     user?: string | undefined;
+    safetyIdentifier?: string | undefined;
     style?: "vivid" | "natural" | undefined;
+    outputFormat?: "png" | "jpeg" | "webp" | "gif" | undefined;
+    frameCount?: number | undefined;
+    frameDurationMs?: number | undefined;
     moderation?: "low" | "auto" | undefined;
 }>;
 type OpenAIImageModelGenerationOptions = InferSchema<typeof openaiImageModelGenerationOptions>;
@@ -69,9 +75,12 @@ declare const openaiImageModelEditOptions: _ai_sdk_provider_utils.LazySchema<{
     quality?: "low" | "medium" | "high" | "xhigh" | "max" | "auto" | "standard" | "hd" | undefined;
     background?: "auto" | "transparent" | "opaque" | undefined;
     outputFormat?: "png" | "jpeg" | "webp" | undefined;
+    complexity?: "low" | "medium" | "high" | undefined;
     outputCompression?: number | undefined;
     user?: string | undefined;
+    safetyIdentifier?: string | undefined;
     inputFidelity?: "low" | "high" | undefined;
+    markup?: string | undefined;
 }>;
 type OpenAIImageModelEditOptions = InferSchema<typeof openaiImageModelEditOptions>;
 

package/dist/index.js

@@ -2065,6 +2065,7 @@ var OpenAIEmbeddingModel = class {
 };
 
 // src/image/openai-image-model.ts
+var import_provider7 = require("@ai-sdk/provider");
 var import_provider_utils14 = require("@ai-sdk/provider-utils");
 
 // src/image/openai-image-api.ts
@@ -2107,6 +2108,8 @@ var modelMaxImagesPerCall = {
   "gpt-image-1-mini": 10,
   "gpt-image-1.5": 10,
   "gpt-image-2": 10,
+  "gpt-image-2.6-flare": 10,
+  "gpt-image-2.6-sunburst": 10,
   "gpt-image-2.5-flare": 10,
   "gpt-image-2.5-flare-2026-09-08": 10,
   "gpt-image-2.5-sunburst": 10,
@@ -2142,6 +2145,11 @@ var baseImageModelOptionsObject = () => import_v49.z.object({
    * Format in which the generated image(s) are returned.
    */
   outputFormat: import_v49.z.enum(["png", "jpeg", "webp"]).optional(),
+  /**
+   * How much detail the model puts into the image. Supported by GPT Image
+   * 2.6 models. The API defaults to `high`.
+   */
+  complexity: import_v49.z.enum(["low", "medium", "high"]).optional(),
   /**
    * Compression level (0-100) for the generated image(s). Applies to the
    * `jpeg` and `webp` output formats.
@@ -2151,7 +2159,13 @@ var baseImageModelOptionsObject = () => import_v49.z.object({
    * A unique identifier representing your end-user, which can help OpenAI
    * to monitor and detect abuse.
    */
-  user: import_v49.z.string().optional()
+  user: import_v49.z.string().optional(),
+  /**
+   * A stable identifier used to help detect users of your application that
+   * may be violating OpenAI's usage policies. Should be a hashed username
+   * or email address.
+   */
+  safetyIdentifier: import_v49.z.string().max(128).optional()
 });
 var openaiImageModelOptions = (0, import_provider_utils13.lazySchema)(
   () => (0, import_provider_utils13.zodSchema)(baseImageModelOptionsObject())
@@ -2165,6 +2179,22 @@ var openaiImageModelGenerationOptions = (0, import_provider_utils13.lazySchema)(
        * looking images.
        */
       style: import_v49.z.enum(["vivid", "natural"]).optional(),
+      /**
+       * Format in which the generated image(s) are returned. `gif` produces
+       * an animated GIF and is supported by GPT Image 2.6 models.
+       */
+      outputFormat: import_v49.z.enum(["png", "jpeg", "webp", "gif"]).optional(),
+      /**
+       * Number of frames (2-64) of an animated GIF. Only applies to the `gif`
+       * output format. The API defaults to 9.
+       */
+      frameCount: import_v49.z.number().int().min(2).max(64).optional(),
+      /**
+       * Duration of each frame in milliseconds (20-2000) of an animated GIF.
+       * The API rounds it to the nearest 10 ms. Only applies to the `gif`
+       * output format. The API defaults to 200.
+       */
+      frameDurationMs: import_v49.z.number().int().min(20).max(2e3).optional(),
       /**
        * Content moderation level for the generated image(s). `low` applies
        * less restrictive filtering.
@@ -2179,7 +2209,14 @@ var openaiImageModelEditOptions = (0, import_provider_utils13.lazySchema)(
       /**
        * Fidelity of the output image(s) to the input image(s).
        */
-      inputFidelity: import_v49.z.enum(["high", "low"]).optional()
+      inputFidelity: import_v49.z.enum(["high", "low"]).optional(),
+      /**
+       * A transparent PNG overlaid on the first input image to mark up the
+       * regions to change, as an HTTPS URL or a base64 data URL. It must match
+       * the dimensions of the first image. Supported by GPT Image 2.5 and 2.6
+       * models. Cannot be combined with a `mask`.
+       */
+      markup: import_v49.z.string().optional()
     })
   )
 );
@@ -2228,6 +2265,12 @@ var OpenAIImageModel = class {
         providerOptions,
         schema: openaiImageModelEditOptions
       })) != null ? _d : {};
+      if (mask != null && openaiOptions2.markup != null) {
+        throw new import_provider7.InvalidArgumentError({
+          argument: "providerOptions.openai.markup",
+          message: "`markup` cannot be combined with `mask`."
+        });
+      }
       const { value: response2, responseHeaders: responseHeaders2 } = await (0, import_provider_utils14.postFormDataToApi)({
         url: this.config.url({
           path: "/images/edits",
@@ -2252,14 +2295,17 @@ var OpenAIImageModel = class {
             )
           ),
           mask: mask != null ? await fileToBlob(mask) : void 0,
+          markup: openaiOptions2.markup != null ? await markupToBlob(openaiOptions2.markup) : void 0,
           n,
           size,
           quality: openaiOptions2.quality,
           background: openaiOptions2.background,
           output_format: openaiOptions2.outputFormat,
           output_compression: openaiOptions2.outputCompression,
+          complexity: openaiOptions2.complexity,
           input_fidelity: openaiOptions2.inputFidelity,
-          user: openaiOptions2.user
+          user: openaiOptions2.user,
+          safety_identifier: openaiOptions2.safetyIdentifier
         }),
         failedResponseHandler: openaiFailedResponseHandler,
         successfulResponseHandler: (0, import_provider_utils14.createJsonResponseHandler)(
@@ -2325,7 +2371,11 @@ var OpenAIImageModel = class {
         moderation: openaiOptions.moderation,
         output_format: openaiOptions.outputFormat,
         output_compression: openaiOptions.outputCompression,
+        complexity: openaiOptions.complexity,
+        frame_count: openaiOptions.frameCount,
+        frame_duration_ms: openaiOptions.frameDurationMs,
         user: openaiOptions.user,
+        safety_identifier: openaiOptions.safetyIdentifier,
         ...!hasDefaultResponseFormat(this.modelId) ? { response_format: "b64_json" } : {}
       },
       failedResponseHandler: openaiFailedResponseHandler,
@@ -2388,6 +2438,21 @@ function distributeTokenDetails(details, index, total) {
   }
   return result;
 }
+async function markupToBlob(markup) {
+  const dataUrl = /^data:([^;,]*)(;base64)?,(.*)$/s.exec(markup);
+  if (dataUrl == null) {
+    return (0, import_provider_utils14.downloadBlob)(markup);
+  }
+  if (dataUrl[2] == null) {
+    throw new import_provider7.InvalidArgumentError({
+      argument: "providerOptions.openai.markup",
+      message: "`markup` data URLs must be base64 encoded."
+    });
+  }
+  return new Blob([(0, import_provider_utils14.convertBase64ToUint8Array)(dataUrl[3])], {
+    type: dataUrl[1] || "image/png"
+  });
+}
 async function fileToBlob(file) {
   if (!file) return void 0;
   if (file.type === "url") {
@@ -3043,7 +3108,7 @@ var openaiTools = {
 };
 
 // src/responses/openai-responses-language-model.ts
-var import_provider10 = require("@ai-sdk/provider");
+var import_provider11 = require("@ai-sdk/provider");
 var import_provider_utils31 = require("@ai-sdk/provider-utils");
 
 // src/responses/convert-openai-responses-usage.ts
@@ -3087,7 +3152,7 @@ function convertOpenAIResponsesUsage(usage) {
 }
 
 // src/responses/convert-to-openai-responses-input.ts
-var import_provider8 = require("@ai-sdk/provider");
+var import_provider9 = require("@ai-sdk/provider");
 var import_provider_utils28 = require("@ai-sdk/provider-utils");
 var import_v422 = require("zod/v4");
 
@@ -3395,7 +3460,7 @@ var openaiResponsesSystemMessageOptionsSchema = (0, import_provider_utils26.lazy
 );
 
 // src/responses/expand-parallel-tool-call.ts
-var import_provider7 = require("@ai-sdk/provider");
+var import_provider8 = require("@ai-sdk/provider");
 var import_provider_utils27 = require("@ai-sdk/provider-utils");
 var parallelToolName = "parallel";
 var recipientNamePrefix = "functions.";
@@ -3405,7 +3470,7 @@ function getParallelToolCallMetadata({
 }) {
   var _a2;
   const metadata = (_a2 = providerOptions == null ? void 0 : providerOptions[providerOptionsName]) == null ? void 0 : _a2.parallelToolCall;
-  if (!(0, import_provider7.isJSONObject)(metadata) || typeof metadata.itemId !== "string" || typeof metadata.toolCallId !== "string" || typeof metadata.toolName !== "string" || typeof metadata.input !== "string" || typeof metadata.index !== "number" || !Number.isInteger(metadata.index) || typeof metadata.count !== "number" || !Number.isInteger(metadata.count) || metadata.index < 0 || metadata.count <= metadata.index) {
+  if (!(0, import_provider8.isJSONObject)(metadata) || typeof metadata.itemId !== "string" || typeof metadata.toolCallId !== "string" || typeof metadata.toolName !== "string" || typeof metadata.input !== "string" || typeof metadata.index !== "number" || !Number.isInteger(metadata.index) || typeof metadata.count !== "number" || !Number.isInteger(metadata.count) || metadata.index < 0 || metadata.count <= metadata.index) {
     return void 0;
   }
   return metadata;
@@ -3426,7 +3491,7 @@ async function expandParallelToolCall({
     return void 0;
   }
   const parsedInput = await (0, import_provider_utils27.safeParseJSON)({ text: toolCall.input });
-  if (!parsedInput.success || !(0, import_provider7.isJSONObject)(parsedInput.value)) {
+  if (!parsedInput.success || !(0, import_provider8.isJSONObject)(parsedInput.value)) {
     return void 0;
   }
   const toolUses = parsedInput.value.tool_uses;
@@ -3436,12 +3501,12 @@ async function expandParallelToolCall({
   const availableToolNames = new Set(tools.map((tool) => tool.name));
   const expandedToolCalls = [];
   for (const [index, toolUse] of toolUses.entries()) {
-    if (!(0, import_provider7.isJSONObject)(toolUse)) {
+    if (!(0, import_provider8.isJSONObject)(toolUse)) {
       return void 0;
     }
     const recipientName = toolUse.recipient_name;
     const parameters = toolUse.parameters;
-    if (typeof recipientName !== "string" || !recipientName.startsWith(recipientNamePrefix) || !(0, import_provider7.isJSONObject)(parameters)) {
+    if (typeof recipientName !== "string" || !recipientName.startsWith(recipientNamePrefix) || !(0, import_provider8.isJSONObject)(parameters)) {
       return void 0;
     }
     const toolName = recipientName.slice(recipientNamePrefix.length);
@@ -3769,7 +3834,7 @@ async function convertToOpenAIResponsesInput({
         if (effort != null) {
           const unsupportedReason = content !== "" ? "Message-level reasoningEffortUpdate requires empty system message content." : configurationUpdateUnsupportedReason;
           if (unsupportedReason != null) {
-            throw new import_provider8.UnsupportedFunctionalityError({
+            throw new import_provider9.UnsupportedFunctionalityError({
               functionality: "Message-level reasoningEffortUpdate",
               message: unsupportedReason
             });
@@ -3881,7 +3946,7 @@ async function convertToOpenAIResponsesInput({
                   };
                 }
                 if (mediaType !== "application/pdf" && !passThroughUnsupportedFiles) {
-                  throw new import_provider8.UnsupportedFunctionalityError({
+                  throw new import_provider9.UnsupportedFunctionalityError({
                     functionality: `file part media type ${mediaType}`
                   });
                 }
@@ -5496,7 +5561,7 @@ var openaiResponsesResponseSchema = (0, import_provider_utils29.lazySchema)(
 );
 
 // src/responses/openai-responses-prepare-tools.ts
-var import_provider9 = require("@ai-sdk/provider");
+var import_provider10 = require("@ai-sdk/provider");
 var import_provider_utils30 = require("@ai-sdk/provider-utils");
 async function prepareResponsesTools({
   tools,
@@ -5559,7 +5624,7 @@ async function prepareResponsesTools({
             namespaceTools.set(namespace.name, namespaceTool);
             openaiTools2.push(namespaceTool);
           } else if (namespaceTool.description !== namespace.description) {
-            throw new import_provider9.UnsupportedFunctionalityError({
+            throw new import_provider10.UnsupportedFunctionalityError({
               functionality: `conflicting descriptions for OpenAI tool namespace "${namespace.name}"`
             });
           }
@@ -5813,7 +5878,7 @@ async function prepareResponsesTools({
       allowedToolEntries.push(resolution.entry);
     }
     if (allowedToolEntries.length === 0) {
-      throw new import_provider9.UnsupportedFunctionalityError({
+      throw new import_provider10.UnsupportedFunctionalityError({
         functionality: `allowedTools with only tools that cannot be allow-listed (${droppedToolNames.join(
           ", "
         )})`
@@ -5848,7 +5913,7 @@ async function prepareResponsesTools({
     }
     default: {
       const _exhaustiveCheck = type;
-      throw new import_provider9.UnsupportedFunctionalityError({
+      throw new import_provider10.UnsupportedFunctionalityError({
         functionality: `tool choice type: ${_exhaustiveCheck}`
       });
     }
@@ -6156,7 +6221,7 @@ var OpenAIResponsesLanguageModel = class {
     }
     for (let i = 1; i < input.length; i++) {
       if (input[i - 1].type === "configuration_update" && input[i].type === "configuration_update") {
-        throw new import_provider10.UnsupportedFunctionalityError({
+        throw new import_provider11.UnsupportedFunctionalityError({
           functionality: "Adjacent reasoning effort configuration updates"
         });
       }
@@ -6385,7 +6450,7 @@ var OpenAIResponsesLanguageModel = class {
       fetch: this.config.fetch
     });
     if (response.error) {
-      throw new import_provider10.APICallError({
+      throw new import_provider11.APICallError({
         message: response.error.message,
         url,
         requestBodyValues: body,
@@ -7905,7 +7970,7 @@ function createOpenAIResponsesChatCompletionsMismatchError({
   requestBodyValues,
   responseHeaders
 }) {
-  return new import_provider10.APICallError({
+  return new import_provider11.APICallError({
     message: "Received a Chat Completions stream while using the OpenAI Responses API. The default OpenAI provider model uses the Responses API. If your custom baseURL targets a Chat Completions-compatible endpoint, use openai.chat('model-id') or createOpenAI(...).chat('model-id') instead. You can also use @ai-sdk/openai-compatible for OpenAI-compatible providers.",
     url,
     requestBodyValues,
@@ -8373,7 +8438,7 @@ var OpenAITranscriptionModel = class {
 };
 
 // src/version.ts
-var VERSION = true ? "3.0.136" : "0.0.0-test";
+var VERSION = true ? "3.0.137" : "0.0.0-test";
 
 // src/openai-provider.ts
 function createOpenAI(options = {}) {