@picsart/ai-sdk 6.5.0 → 6.7.0

package/index.d.ts

@@ -249,6 +249,14 @@ type ModelInputById = {
         count?: 1 | 2 | 4 | 6 | 8 | 10;
         imageUrls?: string[];
     };
+    "flux-3-image": {
+        prompt: string;
+        aspectRatio?: "auto" | "21:9" | "2:1" | "16:9" | "3:2" | "7:5" | "4:3" | "5:4" | "1:1" | "4:5" | "3:4" | "5:7" | "2:3" | "9:16" | "1:2";
+        resolution?: "512sq" | "768sq" | "1k" | "2k" | "4k";
+        count?: 1 | 2 | 4 | 6 | 8 | 10;
+        imageUrls?: string[];
+        safetyTolerance?: number;
+    };
     "flux-3-video": {
         prompt: string;
         aspectRatio?: "auto" | "21:9" | "2:1" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16";
@@ -2034,6 +2042,21 @@ interface FileDescriptor {
      * worker stays the authoritative gate. Omit for no client-side cap.
      */
     maxDurationSec?: number;
+    /**
+     * Min intrinsic duration (seconds) accepted for a video/audio file. Unlike
+     * every other bound here this one has no remedy: a clip that is too short
+     * cannot be lengthened, so the client's only honest move is to refuse the
+     * attachment and say why. Enforced client-side at upload by measuring the
+     * media before it is sent; the backend worker stays the authoritative gate.
+     * Omit for no client-side floor.
+     */
+    minDurationSec?: number;
+    /**
+     * Max intrinsic frame rate (fps) accepted for a video file. Enforced
+     * client-side at upload by measuring the media before it is sent; the backend
+     * worker stays the authoritative gate. Omit for no client-side cap.
+     */
+    maxFrameRate?: number;
     /**
      * Min intrinsic pixel count (width × height) accepted for an image/video file.
      * Enforced client-side at upload by measuring the media before it is sent; the
@@ -2049,6 +2072,41 @@ interface FileDescriptor {
      * authoritative gate. Omit for no client-side floor.
      */
     minSidePixels?: number;
+    /**
+     * Max intrinsic pixel count (width × height) accepted for an image/video
+     * file. The ceiling matching `minPixels`, and a separate rule from
+     * `maxSidePixels`: a 12000×2000 frame passes a 36 MP area cap and still
+     * breaks a 6000 px per-side one. Enforced client-side at upload by measuring
+     * the media before it is sent; the backend worker stays the authoritative
+     * gate. Omit for no client-side ceiling.
+     */
+    maxPixels?: number;
+    /**
+     * Max intrinsic long-side length (pixels) accepted for an image/video file:
+     * `max(width, height)` must not exceed this. The ceiling matching
+     * `minSidePixels`, so the pair expresses the shape vendors usually publish
+     * ("width and height must each be between 300 and 6000 px"). Distinct from
+     * `maxShortSidePixels`, which bounds the OTHER side and exists for upscaler
+     * sources. Enforced client-side at upload by measuring the media before it is
+     * sent; the backend worker stays the authoritative gate. Omit for no
+     * client-side ceiling.
+     */
+    maxSidePixels?: number;
+    /**
+     * Min intrinsic aspect ratio (width / height) accepted for an image/video
+     * file. Vendors publish this as the bound a panorama or a tall crop breaks,
+     * and it is not derivable from the pixel and side bounds: a 6000x1200 frame
+     * satisfies a [300, 6000] per-side rule and a 36 MP area rule and is still
+     * refused at 5.0. Enforced client-side at upload by measuring the media
+     * before it is sent; the backend worker stays the authoritative gate. Omit
+     * for no client-side floor.
+     */
+    minAspectRatio?: number;
+    /**
+     * Max intrinsic aspect ratio (width / height) accepted for an image/video
+     * file. The ceiling matching `minAspectRatio`.
+     */
+    maxAspectRatio?: number;
     /**
      * Max intrinsic short-side length (pixels) accepted for an image/video file —
      * `min(width, height)` must not exceed this. Used by upscalers whose source
@@ -2929,6 +2987,7 @@ declare const Models: {
     readonly Flux2Flex: "flux-2-flex";
     readonly Flux2Max: "flux-2-max";
     readonly Flux2Pro: "flux-2-pro";
+    readonly Flux3Image: "flux-3-image";
     readonly Flux3Video: "flux-3-video";
     readonly FluxKontextMax: "flux-kontext-max";
     readonly FluxKontextPro: "flux-kontext-pro";

package/index.js

@@ -927,8 +927,14 @@ var p = {
           accept,
           ...opts?.array ? { array: opts.array } : {},
           ...opts?.maxDurationSec != null ? { maxDurationSec: opts.maxDurationSec } : {},
+          ...opts?.minDurationSec != null ? { minDurationSec: opts.minDurationSec } : {},
+          ...opts?.maxFrameRate != null ? { maxFrameRate: opts.maxFrameRate } : {},
           ...opts?.minPixels != null ? { minPixels: opts.minPixels } : {},
+          ...opts?.maxPixels != null ? { maxPixels: opts.maxPixels } : {},
           ...opts?.minSidePixels != null ? { minSidePixels: opts.minSidePixels } : {},
+          ...opts?.maxSidePixels != null ? { maxSidePixels: opts.maxSidePixels } : {},
+          ...opts?.minAspectRatio != null ? { minAspectRatio: opts.minAspectRatio } : {},
+          ...opts?.maxAspectRatio != null ? { maxAspectRatio: opts.maxAspectRatio } : {},
           ...opts?.maxShortSidePixels != null ? { maxShortSidePixels: opts.maxShortSidePixels } : {},
           ...opts?.maxBytes != null ? { maxBytes: opts.maxBytes } : {}
         }
@@ -1162,50 +1168,37 @@ var params = {
   // `category` defaults to the most common role for the slot (overridable per call):
   //   asset    → start/end frame, sync audio (direct inputs to the output)
   //   reference → ref images/videos/audios (guidance signals)
-  /** Array of image inputs (writes to `imageUrls`). `bounds` carries the
-   *  client-side dimension floors enforced at upload: `minPixels` for a vendor
-   *  rule stated as a total pixel count, `minSidePixels` for one stated per
-   *  side (width and height each), which is what most vendors publish. */
-  imageInput: (max = 1, label = "Start Image", required = false, category = "reference", bounds) => p.file("imageUrls", "image", {
-    array: { max },
-    label,
-    required,
-    category,
-    ...bounds?.minPixels != null ? { minPixels: bounds.minPixels } : {},
-    ...bounds?.minSidePixels != null ? { minSidePixels: bounds.minSidePixels } : {}
-  }),
+  /** Array of image inputs (writes to `imageUrls`). */
+  imageInput: (max = 1, label = "Start Image", required = false, category = "reference", bounds) => p.file("imageUrls", "image", { array: { max }, label, required, category, ...bounds }),
   /** Single source-video slot (v2v / video edit). Writes to `videoUrl`.
-   *  `maxDurationSec` caps the source clip length, `maxShortSidePixels` caps
-   *  the shorter side (upscaler sources) and `maxBytes` caps the file size,
-   *  all enforced client-side at upload. */
-  videoInput: (label = "Source Video", category = "reference", required = true, maxDurationSec, maxShortSidePixels, maxBytes) => p.file("videoUrl", "video", {
+   *  The four positional limits predate `bounds` and are kept so the dozens of
+   *  existing call sites do not churn; new limits go in `bounds`. */
+  videoInput: (label = "Source Video", category = "reference", required = true, maxDurationSec, maxShortSidePixels, maxBytes, bounds) => p.file("videoUrl", "video", {
     label,
     required,
     category,
-    ...maxDurationSec != null ? { maxDurationSec } : {},
-    ...maxShortSidePixels != null ? { maxShortSidePixels } : {},
-    ...maxBytes != null ? { maxBytes } : {}
+    maxDurationSec,
+    maxShortSidePixels,
+    maxBytes,
+    ...bounds
   }),
   /** Single driving / sync-audio slot. Writes to `audioUrl`. */
   audioInput: (label = "Audio Track", required = false, category = "asset") => p.file("audioUrl", "audio", { label, required, category }),
-  /** Array of reference videos (writes to `videoUrls`). Backend enforces
-   *  per-model total-duration caps (e.g. ≤ 15s for seedance). `bounds` carries
-   *  the client-side checks run at upload: `minPixels` for a total-pixel floor,
-   *  `minSidePixels` for a per-side one, `maxBytes` for each clip's file size. */
-  videoInputs: (max = 3, label = "Reference Videos", required = false, bounds) => p.file("videoUrls", "video", {
-    array: { max },
-    label,
-    required,
-    category: "reference",
-    ...bounds?.minPixels != null ? { minPixels: bounds.minPixels } : {},
-    ...bounds?.minSidePixels != null ? { minSidePixels: bounds.minSidePixels } : {},
-    ...bounds?.maxBytes != null ? { maxBytes: bounds.maxBytes } : {}
-  }),
-  /** Array of reference audios (writes to `audioUrls`). Backend enforces
-   *  per-model total-duration caps. */
-  audioInputs: (max = 3, label = "Reference Audios", required = false) => p.file("audioUrls", "audio", { array: { max }, label, required, category: "reference" }),
-  startFrame: (label = "Start Frame", required = false) => p.file("startFrame", "image", { label, required, category: "asset" }),
-  endFrame: (label = "End Frame") => p.file("endFrame", "image", { label, category: "asset" })
+  /** Array of reference videos (writes to `videoUrls`). `bounds` is checked per
+   *  clip. The backend also caps the COMBINED length of the array per model,
+   *  which no descriptor field expresses yet; declaring the per-clip bounds
+   *  still turns the common single-clip case into a trim prompt in the composer
+   *  instead of a vendor `400` after the user pressed Generate. */
+  videoInputs: (max = 3, label = "Reference Videos", required = false, bounds) => p.file("videoUrls", "video", { array: { max }, label, required, category: "reference", ...bounds }),
+  /** Array of reference audios (writes to `audioUrls`). `bounds` is checked per
+   *  clip; as with `videoInputs` the backend also caps the combined length. */
+  audioInputs: (max = 3, label = "Reference Audios", required = false, bounds) => p.file("audioUrls", "audio", { array: { max }, label, required, category: "reference", ...bounds }),
+  /** First-frame slot (writes to `startFrame`). Vendors routinely publish a
+   *  DIFFERENT pixel floor for a frame than for a reference image, because a
+   *  frame becomes the output's first rendered frame. */
+  startFrame: (label = "Start Frame", required = false, bounds) => p.file("startFrame", "image", { label, required, category: "asset", ...bounds }),
+  /** Last-frame slot (writes to `endFrame`). Same `bounds` as `startFrame`. */
+  endFrame: (label = "End Frame", bounds) => p.file("endFrame", "image", { label, category: "asset", ...bounds })
 };
 var paramPresets = {
   videoStartEndWithAudio
@@ -3673,8 +3666,71 @@ registerPayloads(MODELS11, {
 // src/vendors/catalog/seedance.ts
 var SEEDANCE_FRAME_REF_REASON = "Start/End frames cannot be combined with reference images, videos, or audios";
 var SEEDANCE_MIN_SIDE_PIXELS = 300;
+var SEEDANCE_MAX_SIDE_PIXELS = 6e3;
+var SEEDANCE_MIN_ASPECT_RATIO = 0.39;
+var SEEDANCE_MAX_ASPECT_RATIO = 2.5;
+var SEEDANCE_MAX_IMAGE_PIXELS = 36e6;
 var SEEDANCE_VIDEO_MIN_PIXELS = 407696;
-var SEEDANCE_25_MAX_VIDEO_BYTES = 209715200;
+var SEEDANCE_VIDEO_MAX_PIXELS = 8295044;
+var SEEDANCE_MIN_MEDIA_SEC = 1.8;
+var SEEDANCE_MAX_FRAME_RATE = 60;
+var SEEDANCE_MAX_VIDEO_BYTES = 209715200;
+var SEEDANCE_FRAME_MIN_PIXELS = 9e4;
+var SEEDANCE_MAX_IMAGE_BYTES = 31457280;
+var SEEDANCE_MAX_AUDIO_BYTES = 15728640;
+var SEEDANCE_25_MAX_MEDIA_SEC = 30;
+var SEEDANCE_20_MAX_MEDIA_SEC = 15;
+var SEEDANCE_IMAGE_BOUNDS = {
+  minAspectRatio: SEEDANCE_MIN_ASPECT_RATIO,
+  maxAspectRatio: SEEDANCE_MAX_ASPECT_RATIO,
+  minSidePixels: SEEDANCE_MIN_SIDE_PIXELS,
+  maxSidePixels: SEEDANCE_MAX_SIDE_PIXELS,
+  maxPixels: SEEDANCE_MAX_IMAGE_PIXELS,
+  maxBytes: SEEDANCE_MAX_IMAGE_BYTES
+};
+var SEEDANCE_FRAME_BOUNDS = {
+  minAspectRatio: SEEDANCE_MIN_ASPECT_RATIO,
+  maxAspectRatio: SEEDANCE_MAX_ASPECT_RATIO,
+  minPixels: SEEDANCE_FRAME_MIN_PIXELS,
+  maxPixels: SEEDANCE_MAX_IMAGE_PIXELS,
+  minSidePixels: SEEDANCE_MIN_SIDE_PIXELS,
+  maxSidePixels: SEEDANCE_MAX_SIDE_PIXELS,
+  maxBytes: SEEDANCE_MAX_IMAGE_BYTES
+};
+var SEEDANCE_25_VIDEO_BOUNDS = {
+  minAspectRatio: SEEDANCE_MIN_ASPECT_RATIO,
+  maxAspectRatio: SEEDANCE_MAX_ASPECT_RATIO,
+  minPixels: SEEDANCE_VIDEO_MIN_PIXELS,
+  maxPixels: SEEDANCE_VIDEO_MAX_PIXELS,
+  minSidePixels: SEEDANCE_MIN_SIDE_PIXELS,
+  maxSidePixels: SEEDANCE_MAX_SIDE_PIXELS,
+  maxBytes: SEEDANCE_MAX_VIDEO_BYTES,
+  minDurationSec: SEEDANCE_MIN_MEDIA_SEC,
+  maxDurationSec: SEEDANCE_25_MAX_MEDIA_SEC,
+  maxFrameRate: SEEDANCE_MAX_FRAME_RATE
+};
+var SEEDANCE_20_VIDEO_BOUNDS = {
+  minAspectRatio: SEEDANCE_MIN_ASPECT_RATIO,
+  maxAspectRatio: SEEDANCE_MAX_ASPECT_RATIO,
+  minPixels: SEEDANCE_VIDEO_MIN_PIXELS,
+  maxPixels: SEEDANCE_VIDEO_MAX_PIXELS,
+  minSidePixels: SEEDANCE_MIN_SIDE_PIXELS,
+  maxSidePixels: SEEDANCE_MAX_SIDE_PIXELS,
+  maxBytes: SEEDANCE_MAX_VIDEO_BYTES,
+  minDurationSec: SEEDANCE_MIN_MEDIA_SEC,
+  maxDurationSec: SEEDANCE_20_MAX_MEDIA_SEC,
+  maxFrameRate: SEEDANCE_MAX_FRAME_RATE
+};
+var SEEDANCE_25_AUDIO_BOUNDS = {
+  minDurationSec: SEEDANCE_MIN_MEDIA_SEC,
+  maxDurationSec: SEEDANCE_25_MAX_MEDIA_SEC,
+  maxBytes: SEEDANCE_MAX_AUDIO_BYTES
+};
+var SEEDANCE_20_AUDIO_BOUNDS = {
+  minDurationSec: SEEDANCE_MIN_MEDIA_SEC,
+  maxDurationSec: SEEDANCE_20_MAX_MEDIA_SEC,
+  maxBytes: SEEDANCE_MAX_AUDIO_BYTES
+};
 var seedance20Constraints = [
   {
     when: {
@@ -3944,15 +4000,11 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...p.enum("outputFormat", SEEDANCE_25_FORMATS, "mp4", { label: "Format" }),
       ...p.enum("colorDepth", SEEDANCE_25_COLOR_DEPTHS, "10bit", { label: "Color Depth" }),
       // 2.5 lifts the reference caps to 30 images / 10 videos / 10 audios.
-      ...params.imageInput(30, "Reference Images", false, "reference", { minSidePixels: SEEDANCE_MIN_SIDE_PIXELS }),
-      ...params.videoInputs(10, "Reference Videos", false, {
-        minPixels: SEEDANCE_VIDEO_MIN_PIXELS,
-        minSidePixels: SEEDANCE_MIN_SIDE_PIXELS,
-        maxBytes: SEEDANCE_25_MAX_VIDEO_BYTES
-      }),
-      ...params.audioInputs(10, "Reference Audios"),
-      ...params.startFrame(),
-      ...params.endFrame()
+      ...params.imageInput(30, "Reference Images", false, "reference", SEEDANCE_IMAGE_BOUNDS),
+      ...params.videoInputs(10, "Reference Videos", false, SEEDANCE_25_VIDEO_BOUNDS),
+      ...params.audioInputs(10, "Reference Audios", false, SEEDANCE_25_AUDIO_BOUNDS),
+      ...params.startFrame("Start Frame", false, SEEDANCE_FRAME_BOUNDS),
+      ...params.endFrame("End Frame", SEEDANCE_FRAME_BOUNDS)
     }
   },
   {
@@ -3983,15 +4035,11 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...p.enum("outputFormat", SEEDANCE_25_FORMATS, "mp4", { label: "Format" }),
       ...p.enum("colorDepth", SEEDANCE_25_COLOR_DEPTHS, "10bit", { label: "Color Depth" }),
       // 2.5 lifts the reference caps to 30 images / 10 videos / 10 audios.
-      ...params.imageInput(30, "Reference Images", false, "reference", { minSidePixels: SEEDANCE_MIN_SIDE_PIXELS }),
-      ...params.videoInputs(10, "Reference Videos", false, {
-        minPixels: SEEDANCE_VIDEO_MIN_PIXELS,
-        minSidePixels: SEEDANCE_MIN_SIDE_PIXELS,
-        maxBytes: SEEDANCE_25_MAX_VIDEO_BYTES
-      }),
-      ...params.audioInputs(10, "Reference Audios"),
-      ...params.startFrame(),
-      ...params.endFrame()
+      ...params.imageInput(30, "Reference Images", false, "reference", SEEDANCE_IMAGE_BOUNDS),
+      ...params.videoInputs(10, "Reference Videos", false, SEEDANCE_25_VIDEO_BOUNDS),
+      ...params.audioInputs(10, "Reference Audios", false, SEEDANCE_25_AUDIO_BOUNDS),
+      ...params.startFrame("Start Frame", false, SEEDANCE_FRAME_BOUNDS),
+      ...params.endFrame("End Frame", SEEDANCE_FRAME_BOUNDS)
     }
   },
   {
@@ -4018,8 +4066,10 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.returnLastFrame(),
       ...p.enum("outputFormat", SEEDANCE_25_FORMATS, "mp4", { label: "Format" }),
       ...p.enum("colorDepth", SEEDANCE_25_COLOR_DEPTHS, "10bit", { label: "Color Depth" }),
-      ...params.videoInput("Source Video", "reference", true, void 0, void 0, SEEDANCE_25_MAX_VIDEO_BYTES),
-      ...params.imageInput(30, "Reference Images")
+      // Every limit rides in `bounds`; the positional maxDuration / maxShortSide
+      // / maxBytes args predate it and are skipped rather than duplicated.
+      ...params.videoInput("Source Video", "reference", true, void 0, void 0, void 0, SEEDANCE_25_VIDEO_BOUNDS),
+      ...params.imageInput(30, "Reference Images", false, "reference", SEEDANCE_IMAGE_BOUNDS)
     }
   },
   {
@@ -4047,8 +4097,10 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.returnLastFrame(),
       ...p.enum("outputFormat", SEEDANCE_25_FORMATS, "mp4", { label: "Format" }),
       ...p.enum("colorDepth", SEEDANCE_25_COLOR_DEPTHS, "10bit", { label: "Color Depth" }),
-      ...params.videoInput("Source Video", "reference", true, void 0, void 0, SEEDANCE_25_MAX_VIDEO_BYTES),
-      ...params.imageInput(30, "Reference Images")
+      // Every limit rides in `bounds`; the positional maxDuration / maxShortSide
+      // / maxBytes args predate it and are skipped rather than duplicated.
+      ...params.videoInput("Source Video", "reference", true, void 0, void 0, void 0, SEEDANCE_25_VIDEO_BOUNDS),
+      ...params.imageInput(30, "Reference Images", false, "reference", SEEDANCE_IMAGE_BOUNDS)
     }
   },
   {
@@ -4075,7 +4127,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.generateAudio(),
       ...p.enum("outputFormat", SEEDANCE_25_FORMATS, "mp4", { label: "Format" }),
       ...p.enum("colorDepth", SEEDANCE_25_COLOR_DEPTHS, "10bit", { label: "Color Depth" }),
-      ...params.videoInputs(10, "Source Videos", true, { maxBytes: SEEDANCE_25_MAX_VIDEO_BYTES })
+      ...params.videoInputs(10, "Source Videos", true, SEEDANCE_25_VIDEO_BOUNDS)
     }
   },
   {
@@ -4103,7 +4155,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.generateAudio(),
       ...p.enum("outputFormat", SEEDANCE_25_FORMATS, "mp4", { label: "Format" }),
       ...p.enum("colorDepth", SEEDANCE_25_COLOR_DEPTHS, "10bit", { label: "Color Depth" }),
-      ...params.videoInputs(10, "Source Videos", true, { maxBytes: SEEDANCE_25_MAX_VIDEO_BYTES })
+      ...params.videoInputs(10, "Source Videos", true, SEEDANCE_25_VIDEO_BOUNDS)
     }
   },
   {
@@ -4129,14 +4181,11 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.returnLastFrame(),
       // Reference roles map directly to backend `reference_*` content entries.
       // start/end frame stay on their own named slots.
-      ...params.imageInput(9, "Reference Images", false, "reference", { minSidePixels: SEEDANCE_MIN_SIDE_PIXELS }),
-      ...params.videoInputs(3, "Reference Videos", false, {
-        minPixels: SEEDANCE_VIDEO_MIN_PIXELS,
-        minSidePixels: SEEDANCE_MIN_SIDE_PIXELS
-      }),
-      ...params.audioInputs(3, "Reference Audios"),
-      ...params.startFrame(),
-      ...params.endFrame()
+      ...params.imageInput(9, "Reference Images", false, "reference", SEEDANCE_IMAGE_BOUNDS),
+      ...params.videoInputs(3, "Reference Videos", false, SEEDANCE_20_VIDEO_BOUNDS),
+      ...params.audioInputs(3, "Reference Audios", false, SEEDANCE_20_AUDIO_BOUNDS),
+      ...params.startFrame("Start Frame", false, SEEDANCE_FRAME_BOUNDS),
+      ...params.endFrame("End Frame", SEEDANCE_FRAME_BOUNDS)
     }
   },
   {
@@ -4166,14 +4215,11 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.returnLastFrame(),
       // Reference roles map directly to backend `reference_*` content entries.
       // start/end frame stay on their own named slots.
-      ...params.imageInput(9, "Reference Images", false, "reference", { minSidePixels: SEEDANCE_MIN_SIDE_PIXELS }),
-      ...params.videoInputs(3, "Reference Videos", false, {
-        minPixels: SEEDANCE_VIDEO_MIN_PIXELS,
-        minSidePixels: SEEDANCE_MIN_SIDE_PIXELS
-      }),
-      ...params.audioInputs(3, "Reference Audios"),
-      ...params.startFrame(),
-      ...params.endFrame()
+      ...params.imageInput(9, "Reference Images", false, "reference", SEEDANCE_IMAGE_BOUNDS),
+      ...params.videoInputs(3, "Reference Videos", false, SEEDANCE_20_VIDEO_BOUNDS),
+      ...params.audioInputs(3, "Reference Audios", false, SEEDANCE_20_AUDIO_BOUNDS),
+      ...params.startFrame("Start Frame", false, SEEDANCE_FRAME_BOUNDS),
+      ...params.endFrame("End Frame", SEEDANCE_FRAME_BOUNDS)
     }
   },
   {
@@ -4199,14 +4245,11 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.returnLastFrame(),
       // Reference roles map directly to backend `reference_*` content entries.
       // start/end frame stay on their own named slots.
-      ...params.imageInput(9, "Reference Images", false, "reference", { minSidePixels: SEEDANCE_MIN_SIDE_PIXELS }),
-      ...params.videoInputs(3, "Reference Videos", false, {
-        minPixels: SEEDANCE_VIDEO_MIN_PIXELS,
-        minSidePixels: SEEDANCE_MIN_SIDE_PIXELS
-      }),
-      ...params.audioInputs(3, "Reference Audios"),
-      ...params.startFrame(),
-      ...params.endFrame()
+      ...params.imageInput(9, "Reference Images", false, "reference", SEEDANCE_IMAGE_BOUNDS),
+      ...params.videoInputs(3, "Reference Videos", false, SEEDANCE_20_VIDEO_BOUNDS),
+      ...params.audioInputs(3, "Reference Audios", false, SEEDANCE_20_AUDIO_BOUNDS),
+      ...params.startFrame("Start Frame", false, SEEDANCE_FRAME_BOUNDS),
+      ...params.endFrame("End Frame", SEEDANCE_FRAME_BOUNDS)
     }
   },
   {
@@ -4232,14 +4275,11 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.returnLastFrame(),
       // Reference roles map directly to backend `reference_*` content entries.
       // start/end frame stay on their own named slots.
-      ...params.imageInput(9, "Reference Images", false, "reference", { minSidePixels: SEEDANCE_MIN_SIDE_PIXELS }),
-      ...params.videoInputs(3, "Reference Videos", false, {
-        minPixels: SEEDANCE_VIDEO_MIN_PIXELS,
-        minSidePixels: SEEDANCE_MIN_SIDE_PIXELS
-      }),
-      ...params.audioInputs(3, "Reference Audios"),
-      ...params.startFrame(),
-      ...params.endFrame()
+      ...params.imageInput(9, "Reference Images", false, "reference", SEEDANCE_IMAGE_BOUNDS),
+      ...params.videoInputs(3, "Reference Videos", false, SEEDANCE_20_VIDEO_BOUNDS),
+      ...params.audioInputs(3, "Reference Audios", false, SEEDANCE_20_AUDIO_BOUNDS),
+      ...params.startFrame("Start Frame", false, SEEDANCE_FRAME_BOUNDS),
+      ...params.endFrame("End Frame", SEEDANCE_FRAME_BOUNDS)
     }
   },
   {
@@ -4262,8 +4302,10 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.duration(SEEDANCE_V2_DURATIONS, 5),
       ...params.generateAudio(),
       ...params.returnLastFrame(),
-      ...params.videoInput("Source Video"),
-      ...params.imageInput(9, "Reference Images")
+      // Every limit rides in `bounds`; the positional maxDuration / maxShortSide
+      // / maxBytes args predate it and are skipped rather than duplicated.
+      ...params.videoInput("Source Video", "reference", true, void 0, void 0, void 0, SEEDANCE_20_VIDEO_BOUNDS),
+      ...params.imageInput(9, "Reference Images", false, "reference", SEEDANCE_IMAGE_BOUNDS)
     }
   },
   {
@@ -4287,8 +4329,10 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.duration(SEEDANCE_V2_DURATIONS, 5),
       ...params.generateAudio(),
       ...params.returnLastFrame(),
-      ...params.videoInput("Source Video"),
-      ...params.imageInput(9, "Reference Images")
+      // Every limit rides in `bounds`; the positional maxDuration / maxShortSide
+      // / maxBytes args predate it and are skipped rather than duplicated.
+      ...params.videoInput("Source Video", "reference", true, void 0, void 0, void 0, SEEDANCE_20_VIDEO_BOUNDS),
+      ...params.imageInput(9, "Reference Images", false, "reference", SEEDANCE_IMAGE_BOUNDS)
     }
   },
   {
@@ -4311,8 +4355,10 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.duration(SEEDANCE_V2_DURATIONS, 5),
       ...params.generateAudio(),
       ...params.returnLastFrame(),
-      ...params.videoInput("Source Video"),
-      ...params.imageInput(9, "Reference Images")
+      // Every limit rides in `bounds`; the positional maxDuration / maxShortSide
+      // / maxBytes args predate it and are skipped rather than duplicated.
+      ...params.videoInput("Source Video", "reference", true, void 0, void 0, void 0, SEEDANCE_20_VIDEO_BOUNDS),
+      ...params.imageInput(9, "Reference Images", false, "reference", SEEDANCE_IMAGE_BOUNDS)
     }
   },
   {
@@ -4335,8 +4381,10 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.duration(SEEDANCE_V2_DURATIONS, 5),
       ...params.generateAudio(),
       ...params.returnLastFrame(),
-      ...params.videoInput("Source Video"),
-      ...params.imageInput(9, "Reference Images")
+      // Every limit rides in `bounds`; the positional maxDuration / maxShortSide
+      // / maxBytes args predate it and are skipped rather than duplicated.
+      ...params.videoInput("Source Video", "reference", true, void 0, void 0, void 0, SEEDANCE_20_VIDEO_BOUNDS),
+      ...params.imageInput(9, "Reference Images", false, "reference", SEEDANCE_IMAGE_BOUNDS)
     }
   },
   {
@@ -4358,7 +4406,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.resolution(["480p", "720p", "1080p", "4k"], "720p"),
       ...params.duration(SEEDANCE_V2_DURATIONS, 15),
       ...params.generateAudio(),
-      ...params.videoInputs(3, "Source Videos", true)
+      ...params.videoInputs(3, "Source Videos", true, SEEDANCE_20_VIDEO_BOUNDS)
     }
   },
   {
@@ -4381,7 +4429,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.resolution(["480p", "720p", "1080p", "4k"], "720p"),
       ...params.duration(SEEDANCE_V2_DURATIONS, 15),
       ...params.generateAudio(),
-      ...params.videoInputs(3, "Source Videos", true)
+      ...params.videoInputs(3, "Source Videos", true, SEEDANCE_20_VIDEO_BOUNDS)
     }
   },
   {
@@ -4403,7 +4451,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.resolution(["480p", "720p"], "720p"),
       ...params.duration(SEEDANCE_V2_DURATIONS, 15),
       ...params.generateAudio(),
-      ...params.videoInputs(3, "Source Videos", true)
+      ...params.videoInputs(3, "Source Videos", true, SEEDANCE_20_VIDEO_BOUNDS)
     }
   },
   {
@@ -4425,7 +4473,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.resolution(["480p", "720p"], "720p"),
       ...params.duration(SEEDANCE_V2_DURATIONS, 15),
       ...params.generateAudio(),
-      ...params.videoInputs(3, "Source Videos", true)
+      ...params.videoInputs(3, "Source Videos", true, SEEDANCE_20_VIDEO_BOUNDS)
     }
   },
   {
@@ -5441,6 +5489,24 @@ var FLUX_AR_TO_SIZE = {
 };
 var fluxAspectRatios = ["1:1", "16:9", "9:16", "4:3", "3:4", "21:9", "9:21"];
 var fluxResolutions = ["1K", "2K", "4K"];
+var flux3ImageAspectRatios = [
+  "auto",
+  "21:9",
+  "2:1",
+  "16:9",
+  "3:2",
+  "7:5",
+  "4:3",
+  "5:4",
+  "1:1",
+  "4:5",
+  "3:4",
+  "5:7",
+  "2:3",
+  "9:16",
+  "1:2"
+];
+var flux3ImageResolutions = ["512sq", "768sq", "1k", "2k", "4k"];
 var buildFluxV2Payload = (modelId) => (ctx) => ({
   prompt: ctx.prompt,
   model: modelId,
@@ -5584,6 +5650,44 @@ var { MODELS: MODELS20 } = defineModels("flux", [
       ...params.imageInput(1, "Source Image")
     }
   },
+  {
+    // Pure pass-through: every Command field already carries the SDK's own
+    // unified name (prompt, imageUrls, aspectRatio, resolution, count,
+    // safetyTolerance), so no payload builder is needed. Like the flux-2
+    // entries this is one workflow for both directions — supplying imageUrls
+    // switches the vendor into editing mode — hence inputType 't2i'.
+    //
+    // The Command's `version` field pins the endpoint contract version
+    // ('latest' today; the vendor will add dated release tags). It selects a
+    // contract rather than shaping a generation, so it is not surfaced as a
+    // param; the vendor default applies.
+    id: "flux-3-image",
+    name: "Flux 3 Image",
+    workflow: "bfl/v1/flux-3-image",
+    mode: "image",
+    inputType: "t2i",
+    // Early-access at the vendor — stage only until it is cleared for prod.
+    release: "preview",
+    addedAt: "2026-09-22",
+    estimatedTime: 75,
+    description: "Generate and edit images with up to 10 references \u2014 multi-reference composition, precise local edits and text rendering, natively up to 4K.",
+    features: [
+      feat("Multi-Image Input", "input"),
+      feat("4K", "resolution")
+    ],
+    paramConfig: {
+      ...params.prompt(),
+      ...params.aspectRatio(flux3ImageAspectRatios, "auto"),
+      ...params.resolution(flux3ImageResolutions, "1k"),
+      ...params.count(),
+      // Up to 10 references; the first one drives the output ratio while
+      // aspectRatio is 'auto'.
+      ...params.imageInput(10, "Reference Images", false, "reference"),
+      // Moderation level: 0 (strict) … 4 (permissive). Narrower than the 0–6
+      // of the FLUX.2 / Kontext endpoints.
+      ...p.range("safetyTolerance", 0, 4, 2, { label: "Safety Tolerance" })
+    }
+  },
   {
     // Single workflow `flux/v1/video` derives its mode from the input it's
     // given: none → t2v, keyframe images → i2v, a start video → v2v. No
@@ -12013,6 +12117,7 @@ var ElevenlabsSfx = "elevenlabs-sfx";
 var Flux2Flex = "flux-2-flex";
 var Flux2Max = "flux-2-max";
 var Flux2Pro = "flux-2-pro";
+var Flux3Image = "flux-3-image";
 var Flux3Video = "flux-3-video";
 var FluxKontextMax = "flux-kontext-max";
 var FluxKontextPro = "flux-kontext-pro";
@@ -12252,6 +12357,7 @@ var Models = {
   Flux2Flex,
   Flux2Max,
   Flux2Pro,
+  Flux3Image,
   Flux3Video,
   FluxKontextMax,
   FluxKontextPro,

package/package.json

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