@picsart/ai-sdk 5.21.2 → 5.22.1

package/index.d.ts

@@ -791,6 +791,17 @@ type ModelInputById = {
         duration?: 5 | 10 | 15;
         aspectRatio?: "adaptive" | "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16";
     };
+    "minimax-h3-max": {
+        prompt: string;
+        startFrame?: string;
+        endFrame?: string;
+        resolution?: "480p" | "768p";
+        duration?: number;
+        aspectRatio?: "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16";
+        promptExpansionMode?: "disabled" | "balanced" | "quality";
+        seed?: number;
+        enableSafetyChecker?: boolean;
+    };
     "minimax-music-v2": {
         prompt: string;
         lyricsPrompt?: string;
@@ -957,6 +968,17 @@ type ModelInputById = {
         enhancePrompt?: boolean;
         imageUrls?: string[];
         promptExtendMode?: "direct" | "agent";
+        enableThinking?: boolean;
+    };
+    "qwen-image-3.0-pro": {
+        prompt: string;
+        negativePrompt?: string;
+        resolution?: "2048x2048" | "2688x1536" | "1536x2688" | "2368x1728" | "1728x2368";
+        count?: 1 | 2 | 4 | 6;
+        enhancePrompt?: boolean;
+        imageUrls?: string[];
+        promptExtendMode?: "direct" | "agent";
+        enableThinking?: boolean;
     };
     "recraft-creative-upscale": {
         imageUrls: [string, ...string[]];
@@ -2089,8 +2111,10 @@ interface GenerationContext {
     substyle?: string;
     thinkingLevel?: 'minimal' | 'high';
     thinkingBudget?: number;
-    /** Qwen 3.0 — prompt-rewrite strategy (`direct`/`agent`), sent as `prompt_extend_mode`. */
+    /** Qwen 3.0 family — prompt-rewrite strategy (`direct`/`agent`), sent as `prompt_extend_mode`. */
     promptExtendMode?: 'direct' | 'agent';
+    /** Qwen 3.0 family — thinking mode (requires prompt_extend), sent as `enable_thinking`. */
+    enableThinking?: boolean;
 }
 type PayloadBuilder<TContext extends GenerationContext = GenerationContext> = (ctx: TContext) => object;
 /** Lightweight runtime schema contract used by SDK integrations. */
@@ -2590,6 +2614,7 @@ declare const Models: {
     readonly Lyria3Pro: "lyria-3-pro";
     readonly Minimax02Hd: "minimax-02-hd";
     readonly MinimaxH3: "minimax-h3";
+    readonly MinimaxH3Max: "minimax-h3-max";
     readonly MinimaxMusicV2: "minimax-music-v2";
     readonly MinimaxMusicV3: "minimax-music-v3";
     readonly Ovi: "ovi";
@@ -2618,6 +2643,7 @@ declare const Models: {
     readonly QwenImage2: "qwen-image-2";
     readonly QwenImage2Pro: "qwen-image-2-pro";
     readonly QwenImage30: "qwen-image-3.0";
+    readonly QwenImage30Pro: "qwen-image-3.0-pro";
     readonly RecraftCreativeUpscale: "recraft-creative-upscale";
     readonly RecraftCrispUpscale: "recraft-crisp-upscale";
     readonly RecraftExplore: "recraft-explore";

package/index.js

@@ -6413,6 +6413,52 @@ var { MODELS: MODELS26 } = defineModels("minimax", [
       ...p.enum("bitrate", [32e3, 64e3, 128e3, 256e3], 256e3, { label: "Bitrate" }),
       ...p.enum("format", ["mp3", "wav", "pcm"], "mp3", { label: "Format" })
     }
+  },
+  {
+    // Combined T2V/I2V — fal.ai-hosted (pa-fal-ai-pluggable-worker), unlike
+    // the Hailuo/H3 entries in hailuo.ts which route through the minimax
+    // worker. A start frame switches to the image-to-video edit workflow.
+    id: "minimax-h3-max",
+    name: "MiniMax H3 Max",
+    modelId: "fal-ai-h3-max",
+    addedAt: "2026-08-28",
+    workflow: "minimax/h3-max/text-to-video",
+    editWorkflow: "minimax/h3-max/image-to-video",
+    estimatedTime: 180,
+    mode: "video",
+    inputType: "t2v",
+    description: "Top-tier MiniMax H3 Max video from text or a start/end frame, with prompt expansion. Up to 15s at 768p.",
+    features: [
+      feat("Image Input", "input"),
+      feat("Start/End Frame", "frame"),
+      feat("768p", "resolution"),
+      feat("5-15 sec", "duration")
+    ],
+    paramConfig: {
+      ...params.prompt(),
+      ...params.startFrame(),
+      ...params.endFrame(),
+      // Lowercase on purpose: the worker uppercases for the fal wire ('768P')
+      // and the pricing qualities are lowercase, so this casing serves both.
+      ...params.resolution(["480p", "768p"], "768p"),
+      ...params.durationRange(5, 15, 5),
+      ...params.aspectRatio(["21:9", "16:9", "4:3", "1:1", "3:4", "9:16"], "16:9"),
+      ...p.enum("promptExpansionMode", ["disabled", "balanced", "quality"], "balanced", { label: "Prompt Expansion" }),
+      // -1 (sentinel) means "pick a random seed"; the builder drops it.
+      ...p.range("seed", -1, 2147483647, -1),
+      ...p.boolean("enableSafetyChecker", true, "Safety Checker")
+    },
+    constraints: [
+      // The T2V wire has no end_image_url — an end frame only reaches the
+      // vendor on the I2V route, which needs a start frame to trigger.
+      { when: { startFrame: { exists: false } }, then: {
+        endFrame: { disabled: true, reason: "An end frame requires a start frame." }
+      } },
+      // I2V derives the ratio from the input image (no aspect_ratio on that wire).
+      { when: { startFrame: { exists: true } }, then: {
+        aspectRatio: { disabled: true, reason: "Aspect ratio follows the start frame image." }
+      } }
+    ]
   }
 ]);
 
@@ -6431,8 +6477,25 @@ var buildMinimaxMusicV3Payload = (input) => ({
     format: input.format ?? "mp3"
   }
 });
+var buildMinimaxH3MaxPayload = (input) => ({
+  prompt: input.prompt,
+  prompt_expansion_mode: input.promptExpansionMode ?? "balanced",
+  duration: input.duration ?? 5,
+  resolution: input.resolution ?? "768p",
+  ...input.startFrame ? {
+    image_url: input.startFrame,
+    ...input.endFrame ? { end_image_url: input.endFrame } : {}
+  } : { aspect_ratio: input.aspectRatio ?? "16:9" },
+  // -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(MODELS26, {
-  "minimax-music-v3": buildMinimaxMusicV3Payload
+  "minimax-music-v3": buildMinimaxMusicV3Payload,
+  "minimax-h3-max": buildMinimaxH3MaxPayload
+});
+registerEditPayloads(MODELS26, {
+  "minimax-h3-max": buildMinimaxH3MaxPayload
 });
 
 // src/vendors/catalog/ideogram.ts
@@ -6672,6 +6735,7 @@ var buildQwen2Payload = (ctx) => {
 };
 var buildQwenV1 = (model) => (ctx) => {
   const hasImages = Array.isArray(ctx.imageUrls) && ctx.imageUrls.length > 0;
+  const promptExtendMode = ctx.promptExtendMode === "agent" && hasImages && model === "qwen-image-3.0-pro" ? void 0 : ctx.promptExtendMode;
   return {
     prompt: ctx.prompt,
     model,
@@ -6680,8 +6744,10 @@ var buildQwenV1 = (model) => (ctx) => {
     size: (ctx.resolution ?? "2048x2048").replace("x", "*"),
     n: ctx.count ?? 1,
     prompt_extend: ctx.enhancePrompt ?? true,
-    // Qwen 3.0 only — prompt-rewrite strategy (direct/agent); 2.x ignores it.
-    ...ctx.promptExtendMode ? { prompt_extend_mode: ctx.promptExtendMode } : {},
+    // Qwen 3.0 family only — prompt-rewrite strategy (direct/agent); 2.x ignores it.
+    ...promptExtendMode ? { prompt_extend_mode: promptExtendMode } : {},
+    // Qwen 3.0 family only — thinking mode (requires prompt_extend).
+    ...ctx.enableThinking != null ? { enable_thinking: ctx.enableThinking } : {},
     watermark: false,
     ...ctx.seed != null ? { seed: ctx.seed } : {}
   };
@@ -6696,7 +6762,8 @@ var qwenV1Params = {
 };
 var qwenV1Params3 = {
   ...qwenV1Params,
-  ...p.enum("promptExtendMode", ["direct", "agent"], "direct")
+  ...p.enum("promptExtendMode", ["direct", "agent"], "direct"),
+  ...p.boolean("enableThinking", true, "Deep Thinking")
 };
 var { MODELS: MODELS28 } = defineModels("qwen", [
   {
@@ -6774,6 +6841,25 @@ var { MODELS: MODELS28 } = defineModels("qwen", [
       feat("2K", "resolution")
     ],
     paramConfig: qwenV1Params3
+  },
+  {
+    id: "qwen-image-3.0-pro",
+    name: "Qwen 3.0 Pro",
+    addedAt: "2026-08-31",
+    workflow: "qwen/v1/text-to-image",
+    editWorkflow: "qwen/v1/image-to-image",
+    buildPayload: buildQwenV1("qwen-image-3.0-pro"),
+    estimatedTime: 90,
+    mode: "image",
+    inputType: "t2i",
+    badge: ["premium"],
+    description: "Qwen-Image 3.0 Pro (GA) \u2014 flagship text-to-image and image editing with prompt-rewrite modes and thinking mode.",
+    features: [
+      feat("Image Input", "input"),
+      feat("Negative Prompt", "characteristic"),
+      feat("2K", "resolution")
+    ],
+    paramConfig: qwenV1Params3
   }
 ]);
 
@@ -10624,6 +10710,7 @@ var Lyria3Clip = "lyria-3-clip";
 var Lyria3Pro = "lyria-3-pro";
 var Minimax02Hd = "minimax-02-hd";
 var MinimaxH3 = "minimax-h3";
+var MinimaxH3Max = "minimax-h3-max";
 var MinimaxMusicV2 = "minimax-music-v2";
 var MinimaxMusicV3 = "minimax-music-v3";
 var Ovi = "ovi";
@@ -10652,6 +10739,7 @@ var Qwen = "qwen";
 var QwenImage2 = "qwen-image-2";
 var QwenImage2Pro = "qwen-image-2-pro";
 var QwenImage30 = "qwen-image-3.0";
+var QwenImage30Pro = "qwen-image-3.0-pro";
 var RecraftCreativeUpscale = "recraft-creative-upscale";
 var RecraftCrispUpscale = "recraft-crisp-upscale";
 var RecraftExplore = "recraft-explore";
@@ -10833,6 +10921,7 @@ var Models = {
   Lyria3Pro,
   Minimax02Hd,
   MinimaxH3,
+  MinimaxH3Max,
   MinimaxMusicV2,
   MinimaxMusicV3,
   Ovi,
@@ -10861,6 +10950,7 @@ var Models = {
   QwenImage2,
   QwenImage2Pro,
   QwenImage30,
+  QwenImage30Pro,
   RecraftCreativeUpscale,
   RecraftCrispUpscale,
   RecraftExplore,

package/package.json

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