@picsart/ai-sdk 5.30.0 → 5.32.0

package/index.d.ts

@@ -383,6 +383,24 @@ type ModelInputById = {
         count?: 1 | 2 | 4 | 6 | 8 | 10;
         imageUrls?: string[];
     };
+    "gpt-image-2.5-flare": {
+        prompt: string;
+        aspectRatio?: "1:1" | "3:2" | "2:3" | "16:9" | "9:16" | "4:3" | "3:4" | "auto";
+        quality?: "max" | "xhigh" | "high" | "medium" | "low";
+        background?: "opaque" | "transparent";
+        outputFormat?: "png" | "jpeg" | "webp";
+        count?: 1 | 2 | 4 | 6 | 8 | 10;
+        imageUrls?: string[];
+    };
+    "gpt-image-2.5-sunburst": {
+        prompt: string;
+        aspectRatio?: "1:1" | "3:2" | "2:3" | "16:9" | "9:16" | "4:3" | "3:4" | "auto";
+        quality?: "max" | "xhigh" | "high" | "medium" | "low";
+        background?: "opaque" | "transparent";
+        outputFormat?: "png" | "jpeg" | "webp";
+        count?: 1 | 2 | 4 | 6 | 8 | 10;
+        imageUrls?: string[];
+    };
     "grok-edit-video": {
         prompt: string;
         videoUrl: string;
@@ -2482,6 +2500,11 @@ interface ClientConfig {
     apiUrl: string;
     /** Enable Drive integration — auto-save generations to a Drive folder. */
     drive?: DriveConfig;
+    /**
+     * Input-transformation defaults applied to every generation. A per-call
+     * `options.inputsTransformation` overrides this field by field.
+     */
+    inputsTransformation?: PayloadInputsTransformationOptions;
     /**
      * Voice/avatar catalog behavior. `{ preload: true }` loads the first page
      * of every catalog-bound param in the background at client creation.
@@ -2527,8 +2550,9 @@ interface PayloadInputsTransformationOptions {
     /**
      * Downscale input images that exceed the vendor's download size cap
      * (e.g. ByteDance's 30 MiB) and retry the generation once, instead of
-     * failing with an input-limit error. Defaults to true; workers without
-     * input transformation ignore it.
+     * failing with an input-limit error. Opt-in — defaults to false, so an
+     * oversized input fails fast unless you set this; workers without input
+     * transformation ignore it.
      */
     downscaleOversizedImages?: boolean;
 }
@@ -2550,8 +2574,9 @@ interface GenerateOptions {
     folder?: DriveFolder;
     /** Save result to Picsart Drive via backend. Injected into the workflow payload. */
     drive?: PayloadDriveOptions;
-    /** Input-transformation settings. Injected into the workflow payload; when
-     *  omitted, oversized-image downscaling defaults to enabled. */
+    /** Input-transformation settings for this call — overrides the client-level
+     *  `inputsTransformation`. When neither is set, oversized-image downscaling
+     *  stays off (opt-in). */
     inputsTransformation?: PayloadInputsTransformationOptions;
     /**
      * App identity stamped onto the saved generation (appId/appType).
@@ -2679,6 +2704,8 @@ declare const Models: {
     readonly GptImage1: "gpt-image-1";
     readonly GptImage15: "gpt-image-1.5";
     readonly GptImage2: "gpt-image-2";
+    readonly GptImage25Flare: "gpt-image-2.5-flare";
+    readonly GptImage25Sunburst: "gpt-image-2.5-sunburst";
     readonly GrokEditVideo: "grok-edit-video";
     readonly GrokExtendVideo: "grok-extend-video";
     readonly GrokImagineImage: "grok-imagine-image";

package/index.js

@@ -6163,6 +6163,9 @@ var buildGptImage2EditPayload = (ctx) => ({
   ...ctx.outputFormat ? { output_format: ctx.outputFormat } : {}
 });
 var GPT_IMAGE_PROMPT_MAX = 32e3;
+var GPT_IMAGE_25_QUALITIES = ["max", "xhigh", "high", "medium", "low"];
+var GPT_IMAGE_25_ASPECT_RATIOS = ["1:1", "3:2", "2:3", "16:9", "9:16", "4:3", "3:4", "auto"];
+var GPT_IMAGE_25_MAX_INPUT_IMAGES = 16;
 var gptImage2Constraints = [
   {
     when: { imageUrls: { exists: true } },
@@ -6181,6 +6184,50 @@ var gptImageBgConstraints = [
 ];
 var { MODELS: MODELS23 } = defineModels("openai", [
   // ── Image ─────────────────────────────────────────
+  {
+    id: "gpt-image-2.5-sunburst",
+    name: "GPT Image 2.5 Sunburst",
+    addedAt: "2026-09-09",
+    workflow: "openai-images-generate",
+    editWorkflow: "openai-image-editing",
+    estimatedTime: 60,
+    mode: "image",
+    inputType: "t2i",
+    description: "Most capable GPT Image tier \u2014 premium edits and campaign-grade output, with longer generation times.",
+    features: [feat("Multi-Image Input", "input"), feat("High Quality", "quality")],
+    paramConfig: {
+      ...params.prompt({ maxLength: GPT_IMAGE_PROMPT_MAX }),
+      ...params.aspectRatio(GPT_IMAGE_25_ASPECT_RATIOS, "1:1"),
+      ...p.quality(GPT_IMAGE_25_QUALITIES, "high"),
+      ...p.enum("background", ["opaque", "transparent"], "opaque", { label: "Background" }),
+      ...p.enum("outputFormat", ["png", "jpeg", "webp"], "png", { label: "Format" }),
+      ...params.count(),
+      ...params.imageInput(GPT_IMAGE_25_MAX_INPUT_IMAGES, "Source Images")
+    },
+    constraints: gptImageBgConstraints
+  },
+  {
+    id: "gpt-image-2.5-flare",
+    name: "GPT Image 2.5 Flare",
+    addedAt: "2026-09-09",
+    workflow: "openai-images-generate",
+    editWorkflow: "openai-image-editing",
+    estimatedTime: 25,
+    mode: "image",
+    inputType: "t2i",
+    description: "Fast GPT Image tier \u2014 everyday generation at roughly half the latency of GPT Image 2.",
+    features: [feat("Multi-Image Input", "input"), feat("Fast", "characteristic")],
+    paramConfig: {
+      ...params.prompt({ maxLength: GPT_IMAGE_PROMPT_MAX }),
+      ...params.aspectRatio(GPT_IMAGE_25_ASPECT_RATIOS, "1:1"),
+      ...p.quality(GPT_IMAGE_25_QUALITIES, "high"),
+      ...p.enum("background", ["opaque", "transparent"], "opaque", { label: "Background" }),
+      ...p.enum("outputFormat", ["png", "jpeg", "webp"], "png", { label: "Format" }),
+      ...params.count(),
+      ...params.imageInput(GPT_IMAGE_25_MAX_INPUT_IMAGES, "Source Images")
+    },
+    constraints: gptImageBgConstraints
+  },
   {
     id: "gpt-image-2",
     name: "GPT Image 2",
@@ -6261,6 +6308,36 @@ var { MODELS: MODELS23 } = defineModels("openai", [
   }
 ]);
 
+// src/vendors/catalog/openai.payloads.ts
+var resolveSize = (aspectRatio, fallback) => aspectRatio === "auto" ? "auto" : GPT_IMAGE_2_AR_TO_SIZE[aspectRatio ?? ""] ?? fallback;
+var generateFor = (model) => (input) => ({
+  prompt: input.prompt,
+  model,
+  n: input.count ?? 1,
+  size: resolveSize(input.aspectRatio, "1024x1024"),
+  quality: input.quality ?? "high",
+  ...input.background ? { background: input.background } : {},
+  ...input.outputFormat ? { output_format: input.outputFormat } : {}
+});
+var editFor = (model) => (input) => ({
+  prompt: input.prompt,
+  model,
+  images: input.imageUrls ?? [],
+  n: input.count ?? 1,
+  size: resolveSize(input.aspectRatio, "auto"),
+  quality: input.quality ?? "high",
+  ...input.background ? { background: input.background } : {},
+  ...input.outputFormat ? { output_format: input.outputFormat } : {}
+});
+registerPayloads(MODELS23, {
+  "gpt-image-2.5-flare": generateFor("gpt-image-2.5-flare"),
+  "gpt-image-2.5-sunburst": generateFor("gpt-image-2.5-sunburst")
+});
+registerEditPayloads(MODELS23, {
+  "gpt-image-2.5-flare": editFor("gpt-image-2.5-flare"),
+  "gpt-image-2.5-sunburst": editFor("gpt-image-2.5-sunburst")
+});
+
 // src/vendors/catalog/elevenlabs.ts
 var buildElevenLabsTTSPayload = (modelId) => (ctx) => ({
   text: ctx.prompt,
@@ -10712,6 +10789,7 @@ function createClient(config) {
   const supportsSubmit = typeof transport.submit === "function";
   const apis = createApis(isConfig ? config : null);
   const catalogs = createCatalogs(transport, isConfig ? config.catalogs : void 0);
+  const inputsTransformationConfig = isConfig ? config.inputsTransformation : void 0;
   const driveConfig = isConfig ? config.drive : void 0;
   const driveClient = isConfig && driveConfig ? createDriveClient(resolveFetch(config), config.apiUrl, driveConfig.folder) : null;
   async function executeModel(model, workflow, payload, options) {
@@ -10754,7 +10832,7 @@ function createClient(config) {
       options: {
         ...existing,
         inputs_transformation: {
-          downscale_oversized_images: inputsTransformation?.downscaleOversizedImages ?? true
+          downscale_oversized_images: inputsTransformation?.downscaleOversizedImages ?? inputsTransformationConfig?.downscaleOversizedImages ?? false
         },
         ...drive ? { drive } : {}
       }
@@ -11390,6 +11468,8 @@ var Gpt6Astra = "gpt-6-astra";
 var GptImage1 = "gpt-image-1";
 var GptImage15 = "gpt-image-1.5";
 var GptImage2 = "gpt-image-2";
+var GptImage25Flare = "gpt-image-2.5-flare";
+var GptImage25Sunburst = "gpt-image-2.5-sunburst";
 var GrokEditVideo = "grok-edit-video";
 var GrokExtendVideo = "grok-extend-video";
 var GrokImagineImage = "grok-imagine-image";
@@ -11613,6 +11693,8 @@ var Models = {
   GptImage1,
   GptImage15,
   GptImage2,
+  GptImage25Flare,
+  GptImage25Sunburst,
   GrokEditVideo,
   GrokExtendVideo,
   GrokImagineImage,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@picsart/ai-sdk",
-  "version": "5.30.0",
+  "version": "5.32.0",
   "type": "module",
   "description": "Type-safe SDK for 100+ AI models — image, video, audio, and text generation with Picsart",
   "license": "MIT",