@picsart/ai-sdk 6.42.0 → 6.44.0

package/index.d.ts

@@ -359,6 +359,15 @@ type ModelInputById = {
         imageUrls?: string[];
         safetyTolerance?: number;
     };
+    "flux-3-image-klein": {
+        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" | "9:21" | "1:2";
+        resolution?: "768sq" | "1k" | "1.5k" | "2k" | "4k";
+        count?: 1 | 2 | 4 | 6 | 8 | 10;
+        imageUrls?: string[];
+        steps?: number;
+        safetyTolerance?: number;
+    };
     "flux-3-video": {
         prompt: string;
         aspectRatio?: "auto" | "21:9" | "2:1" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16";
@@ -1297,6 +1306,35 @@ type ModelInputById = {
         bitrate?: 32000 | 64000 | 128000 | 256000;
         format?: "mp3" | "wav" | "pcm";
     };
+    "mirelo-sfx-2.0-text-to-audio": {
+        prompt: string;
+        negativePrompt?: string;
+        duration?: number;
+        count?: 1 | 2 | 3 | 4;
+        format?: "wav" | "mp3" | "aac" | "flac";
+        bitrateKbps?: number;
+        seed?: number;
+    };
+    "mirelo-sfx-2.0-video-to-audio": {
+        videoUrl: string;
+        prompt?: string;
+        negativePrompt?: string;
+        preserveSpeech?: boolean;
+        duration?: number;
+        count?: 1 | 2 | 3 | 4;
+        format?: "wav" | "mp3" | "aac" | "flac";
+        bitrateKbps?: number;
+        seed?: number;
+    };
+    "mirelo-sfx-2.0-video-to-video": {
+        videoUrl: string;
+        prompt?: string;
+        negativePrompt?: string;
+        preserveSpeech?: boolean;
+        duration?: number;
+        count?: 1 | 2 | 3 | 4;
+        seed?: number;
+    };
     "muse-image-1.0": {
         prompt: string;
         aspectRatio?: "1:1" | "3:2" | "2:3" | "16:9" | "9:16" | "4:3" | "3:4";
@@ -2532,7 +2570,7 @@ interface ModelFilter {
     release?: ReleaseTag[];
 }
 
-type AppProvider = 'picsart' | 'google' | 'kling' | 'grok' | 'openai' | 'flux' | 'ideogram' | 'elevenlabs' | 'minimax' | 'wan' | 'seedance' | 'ltx' | 'seedream' | 'seedaudio' | 'hunyuan' | 'pika' | 'runway' | 'luma' | 'ovi' | 'creatify' | 'veed' | 'bytedance' | 'qwen' | 'reve' | 'recraft' | 'videography' | 'topaz' | 'heygen' | 'happyhorse' | 'pixverse' | 'anthropic' | 'async' | 'captionsai' | 'meta' | 'typesafe' | 'depth-anything' | 'kimi';
+type AppProvider = 'picsart' | 'google' | 'kling' | 'grok' | 'openai' | 'flux' | 'ideogram' | 'elevenlabs' | 'minimax' | 'wan' | 'seedance' | 'ltx' | 'seedream' | 'seedaudio' | 'hunyuan' | 'pika' | 'runway' | 'luma' | 'ovi' | 'creatify' | 'veed' | 'bytedance' | 'qwen' | 'reve' | 'recraft' | 'videography' | 'topaz' | 'heygen' | 'happyhorse' | 'pixverse' | 'anthropic' | 'async' | 'captionsai' | 'meta' | 'typesafe' | 'depth-anything' | 'kimi' | 'mirelo';
 /** Provider used by model definitions. */
 type Provider = AppProvider;
 /** App generation modes. `json` marks structured-output models (judges,
@@ -3534,6 +3572,7 @@ declare const Models: {
     readonly Flux2Max: "flux-2-max";
     readonly Flux2Pro: "flux-2-pro";
     readonly Flux3Image: "flux-3-image";
+    readonly Flux3ImageKlein: "flux-3-image-klein";
     readonly Flux3Video: "flux-3-video";
     readonly FluxKontextMax: "flux-kontext-max";
     readonly FluxKontextPro: "flux-kontext-pro";
@@ -3654,6 +3693,9 @@ declare const Models: {
     readonly MinimaxH3MaxTurbo: "minimax-h3-max-turbo";
     readonly MinimaxMusicV2: "minimax-music-v2";
     readonly MinimaxMusicV3: "minimax-music-v3";
+    readonly MireloSfx20TextToAudio: "mirelo-sfx-2.0-text-to-audio";
+    readonly MireloSfx20VideoToAudio: "mirelo-sfx-2.0-video-to-audio";
+    readonly MireloSfx20VideoToVideo: "mirelo-sfx-2.0-video-to-video";
     readonly MuseImage10: "muse-image-1.0";
     readonly Ovi: "ovi";
     readonly PicsartChangeBg: "picsart-change-bg";

package/index.js

@@ -798,7 +798,8 @@ var providers = {
   meta: { color: "#0081FB", label: "MT", name: "Meta" },
   typesafe: { color: "#3E6B8F", label: "TS", name: "TypeSafe" },
   "depth-anything": { color: "#0EA5E9", label: "DA", name: "Depth Anything" },
-  kimi: { color: "#1A1A2E", label: "KM", name: "Kimi" }
+  kimi: { color: "#1A1A2E", label: "KM", name: "Kimi" },
+  mirelo: { color: "#5C3DF5", label: "ML", name: "Mirelo" }
 };
 
 // src/core/descriptors/presets.ts
@@ -1176,7 +1177,7 @@ var passthroughPayload = (paramConfig) => (ctx) => {
   return payload;
 };
 function defineModels(provider, configs) {
-  const MODELS40 = [];
+  const MODELS41 = [];
   for (const c of configs) {
     const prov = c.provider ?? provider;
     const resolvedPayload = c.buildPayload ?? passthroughPayload(c.paramConfig);
@@ -1213,19 +1214,19 @@ function defineModels(provider, configs) {
     if (c.validateInput !== void 0) model.validateInput = c.validateInput;
     const contract = createModelContract(model);
     model.outputSchema = c.outputSchema ?? contract.output;
-    MODELS40.push(model);
+    MODELS41.push(model);
   }
-  return { MODELS: MODELS40 };
+  return { MODELS: MODELS41 };
 }
-function registerPayloads(MODELS40, payloads) {
+function registerPayloads(MODELS41, payloads) {
   for (const [id, builder] of Object.entries(payloads)) {
-    const model = MODELS40.find((m) => m.id === id);
+    const model = MODELS41.find((m) => m.id === id);
     if (model) model.buildPayload = builder;
   }
 }
-function registerEditPayloads(MODELS40, payloads) {
+function registerEditPayloads(MODELS41, payloads) {
   for (const [id, builder] of Object.entries(payloads)) {
-    const model = MODELS40.find((m) => m.id === id);
+    const model = MODELS41.find((m) => m.id === id);
     if (model) model.buildEditPayload = builder;
   }
 }
@@ -6528,6 +6529,49 @@ var { MODELS: MODELS21 } = defineModels("flux", [
       ...p.range("safetyTolerance", 0, 4, 2, { label: "Safety Tolerance" })
     }
   },
+  {
+    // Distilled "Klein" tier of FLUX 3 Image. Same contract as flux-3-image —
+    // a pure pass-through, since every Command field already carries the SDK's
+    // unified name (prompt, imageUrls, aspectRatio, resolution, count,
+    // safetyTolerance) — with two deltas: a `steps` knob (1–16 denoising steps
+    // for the distilled model; fewer is faster and it does not affect cost) and
+    // a wider safetyTolerance range (0–7 vs the 0–4 of flux-3-image). As with
+    // flux-3-image, supplying imageUrls switches the vendor into editing mode
+    // (hence inputType 't2i'), `version` pins the endpoint contract and is not
+    // surfaced, and `options` is dropped.
+    id: "flux-3-image-klein",
+    name: "Flux 3 Image Klein",
+    workflow: "bfl/v1/flux-3-image-klein",
+    mode: "image",
+    inputType: "t2i",
+    addedAt: "2026-10-16",
+    badge: ["fast"],
+    // Klein is the distilled/low-step tier, so it generates faster than
+    // flux-3-image. Reuse that model's per-tier map as a safe upper bound —
+    // over-estimating only finishes the bar early; tighten once stage
+    // measurements land.
+    estimatedTime: { "768sq": 110, "1k": 150, "1.5k": 195, "2k": 240, "4k": 360 },
+    description: "Distilled, faster FLUX 3 Image \u2014 generate and edit with up to 10 references, with a steps control to trade speed for detail, 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"),
+      // Denoising steps for the distilled Klein model: 1 (fastest) … 16.
+      // Vendor default is 16; does not affect cost (priced per resolution tier).
+      ...p.range("steps", 1, 16, 16, { label: "Steps" }),
+      // Moderation level: 0 (strict) … 7 (permissive). Wider than the 0–4 of
+      // flux-3-image.
+      ...p.range("safetyTolerance", 0, 7, 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
@@ -6570,13 +6614,13 @@ var { MODELS: MODELS21 } = defineModels("flux", [
     // payload builder needed. webhookUrl is polling plumbing, not surfaced
     // (same as flux-3-video).
     id: "flux-video-upscale",
-    name: "Flux Video Upscale",
+    name: "Flux 3 Video Upscale",
     workflow: "flux/v1/video-upscale",
     mode: "video",
     inputType: "v2v",
     addedAt: "2026-08-28",
     estimatedTime: 180,
-    description: "Upscale videos toward 4K (1.5x\u20133x) in precise (source-faithful) or creative (detail-enhancing) mode. Source clips up to 20 seconds and 2K.",
+    description: "FLUX 3 powered video upscale toward 4K (1.5x\u20133x) in precise (source-faithful) or creative (detail-enhancing) mode. Source clips up to 20 seconds and 2K.",
     features: [
       feat("Upscale", "quality"),
       feat("Video Required", "input"),
@@ -11247,6 +11291,116 @@ registerPayloads(MODELS39, {
   "depth-anything-video": buildDepthAnythingVideoPayload
 });
 
+// src/vendors/catalog/mirelo.ts
+var FORMAT_OPTIONS = ["wav", "mp3", "aac", "flac"];
+var SAMPLE_OPTIONS = [1, 2, 3, 4];
+var bitrateKbps = {
+  bitrateKbps: {
+    label: "Audio Bitrate (kbps)",
+    descriptor: { kind: "range", min: 32, max: 320, step: 1 }
+  }
+};
+var { MODELS: MODELS40 } = defineModels("mirelo", [
+  {
+    id: "mirelo-sfx-2.0-text-to-audio",
+    name: "Mirelo SFX 2.0 (Text to Audio)",
+    addedAt: "2026-10-15",
+    workflow: "mirelo-ai/sfx2.0/text-to-audio",
+    estimatedTime: 15,
+    mode: "audio",
+    inputType: "t2a",
+    description: "Generate sound effects and soundscapes from a text prompt with Mirelo SFX 2.0.",
+    features: [feat("Text to Audio", "characteristic"), feat("Sound Effects", "audio")],
+    paramConfig: {
+      ...params.prompt({ maxLength: 2e3 }),
+      ...params.negativePrompt(void 0, 1e3),
+      ...params.durationRange(1, 600, 30),
+      ...params.count(SAMPLE_OPTIONS, 2),
+      ...p.enum("format", [...FORMAT_OPTIONS], "wav", { label: "Format" }),
+      ...bitrateKbps,
+      ...params.seed()
+    }
+  },
+  {
+    id: "mirelo-sfx-2.0-video-to-audio",
+    name: "Mirelo SFX 2.0 (Video to Audio)",
+    addedAt: "2026-10-15",
+    workflow: "mirelo-ai/sfx2.0/video-to-audio",
+    estimatedTime: 20,
+    mode: "audio",
+    inputType: "v2a",
+    description: "Generate a soundtrack synced to your video with Mirelo SFX 2.0 \u2014 returns the audio track.",
+    features: [feat("Video to Audio", "characteristic"), feat("Video Required", "input"), feat("Sound Effects", "audio")],
+    paramConfig: {
+      ...params.videoInput("Source Video", "asset", true),
+      ...params.prompt({ required: false, maxLength: 2e3 }),
+      ...params.negativePrompt(void 0, 1e3),
+      ...p.boolean("preserveSpeech", true, "Preserve Speech"),
+      ...params.durationRange(1, 600, 10),
+      ...params.count(SAMPLE_OPTIONS, 2),
+      ...p.enum("format", [...FORMAT_OPTIONS], "wav", { label: "Format" }),
+      ...bitrateKbps,
+      ...params.seed()
+    }
+  },
+  {
+    id: "mirelo-sfx-2.0-video-to-video",
+    name: "Mirelo SFX 2.0 (Video to Video)",
+    addedAt: "2026-10-15",
+    workflow: "mirelo-ai/sfx2.0/video-to-video",
+    estimatedTime: 30,
+    mode: "video",
+    inputType: "v2v",
+    description: "Add a synced soundtrack to your video with Mirelo SFX 2.0 \u2014 returns the video with its new audio.",
+    features: [feat("Video to Video", "characteristic"), feat("Video Required", "input"), feat("Synced Soundtrack", "audio")],
+    paramConfig: {
+      ...params.videoInput("Source Video", "asset", true),
+      ...params.prompt({ required: false, maxLength: 2e3 }),
+      ...params.negativePrompt(void 0, 1e3),
+      ...p.boolean("preserveSpeech", true, "Preserve Speech"),
+      ...params.durationRange(1, 600, 10),
+      ...params.count(SAMPLE_OPTIONS, 2),
+      ...params.seed()
+    }
+  }
+]);
+
+// src/vendors/catalog/mirelo.payloads.ts
+var buildTextToAudioPayload = (input) => ({
+  prompt: input.prompt,
+  duration: input.duration ?? 30,
+  num_samples: input.count ?? 2,
+  upload_audio_format: input.format ?? "wav",
+  ...input.negativePrompt != null ? { negative_prompt: input.negativePrompt } : {},
+  ...input.bitrateKbps != null ? { upload_audio_bitrate_kbps: input.bitrateKbps } : {},
+  ...input.seed != null ? { seed: input.seed } : {}
+});
+var buildVideoToAudioPayload = (input) => ({
+  video_url: input.videoUrl,
+  preserve_speech: input.preserveSpeech ?? true,
+  duration: input.duration ?? 10,
+  num_samples: input.count ?? 2,
+  upload_audio_format: input.format ?? "wav",
+  ...input.prompt != null ? { text_prompt: input.prompt } : {},
+  ...input.negativePrompt != null ? { negative_prompt: input.negativePrompt } : {},
+  ...input.bitrateKbps != null ? { upload_audio_bitrate_kbps: input.bitrateKbps } : {},
+  ...input.seed != null ? { seed: input.seed } : {}
+});
+var buildVideoToVideoPayload = (input) => ({
+  video_url: input.videoUrl,
+  preserve_speech: input.preserveSpeech ?? true,
+  duration: input.duration ?? 10,
+  num_samples: input.count ?? 2,
+  ...input.prompt != null ? { text_prompt: input.prompt } : {},
+  ...input.negativePrompt != null ? { negative_prompt: input.negativePrompt } : {},
+  ...input.seed != null ? { seed: input.seed } : {}
+});
+registerPayloads(MODELS40, {
+  "mirelo-sfx-2.0-text-to-audio": buildTextToAudioPayload,
+  "mirelo-sfx-2.0-video-to-audio": buildVideoToAudioPayload,
+  "mirelo-sfx-2.0-video-to-video": buildVideoToVideoPayload
+});
+
 // src/vendors/catalog/creatify.payloads.ts
 var buildCreatifyBorealPayload = (input) => ({
   prompt: input.prompt,
@@ -11412,7 +11566,8 @@ var ALL_MODELS = [
   ...MODELS36,
   ...MODELS37,
   ...MODELS38,
-  ...MODELS39
+  ...MODELS39,
+  ...MODELS40
 ];
 var getModelsByMode = (mode, includeHidden = false) => ALL_MODELS.filter((m) => m.mode === mode && (includeHidden || isVisibleForReleases(m)));
 
@@ -14977,6 +15132,7 @@ var Flux2Flex = "flux-2-flex";
 var Flux2Max = "flux-2-max";
 var Flux2Pro = "flux-2-pro";
 var Flux3Image = "flux-3-image";
+var Flux3ImageKlein = "flux-3-image-klein";
 var Flux3Video = "flux-3-video";
 var FluxKontextMax = "flux-kontext-max";
 var FluxKontextPro = "flux-kontext-pro";
@@ -15097,6 +15253,9 @@ var MinimaxH3MaxRelight = "minimax-h3-max-relight";
 var MinimaxH3MaxTurbo = "minimax-h3-max-turbo";
 var MinimaxMusicV2 = "minimax-music-v2";
 var MinimaxMusicV3 = "minimax-music-v3";
+var MireloSfx20TextToAudio = "mirelo-sfx-2.0-text-to-audio";
+var MireloSfx20VideoToAudio = "mirelo-sfx-2.0-video-to-audio";
+var MireloSfx20VideoToVideo = "mirelo-sfx-2.0-video-to-video";
 var MuseImage10 = "muse-image-1.0";
 var Ovi = "ovi";
 var PicsartChangeBg = "picsart-change-bg";
@@ -15244,6 +15403,7 @@ var Models = {
   Flux2Max,
   Flux2Pro,
   Flux3Image,
+  Flux3ImageKlein,
   Flux3Video,
   FluxKontextMax,
   FluxKontextPro,
@@ -15364,6 +15524,9 @@ var Models = {
   MinimaxH3MaxTurbo,
   MinimaxMusicV2,
   MinimaxMusicV3,
+  MireloSfx20TextToAudio,
+  MireloSfx20VideoToAudio,
+  MireloSfx20VideoToVideo,
   MuseImage10,
   Ovi,
   PicsartChangeBg,

package/package.json

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