@picsart/ai-sdk 6.4.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";
@@ -960,6 +968,14 @@ type ModelInputById = {
         seed?: number;
         enableSafetyChecker?: boolean;
     };
+    "minimax-h3-max-lip-sync": {
+        startFrame: string;
+        audioUrl: string;
+        resolution?: "480p" | "768p" | "1080p" | "2k";
+        enableTranscription?: boolean;
+        seed?: number;
+        enableSafetyChecker?: boolean;
+    };
     "minimax-h3-max-turbo": {
         prompt: string;
         startFrame?: string;
@@ -2921,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";
@@ -3021,6 +3038,7 @@ declare const Models: {
     readonly MinimaxH3: "minimax-h3";
     readonly MinimaxH3Max: "minimax-h3-max";
     readonly MinimaxH3MaxCameraControls: "minimax-h3-max-camera-controls";
+    readonly MinimaxH3MaxLipSync: "minimax-h3-max-lip-sync";
     readonly MinimaxH3MaxTurbo: "minimax-h3-max-turbo";
     readonly MinimaxMusicV2: "minimax-music-v2";
     readonly MinimaxMusicV3: "minimax-music-v3";

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
@@ -6851,6 +6907,41 @@ var { MODELS: MODELS25 } = defineModels("minimax", [
       ...p.range("seed", -1, 2147483647, -1),
       ...p.boolean("enableSafetyChecker", true, "Safety Checker")
     }
+  },
+  {
+    // Lip-sync sibling of minimax-h3-max: animates a portrait to a supplied
+    // soundtrack. No prompt and no duration on this wire — the audio drives
+    // both: the vendor requires at least 5s, clips anything past 14.8s, and
+    // the output matches the clipped track. The output follows the image, so
+    // there is no aspect ratio either.
+    id: "minimax-h3-max-lip-sync",
+    name: "MiniMax H3 Max Lip Sync",
+    modelId: "fal-ai-h3-max-lip-sync",
+    addedAt: "2026-09-22",
+    workflow: "minimax/h3-max/lip-sync/image-to-video",
+    estimatedTime: 120,
+    mode: "video",
+    inputType: "i2v",
+    description: "MiniMax H3 Max lip-synced video from a portrait and an audio track \u2014 mouth movements follow the soundtrack, optionally guided by a transcript. 5-14.8s of audio, up to 2K.",
+    features: [
+      feat("Lip Sync", "characteristic"),
+      feat("Image Input", "input"),
+      feat("Audio Input", "audio"),
+      feat("2K", "resolution"),
+      feat("5-15 sec", "duration")
+    ],
+    paramConfig: {
+      ...params.startFrame("Portrait Image", true),
+      ...params.audioInput("Audio Track", true),
+      // Unlike the siblings this one also offers 2K; 1080p and 2K are latent
+      // refinements of a native 768p generation.
+      ...params.resolution(["480p", "768p", "1080p", "2k"], "768p"),
+      // Transcribes the audio to guide the sync; off follows the waveform alone.
+      ...p.boolean("enableTranscription", false, "Transcription"),
+      // -1 (sentinel) means "pick a random seed"; the builder drops it.
+      ...p.range("seed", -1, 2147483647, -1),
+      ...p.boolean("enableSafetyChecker", true, "Safety Checker")
+    }
   }
 ]);
 
@@ -6924,11 +7015,22 @@ var buildMinimaxH3MaxCameraControlsPayload = (input) => ({
   ...input.seed != null && input.seed !== -1 ? { seed: input.seed } : {},
   enable_safety_checker: input.enableSafetyChecker ?? true
 });
+var buildMinimaxH3MaxLipSyncPayload = (input) => ({
+  image_url: input.startFrame,
+  audio_url: input.audioUrl,
+  // The vendor enum is uppercase; paramConfig keeps the lowercase form.
+  resolution: (input.resolution ?? "768p").toUpperCase(),
+  enable_transcription: input.enableTranscription ?? false,
+  // -1 is the paramConfig sentinel for "random seed" — omit it on the wire.
+  ...input.seed != null && input.seed !== -1 ? { seed: input.seed } : {},
+  enable_safety_checker: input.enableSafetyChecker ?? true
+});
 registerPayloads(MODELS25, {
   "minimax-music-v3": buildMinimaxMusicV3Payload,
   "minimax-h3-max": buildMinimaxH3MaxPayload,
   "minimax-h3-max-turbo": buildMinimaxH3MaxTurboPayload,
-  "minimax-h3-max-camera-controls": buildMinimaxH3MaxCameraControlsPayload
+  "minimax-h3-max-camera-controls": buildMinimaxH3MaxCameraControlsPayload,
+  "minimax-h3-max-lip-sync": buildMinimaxH3MaxLipSyncPayload
 });
 registerEditPayloads(MODELS25, {
   "minimax-h3-max-turbo": buildMinimaxH3MaxTurboPayload
@@ -11967,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";
@@ -12067,6 +12170,7 @@ var Lyria35 = "lyria-3.5";
 var MinimaxH3 = "minimax-h3";
 var MinimaxH3Max = "minimax-h3-max";
 var MinimaxH3MaxCameraControls = "minimax-h3-max-camera-controls";
+var MinimaxH3MaxLipSync = "minimax-h3-max-lip-sync";
 var MinimaxH3MaxTurbo = "minimax-h3-max-turbo";
 var MinimaxMusicV2 = "minimax-music-v2";
 var MinimaxMusicV3 = "minimax-music-v3";
@@ -12205,6 +12309,7 @@ var Models = {
   Flux2Flex,
   Flux2Max,
   Flux2Pro,
+  Flux3Image,
   Flux3Video,
   FluxKontextMax,
   FluxKontextPro,
@@ -12305,6 +12410,7 @@ var Models = {
   MinimaxH3,
   MinimaxH3Max,
   MinimaxH3MaxCameraControls,
+  MinimaxH3MaxLipSync,
   MinimaxH3MaxTurbo,
   MinimaxMusicV2,
   MinimaxMusicV3,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@picsart/ai-sdk",
-  "version": "6.4.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",