@picsart/ai-sdk 5.23.0 → 5.24.1

package/index.d.ts

@@ -822,6 +822,18 @@ type ModelInputById = {
         bitrate?: 32000 | 64000 | 128000 | 256000;
         format?: "mp3" | "wav" | "pcm";
     };
+    "muse-image-1.0": {
+        prompt: string;
+        aspectRatio?: "1:1" | "3:2" | "2:3" | "16:9" | "9:16" | "4:3" | "3:4";
+        reasoningStrength?: "low" | "high";
+        moderation?: "auto" | "low" | "none";
+        enableImageSearch?: boolean;
+        enableWebSearch?: boolean;
+        enableShell?: boolean;
+        outputFormat?: "png" | "jpeg" | "webp";
+        count?: 1 | 2 | 4 | 6 | 8 | 10;
+        imageUrls?: string[];
+    };
     "ovi": {
         prompt: string;
         size?: "9:16" | "16:9" | "1:1" | "9:16+" | "16:9+" | "2:5" | "5:2";
@@ -1828,6 +1840,15 @@ interface FileDescriptor {
      * backend worker stays the authoritative gate. Omit for no client-side floor.
      */
     minPixels?: number;
+    /**
+     * Min intrinsic short-side length (pixels) accepted for an image/video file —
+     * `min(width, height)` must be at least this. Most vendors specify input limits
+     * per side rather than by total pixel count (e.g. Seedance reference images:
+     * width and height each in [300, 6000]). 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.
+     */
+    minSidePixels?: 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
@@ -2017,7 +2038,7 @@ interface ModelFilter$1 {
     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';
+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';
 /** Provider used by model definitions. */
 type Provider = AppProvider;
 /** App generation modes. */
@@ -2622,6 +2643,7 @@ declare const Models: {
     readonly MinimaxH3Max: "minimax-h3-max";
     readonly MinimaxMusicV2: "minimax-music-v2";
     readonly MinimaxMusicV3: "minimax-music-v3";
+    readonly MuseImage10: "muse-image-1.0";
     readonly Ovi: "ovi";
     readonly PicsartChangeBg: "picsart-change-bg";
     readonly PicsartEnhance: "picsart-enhance";

package/index.js

@@ -821,7 +821,8 @@ var providers = {
   pixverse: { color: "#7C3AED", label: "PV", name: "PixVerse" },
   anthropic: { color: "#D97757", label: "CL", name: "Anthropic" },
   async: { color: "#5E5CE6", label: "AA", name: "Async AI" },
-  captionsai: { color: "#1D1F20", label: "MR", name: "Mirage" }
+  captionsai: { color: "#1D1F20", label: "MR", name: "Mirage" },
+  meta: { color: "#0081FB", label: "MT", name: "Meta" }
 };
 
 // src/core/descriptors/presets.ts
@@ -1019,6 +1020,7 @@ var p = {
           ...opts?.array ? { array: opts.array } : {},
           ...opts?.maxDurationSec != null ? { maxDurationSec: opts.maxDurationSec } : {},
           ...opts?.minPixels != null ? { minPixels: opts.minPixels } : {},
+          ...opts?.minSidePixels != null ? { minSidePixels: opts.minSidePixels } : {},
           ...opts?.maxShortSidePixels != null ? { maxShortSidePixels: opts.maxShortSidePixels } : {},
           ...opts?.maxBytes != null ? { maxBytes: opts.maxBytes } : {}
         }
@@ -1176,7 +1178,7 @@ var passthroughPayload = (paramConfig) => (ctx) => {
   return payload;
 };
 function defineModels(provider, configs) {
-  const MODELS38 = [];
+  const MODELS39 = [];
   for (const c of configs) {
     const prov = c.provider ?? provider;
     const resolvedPayload = c.buildPayload ?? passthroughPayload(c.paramConfig);
@@ -1212,19 +1214,19 @@ function defineModels(provider, configs) {
     if (c.constraints !== void 0) model.constraints = c.constraints;
     const contract = createModelContract(model);
     model.outputSchema = c.outputSchema ?? contract.output;
-    MODELS38.push(model);
+    MODELS39.push(model);
   }
-  return { MODELS: MODELS38 };
+  return { MODELS: MODELS39 };
 }
-function registerPayloads(MODELS38, payloads) {
+function registerPayloads(MODELS39, payloads) {
   for (const [id, builder] of Object.entries(payloads)) {
-    const model = MODELS38.find((m) => m.id === id);
+    const model = MODELS39.find((m) => m.id === id);
     if (model) model.buildPayload = builder;
   }
 }
-function registerEditPayloads(MODELS38, payloads) {
+function registerEditPayloads(MODELS39, payloads) {
   for (const [id, builder] of Object.entries(payloads)) {
-    const model = MODELS38.find((m) => m.id === id);
+    const model = MODELS39.find((m) => m.id === id);
     if (model) model.buildEditPayload = builder;
   }
 }
@@ -1252,7 +1254,18 @@ 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)
-  imageInput: (max = 1, label = "Start Image", required = false, category = "reference", minPixels) => p.file("imageUrls", "image", { array: { max }, label, required, category, ...minPixels != null ? { minPixels } : {} }),
+  /** 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 } : {}
+  }),
   /** 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,
@@ -1268,15 +1281,17 @@ var params = {
   /** 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). `maxBytes` caps
-   *  each individual clip's file size, enforced client-side at upload. */
-  videoInputs: (max = 3, label = "Reference Videos", required = false, minPixels, maxBytes) => p.file("videoUrls", "video", {
+   *  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",
-    ...minPixels != null ? { minPixels } : {},
-    ...maxBytes != null ? { maxBytes } : {}
+    ...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. */
@@ -3541,7 +3556,8 @@ 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_PIXELS = 409600;
+var SEEDANCE_MIN_SIDE_PIXELS = 300;
+var SEEDANCE_VIDEO_MIN_PIXELS = 407696;
 var SEEDANCE_25_MAX_VIDEO_BYTES = 209715200;
 var seedance20Constraints = [
   {
@@ -3792,8 +3808,12 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.returnLastFrame(),
       ...p.enum("outputFormat", ["mp4", "mov"], "mp4", { label: "Format" }),
       // 2.5 lifts the reference caps to 30 images / 10 videos / 10 audios.
-      ...params.imageInput(30, "Reference Images", false, "reference", SEEDANCE_MIN_PIXELS),
-      ...params.videoInputs(10, "Reference Videos", false, SEEDANCE_MIN_PIXELS, SEEDANCE_25_MAX_VIDEO_BYTES),
+      ...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()
@@ -3847,7 +3867,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.durationRange(SEEDANCE_25_DURATION.min, SEEDANCE_25_DURATION.max, 15),
       ...params.generateAudio(),
       ...p.enum("outputFormat", ["mp4", "mov"], "mp4", { label: "Format" }),
-      ...params.videoInputs(10, "Source Videos", true, void 0, SEEDANCE_25_MAX_VIDEO_BYTES)
+      ...params.videoInputs(10, "Source Videos", true, { maxBytes: SEEDANCE_25_MAX_VIDEO_BYTES })
     }
   },
   {
@@ -3873,8 +3893,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", SEEDANCE_MIN_PIXELS),
-      ...params.videoInputs(3, "Reference Videos", false, SEEDANCE_MIN_PIXELS),
+      ...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()
@@ -3907,8 +3930,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", SEEDANCE_MIN_PIXELS),
-      ...params.videoInputs(3, "Reference Videos", false, SEEDANCE_MIN_PIXELS),
+      ...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()
@@ -3937,8 +3963,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", SEEDANCE_MIN_PIXELS),
-      ...params.videoInputs(3, "Reference Videos", false, SEEDANCE_MIN_PIXELS),
+      ...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()
@@ -3967,8 +3996,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", SEEDANCE_MIN_PIXELS),
-      ...params.videoInputs(3, "Reference Videos", false, SEEDANCE_MIN_PIXELS),
+      ...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()
@@ -8530,6 +8562,74 @@ registerPayloads(MODELS37, {
   "captionsai-video-captions": buildCaptionsPayload
 });
 
+// src/vendors/catalog/meta.ts
+var { MODELS: MODELS38 } = defineModels("meta", [
+  // ── Image ─────────────────────────────────────────
+  {
+    id: "muse-image-1.0",
+    name: "Muse Image 1.0",
+    addedAt: "2026-08-31",
+    workflow: "meta/v1/images/generations",
+    editWorkflow: "meta/v1/images/edits",
+    estimatedTime: 60,
+    mode: "image",
+    inputType: "t2i",
+    description: "Meta's agentic image model \u2014 plans with reasoning, web and image search before rendering.",
+    features: [feat("Multi-Image Input", "input"), feat("Web Search", "characteristic"), feat("High Quality", "quality")],
+    paramConfig: {
+      ...params.prompt(),
+      ...params.aspectRatio(["1:1", "3:2", "2:3", "16:9", "9:16", "4:3", "3:4"], "1:1"),
+      // Vendor-side reasoning tier for the agentic planner; vendor default high.
+      ...p.enum("reasoningStrength", ["low", "high"], "high", { label: "Reasoning" }),
+      ...p.enum("moderation", ["auto", "low", "none"], "auto", { label: "Moderation" }),
+      // Per-tool planner controls — all-true matches the vendor default
+      // (omitting tool_enablement enables every tool).
+      ...p.boolean("enableImageSearch", true, "Image Search"),
+      ...p.boolean("enableWebSearch", true, "Web Search"),
+      ...p.boolean("enableShell", true, "Layout & Chart Tools"),
+      ...p.enum("outputFormat", ["png", "jpeg", "webp"], "png", { label: "Format" }),
+      ...params.count(),
+      ...params.imageInput(5, "Source Images")
+    }
+  }
+]);
+
+// src/vendors/catalog/meta.payloads.ts
+var MUSE_AR_TO_SIZE = {
+  "1:1": "1024x1024",
+  "3:2": "1536x1024",
+  "2:3": "1024x1536",
+  "16:9": "1820x1024",
+  "9:16": "1024x1820",
+  "4:3": "1365x1024",
+  "3:4": "1024x1365"
+};
+var buildMuseCommonPayload = (input) => ({
+  model: "muse-image-1.0",
+  prompt: input.prompt,
+  n: input.count ?? 1,
+  size: MUSE_AR_TO_SIZE[input.aspectRatio ?? ""] ?? "1024x1024",
+  ...input.outputFormat ? { output_format: input.outputFormat } : {},
+  ...input.reasoningStrength ? { reasoning_strength: input.reasoningStrength } : {},
+  ...input.moderation ? { moderation: input.moderation } : {},
+  tool_enablement: {
+    enable_image_search: input.enableImageSearch ?? true,
+    enable_web_search: input.enableWebSearch ?? true,
+    enable_shell: input.enableShell ?? true
+  }
+});
+var buildMuseImagePayload = (input) => buildMuseCommonPayload(input);
+var buildMuseImageEditPayload = (input) => ({
+  ...buildMuseCommonPayload(input),
+  images: input.imageUrls ?? []
+});
+registerPayloads(MODELS38, {
+  "muse-image-1.0": buildMuseImagePayload
+});
+registerEditPayloads(MODELS38, {
+  "muse-image-1.0": buildMuseImageEditPayload
+});
+
 // src/vendors/catalog/index.ts
 var ALL_MODELS = [
   ...MODELS,
@@ -8568,7 +8668,8 @@ var ALL_MODELS = [
   ...MODELS34,
   ...MODELS35,
   ...MODELS36,
-  ...MODELS37
+  ...MODELS37,
+  ...MODELS38
 ];
 var getModelsByMode = (mode, includeDisabled = false) => ALL_MODELS.filter((m) => m.mode === mode && (includeDisabled || isVisibleForReleases(m)));
 
@@ -10764,6 +10865,7 @@ var MinimaxH3 = "minimax-h3";
 var MinimaxH3Max = "minimax-h3-max";
 var MinimaxMusicV2 = "minimax-music-v2";
 var MinimaxMusicV3 = "minimax-music-v3";
+var MuseImage10 = "muse-image-1.0";
 var Ovi = "ovi";
 var PicsartChangeBg = "picsart-change-bg";
 var PicsartEnhance = "picsart-enhance";
@@ -10976,6 +11078,7 @@ var Models = {
   MinimaxH3Max,
   MinimaxMusicV2,
   MinimaxMusicV3,
+  MuseImage10,
   Ovi,
   PicsartChangeBg,
   PicsartEnhance,

package/package.json

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