@picsart/ai-sdk 5.31.0 → 5.33.0

package/index.d.ts

@@ -241,6 +241,11 @@ type ModelInputById = {
         count?: 1 | 2 | 4 | 6 | 8 | 10;
         imageUrls?: string[];
     };
+    "flux-video-edit": {
+        videoUrl: string;
+        prompt: string;
+        safetyTolerance?: number;
+    };
     "flux-video-upscale": {
         videoUrl: string;
         upscaleFactor?: number;
@@ -383,6 +388,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;
@@ -2664,6 +2687,7 @@ declare const Models: {
     readonly Flux3Video: "flux-3-video";
     readonly FluxKontextMax: "flux-kontext-max";
     readonly FluxKontextPro: "flux-kontext-pro";
+    readonly FluxVideoEdit: "flux-video-edit";
     readonly FluxVideoUpscale: "flux-video-upscale";
     readonly Gemini25FlashImage: "gemini-2.5-flash-image";
     readonly Gemini25FlashTts: "gemini-2.5-flash-tts";
@@ -2686,6 +2710,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

@@ -5775,6 +5775,32 @@ var { MODELS: MODELS21 } = defineModels("flux", [
       // Moderation level: 0 (strict) … 4 (permissive).
       ...p.range("safetyTolerance", 0, 4, 2, { label: "Safety Tolerance" })
     }
+  },
+  {
+    // Pure pass-through like flux-video-upscale: the worker Command takes the
+    // SDK's own field names (videoUrl, prompt, safetyTolerance) — no payload
+    // builder needed.
+    id: "flux-video-edit",
+    name: "Sprout Video Edit",
+    workflow: "flux/v1/video-edit",
+    mode: "video",
+    inputType: "v2v",
+    addedAt: "2026-09-09",
+    estimatedTime: 180,
+    description: "Edit videos with a text instruction \u2014 change objects, styles or scenes while preserving motion, timing and audio. Source clips up to 15 seconds; output at 24 fps, up to 720p.",
+    features: [
+      feat("Video Required", "input"),
+      feat("Up to 15s", "duration"),
+      feat("720p", "resolution")
+    ],
+    paramConfig: {
+      // Vendor source caps: 15s, 50 MB. Also ≥160 px per side and ≥17 frames —
+      // minimums the upload check can't express; the vendor rejects violations.
+      ...params.videoInput("Source Video", "asset", true, 15, void 0, 50 * 1024 * 1024),
+      ...params.prompt({ maxLength: 4096 }),
+      // Moderation level: 0 (strict) … 4 (permissive).
+      ...p.range("safetyTolerance", 0, 4, 2, { label: "Safety Tolerance" })
+    }
   }
 ]);
 
@@ -6163,6 +6189,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 +6210,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 +6334,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,
@@ -11369,6 +11472,7 @@ var Flux2Pro = "flux-2-pro";
 var Flux3Video = "flux-3-video";
 var FluxKontextMax = "flux-kontext-max";
 var FluxKontextPro = "flux-kontext-pro";
+var FluxVideoEdit = "flux-video-edit";
 var FluxVideoUpscale = "flux-video-upscale";
 var Gemini25FlashImage = "gemini-2.5-flash-image";
 var Gemini25FlashTts = "gemini-2.5-flash-tts";
@@ -11391,6 +11495,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";
@@ -11592,6 +11698,7 @@ var Models = {
   Flux3Video,
   FluxKontextMax,
   FluxKontextPro,
+  FluxVideoEdit,
   FluxVideoUpscale,
   Gemini25FlashImage,
   Gemini25FlashTts,
@@ -11614,6 +11721,8 @@ var Models = {
   GptImage1,
   GptImage15,
   GptImage2,
+  GptImage25Flare,
+  GptImage25Sunburst,
   GrokEditVideo,
   GrokExtendVideo,
   GrokImagineImage,

package/package.json

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