@picsart/ai-sdk 6.5.0 → 6.6.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";
@@ -2929,6 +2937,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

@@ -5441,6 +5441,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 +5602,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 +12069,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 +12309,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.6.0",
   "type": "module",
   "description": "Type-safe SDK for 100+ AI models — image, video, audio, and text generation with Picsart",
   "license": "MIT",