@picsart/ai-sdk 5.20.0 → 5.21.1

package/index.d.ts

@@ -395,16 +395,6 @@ type ModelInputById = {
         prompt: string;
         voiceId?: string;
     };
-    "hailuo-03": {
-        prompt: string;
-        startFrame?: string;
-        endFrame?: string;
-        imageUrls?: string[];
-        videoUrls?: string[];
-        audioUrls?: string[];
-        duration?: 5 | 10 | 15;
-        aspectRatio?: "adaptive" | "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16";
-    };
     "hailuo-2.3": {
         prompt: string;
         enhancePrompt?: boolean;
@@ -791,6 +781,16 @@ type ModelInputById = {
         accent?: string;
         prompt: string;
     };
+    "minimax-h3": {
+        prompt: string;
+        startFrame?: string;
+        endFrame?: string;
+        imageUrls?: string[];
+        videoUrls?: string[];
+        audioUrls?: string[];
+        duration?: 5 | 10 | 15;
+        aspectRatio?: "adaptive" | "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16";
+    };
     "minimax-music-v2": {
         prompt: string;
         lyricsPrompt?: string;
@@ -2187,9 +2187,10 @@ interface ModelDefinition {
     editEstimatedTime?: number | Record<string, number>;
     testTimeout?: number;
     /**
-     * Per-model polling overrides for async jobs. Widens the global
-     * 2s × 300-attempt (~10 min) default for models whose generations can
-     * outlast it. Explicit per-call poll options still win.
+     * Per-model polling overrides for async jobs. Narrows or widens the mode
+     * default (video 2s × 1800 ≈ 1 h; image/audio/text 1s × 1200 ≈ 20 min) for
+     * models whose generations don't fit it. Explicit per-call poll options
+     * still win.
      */
     pollOptions?: {
         intervalMs?: number;
@@ -2396,6 +2397,17 @@ interface GenerateTextResult {
 /** Options for individual generate() / submit() calls. */
 interface GenerateOptions {
     signal?: AbortSignal;
+    /**
+     * Poll interval for the async status loop, in ms. Overrides the model's
+     * `pollOptions` and the mode default (video 2s; image/audio/text 1s).
+     */
+    intervalMs?: number;
+    /**
+     * Max poll attempts before the call throws a timeout. Overrides the model's
+     * `pollOptions` and the mode default (video 1800 ≈ 1 hour;
+     * image/audio/text 1200 ≈ 20 min).
+     */
+    maxAttempts?: number;
     /** Save to a specific subfolder instead of the root (legacy — used by SDK DriveConfig). */
     folder?: DriveFolder;
     /** Save result to Picsart Drive via backend. Injected into the workflow payload. */
@@ -2525,7 +2537,6 @@ declare const Models: {
     readonly GrokImagineVideo: "grok-imagine-video";
     readonly GrokImagineVideo15: "grok-imagine-video-1.5";
     readonly GrokTts: "grok-tts";
-    readonly Hailuo03: "hailuo-03";
     readonly Hailuo23: "hailuo-2.3";
     readonly Hailuo23Fast: "hailuo-2.3-fast";
     readonly Hailuo23FastPro: "hailuo-2.3-fast-pro";
@@ -2578,6 +2589,7 @@ declare const Models: {
     readonly Lyria3Clip: "lyria-3-clip";
     readonly Lyria3Pro: "lyria-3-pro";
     readonly Minimax02Hd: "minimax-02-hd";
+    readonly MinimaxH3: "minimax-h3";
     readonly MinimaxMusicV2: "minimax-music-v2";
     readonly MinimaxMusicV3: "minimax-music-v3";
     readonly Ovi: "ovi";

package/index.js

@@ -2667,7 +2667,7 @@ var buildMinimaxH3 = (ctx) => {
 var FRAME_REF_EXCLUSIVE = "First/last frame and reference inputs cannot be combined.";
 var LAST_NEEDS_FIRST = "An end frame requires a start frame.";
 var AUDIO_NEEDS_VISUAL = "Reference audio needs a reference image or video.";
-var hailuo03Constraints = [
+var minimaxH3Constraints = [
   // Frame roles ⊥ reference roles (declared both ways so either input disables the other).
   { when: { startFrame: { exists: true } }, then: {
     imageUrls: { disabled: true, reason: FRAME_REF_EXCLUSIVE },
@@ -2784,8 +2784,8 @@ var { MODELS: MODELS9 } = defineModels("minimax", [
   },
   {
     ...base,
-    id: "hailuo-03",
-    name: "Hailuo 03",
+    id: "minimax-h3",
+    name: "MiniMax H3",
     modelId: "minimax-h3",
     addedAt: "2026-07-30",
     inputType: "t2v",
@@ -2810,7 +2810,7 @@ var { MODELS: MODELS9 } = defineModels("minimax", [
       ...params.duration([5, 10, 15]),
       ...p.aspectRatio(["adaptive", "21:9", "16:9", "4:3", "1:1", "3:4", "9:16"], "adaptive")
     },
-    constraints: hailuo03Constraints
+    constraints: minimaxH3Constraints
   }
 ]);
 
@@ -3129,9 +3129,6 @@ var { MODELS: MODELS10 } = defineModels("wan", [
     description: "Wan 3.0 all-in-one \u2014 text, image/video/audio references, and start/end frames with adaptive ratio, intelligent duration, and audio.",
     features: [...wanV3Features],
     constraints: wanV3Constraints,
-    // Generations at 1080P / long durations can outlast the global 10-min
-    // polling default — widen to 5s × 360 attempts (30 min).
-    pollOptions: { intervalMs: 5e3, maxAttempts: 360 },
     paramConfig: { ...wanV3ParamConfig }
   },
   {
@@ -3146,7 +3143,6 @@ var { MODELS: MODELS10 } = defineModels("wan", [
     description: "Wan 3.0 Prime \u2014 the same all-in-one model as Wan 3.0, up to 7x faster.",
     features: [...wanV3Features],
     constraints: wanV3Constraints,
-    pollOptions: { intervalMs: 5e3, maxAttempts: 360 },
     paramConfig: { ...wanV3ParamConfig }
   }
 ]);
@@ -3786,12 +3782,6 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
     badge: ["new", "premium", "hot"],
     description: "Latest cinematic video with audio, multi-reference input, and mp4/mov output. Up to 30s.",
     features: [feat("Reference Image", "frame"), feat("Start/End Frame", "frame"), feat("Audio", "audio"), feat("1080p", "resolution"), feat("4-30 sec", "duration")],
-    // 1080p / 30s runs, and the whole extend path, outlast the global 10-min
-    // polling default: measured p90 for seedance-2.5-video-extend sits above
-    // the 600s ceiling. Widened to 5s × 360 attempts (30 min), same request
-    // count, 3x the wall clock. Deliberately NOT derived from estimatedTime,
-    // which understates seedance latency by ~10x.
-    pollOptions: { intervalMs: 5e3, maxAttempts: 360 },
     paramConfig: {
       ...params.prompt(),
       ...params.aspectRatio(SEEDANCE_AR),
@@ -3821,7 +3811,6 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
     badge: ["new", "premium", "hot"],
     description: "Edit video \u2014 replace subjects, add or remove objects, restyle scenes with reference images.",
     features: [feat("Video Input", "input"), feat("Multi-Image Input", "input"), feat("Audio", "audio"), feat("1080p", "resolution"), feat("Source length", "duration")],
-    pollOptions: { intervalMs: 5e3, maxAttempts: 360 },
     paramConfig: {
       ...params.prompt(),
       // Editing mode: aspect ratio is fixed to 'adaptive' and duration is
@@ -3848,7 +3837,6 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
     badge: ["new", "premium", "hot"],
     description: "Stitch up to 10 clips into one continuous, extended video.",
     features: [feat("Multi-Video Input", "input"), feat("Audio", "audio"), feat("1080p", "resolution"), feat("4-30 sec", "duration")],
-    pollOptions: { intervalMs: 5e3, maxAttempts: 360 },
     paramConfig: {
       ...params.prompt(),
       // Extension mode: aspect ratio is locked to 'adaptive' (vendor rule);
@@ -9904,6 +9892,23 @@ function createCatalogs(transport, options) {
 }
 
 // src/client/index.ts
+var MODE_POLL_DEFAULTS = {
+  video: { intervalMs: 2e3, maxAttempts: 1800 },
+  // 2s × 1800 = 1 hour
+  image: { intervalMs: 1e3, maxAttempts: 1200 },
+  // 1s × 1200 = 20 min
+  audio: { intervalMs: 1e3, maxAttempts: 1200 },
+  // 1s × 1200 = 20 min
+  text: { intervalMs: 1e3, maxAttempts: 1200 }
+  // 1s × 1200 = 20 min
+};
+function resolvePollOptions(model, overrides) {
+  const resolved = { ...MODE_POLL_DEFAULTS[model.mode], ...model.pollOptions };
+  if (overrides?.intervalMs !== void 0) resolved.intervalMs = overrides.intervalMs;
+  if (overrides?.maxAttempts !== void 0) resolved.maxAttempts = overrides.maxAttempts;
+  if (overrides?.signal !== void 0) resolved.signal = overrides.signal;
+  return resolved;
+}
 function createClient(config) {
   const isConfig = isClientConfig(config);
   const transport = isConfig ? buildTransport(config) : config;
@@ -9913,7 +9918,8 @@ function createClient(config) {
   const catalogs = createCatalogs(transport, isConfig ? config.catalogs : void 0);
   const driveConfig = isConfig ? config.drive : void 0;
   const driveClient = isConfig && driveConfig ? createDriveClient(resolveFetch(config), config.apiUrl, driveConfig.folder) : null;
-  async function executeModel(model, workflow, payload, signal) {
+  async function executeModel(model, workflow, payload, options) {
+    const signal = options?.signal;
     if (model.syncExecute || !supportsSubmit) {
       const syncResponse = await client.run(
         { workflow, payload, signal },
@@ -9926,7 +9932,7 @@ function createClient(config) {
         syncResponse.usage
       );
     }
-    return client.run({ workflow, payload, signal }, model.pollOptions);
+    return client.run({ workflow, payload, signal }, resolvePollOptions(model, options));
   }
   function buildDrivePayloadOptions(model, params2, options) {
     const explicit = options?.drive;
@@ -9966,7 +9972,7 @@ function createClient(config) {
       const { workflow, payload, contract } = prepareRequest(resolved, params2);
       const drive = buildDrivePayloadOptions(resolved, params2, options);
       const finalPayload = injectDriveOptions(payload, drive);
-      const completed = await executeModel(resolved, workflow, finalPayload, options?.signal);
+      const completed = await executeModel(resolved, workflow, finalPayload, options);
       return parseResult(completed, resolved, contract);
     },
     /**
@@ -9983,7 +9989,7 @@ function createClient(config) {
         throw new Error(`${resolved.name} is not a text model \u2014 use generate() instead.`);
       }
       const { workflow, payload } = prepareRequest(resolved, params2);
-      const completed = await executeModel(resolved, workflow, payload, options?.signal);
+      const completed = await executeModel(resolved, workflow, payload, options);
       return parseTextResult(completed, resolved);
     },
     /** @deprecated Use `getCredits()` instead. */
@@ -10027,7 +10033,7 @@ function createClient(config) {
     async result(handle, model, options) {
       const resolved = resolveModel(model);
       const contract = getModelContract(resolved.id);
-      const completed = await client.result(handle, { ...resolved.pollOptions, ...options });
+      const completed = await client.result(handle, resolvePollOptions(resolved, options));
       return parseResult(completed, resolved, contract);
     },
     /**
@@ -10565,7 +10571,6 @@ var GrokImagineImageQuality = "grok-imagine-image-quality";
 var GrokImagineVideo = "grok-imagine-video";
 var GrokImagineVideo15 = "grok-imagine-video-1.5";
 var GrokTts = "grok-tts";
-var Hailuo03 = "hailuo-03";
 var Hailuo23 = "hailuo-2.3";
 var Hailuo23Fast = "hailuo-2.3-fast";
 var Hailuo23FastPro = "hailuo-2.3-fast-pro";
@@ -10618,6 +10623,7 @@ var LumaUni1Max = "luma-uni-1-max";
 var Lyria3Clip = "lyria-3-clip";
 var Lyria3Pro = "lyria-3-pro";
 var Minimax02Hd = "minimax-02-hd";
+var MinimaxH3 = "minimax-h3";
 var MinimaxMusicV2 = "minimax-music-v2";
 var MinimaxMusicV3 = "minimax-music-v3";
 var Ovi = "ovi";
@@ -10774,7 +10780,6 @@ var Models = {
   GrokImagineVideo,
   GrokImagineVideo15,
   GrokTts,
-  Hailuo03,
   Hailuo23,
   Hailuo23Fast,
   Hailuo23FastPro,
@@ -10827,6 +10832,7 @@ var Models = {
   Lyria3Clip,
   Lyria3Pro,
   Minimax02Hd,
+  MinimaxH3,
   MinimaxMusicV2,
   MinimaxMusicV3,
   Ovi,

package/package.json

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