@picsart/ai-sdk 3.28.0 → 3.29.1

package/index.d.ts

@@ -334,6 +334,16 @@ type ModelInputById = {
         prompt: string;
         voiceId?: "eve" | "ara" | "rex" | "sal" | "leo";
     };
+    "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;
@@ -1854,7 +1864,7 @@ interface ModelMeta {
     readonly features: ModelFeature[];
     readonly badges: BadgeType[];
     readonly provider: ProviderInfo;
-    /** Release / availability tier (EAI-3). Absent on the definition ⇒ `'production'`. */
+    /** Release / availability tier. Absent on the definition ⇒ `'production'`. */
     readonly release: ReleaseTag;
 }
 /** Parameter operations — fluent access to model params, schemas, defaults. */
@@ -2190,6 +2200,7 @@ 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";
@@ -2470,7 +2481,7 @@ declare const releaseOf: (m: ModelDefinition) => ReleaseTag;
  * `disabled` and `deprecated` are hard hides layered on top of `release`: a
  * model carrying either is never visible, regardless of its release tag or the
  * requested set. (`disabled` is being phased out in favour of
- * `release: 'preview'` — EAI-3 — but is still honoured during the migration.)
+ * `release: 'preview'`, but is still honoured during the migration.)
  */
 declare function isVisibleForReleases(m: ModelDefinition, releases?: readonly ReleaseTag[]): boolean;
 

package/index.js

@@ -2842,6 +2842,57 @@ var buildI2V = (withDuration) => (ctx) => ({
   ...ctx.enhancePrompt !== void 0 ? { prompt_optimizer: ctx.enhancePrompt } : {},
   ...withDuration && ctx.duration ? { duration: String(ctx.duration) } : {}
 });
+var buildMinimaxH3 = (ctx) => {
+  const content = [{ type: "text", text: ctx.prompt }];
+  if (ctx.startFrame) content.push({ type: "image_url", image_url: { url: ctx.startFrame }, role: "first_frame" });
+  if (ctx.endFrame) content.push({ type: "image_url", image_url: { url: ctx.endFrame }, role: "last_frame" });
+  for (const url of ctx.imageUrls ?? []) content.push({ type: "image_url", image_url: { url }, role: "reference_image" });
+  for (const url of ctx.videoUrls ?? []) content.push({ type: "video_url", video_url: { url }, role: "reference_video" });
+  for (const url of ctx.audioUrls ?? []) content.push({ type: "audio_url", audio_url: { url }, role: "reference_audio" });
+  return {
+    model: "MiniMax-H3",
+    content,
+    resolution: "2K",
+    ...ctx.duration ? { duration: ctx.duration } : {},
+    ...ctx.aspectRatio ? { ratio: ctx.aspectRatio } : {}
+  };
+};
+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 = [
+  // 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 },
+    videoUrls: { disabled: true, reason: FRAME_REF_EXCLUSIVE },
+    audioUrls: { disabled: true, reason: FRAME_REF_EXCLUSIVE }
+  } },
+  { when: { endFrame: { exists: true } }, then: {
+    imageUrls: { disabled: true, reason: FRAME_REF_EXCLUSIVE },
+    videoUrls: { disabled: true, reason: FRAME_REF_EXCLUSIVE },
+    audioUrls: { disabled: true, reason: FRAME_REF_EXCLUSIVE }
+  } },
+  { when: { imageUrls: { exists: true } }, then: {
+    startFrame: { disabled: true, reason: FRAME_REF_EXCLUSIVE },
+    endFrame: { disabled: true, reason: FRAME_REF_EXCLUSIVE }
+  } },
+  { when: { videoUrls: { exists: true } }, then: {
+    startFrame: { disabled: true, reason: FRAME_REF_EXCLUSIVE },
+    endFrame: { disabled: true, reason: FRAME_REF_EXCLUSIVE }
+  } },
+  { when: { audioUrls: { exists: true } }, then: {
+    startFrame: { disabled: true, reason: FRAME_REF_EXCLUSIVE },
+    endFrame: { disabled: true, reason: FRAME_REF_EXCLUSIVE }
+  } },
+  // last_frame requires first_frame.
+  { when: { startFrame: { exists: false } }, then: {
+    endFrame: { disabled: true, reason: LAST_NEEDS_FIRST }
+  } },
+  // reference_audio cannot be the only reference input.
+  { when: { imageUrls: { exists: false }, videoUrls: { exists: false } }, then: {
+    audioUrls: { disabled: true, reason: AUDIO_NEEDS_VISUAL }
+  } }
+];
 var base = {
   mode: "video"
 };
@@ -2923,6 +2974,36 @@ var { MODELS: MODELS9 } = defineModels("minimax", [
       ...params.enhancePrompt(),
       ...params.imageInput(1, "Start Image", true)
     }
+  },
+  {
+    ...base,
+    id: "hailuo-03",
+    name: "Hailuo 03",
+    modelId: "minimax-h3",
+    addedAt: "2026-07-30",
+    inputType: "t2v",
+    workflow: "minimax/v2/video-generation",
+    buildPayload: buildMinimaxH3,
+    estimatedTime: 300,
+    description: "MiniMax H3 2K video from text, start/last frame, or image/video/audio references.",
+    features: [
+      feat("Start Frame", "frame"),
+      feat("End Frame", "frame"),
+      feat("Reference Video", "input"),
+      feat("2K", "resolution"),
+      feat("15 sec", "duration")
+    ],
+    paramConfig: {
+      ...params.prompt(),
+      ...params.startFrame(),
+      ...params.endFrame(),
+      ...params.imageInput(3, "Reference Images", false),
+      ...params.videoInputs(1, "Reference Videos", false),
+      ...params.audioInputs(1, "Reference Audios", false),
+      ...params.duration([5, 10, 15]),
+      ...p.aspectRatio(["adaptive", "21:9", "16:9", "4:3", "1:1", "3:4", "9:16"], "adaptive")
+    },
+    constraints: hailuo03Constraints
   }
 ]);
 
@@ -3422,7 +3503,7 @@ var { MODELS: MODELS11 } = defineModels("luma", [
   },
   // ── Ray 3.2 (early access) — buildPayload registered in luma.payloads.ts ──
   {
-    // modelId defaults to id ('luma-ray-3.2') — matches the pricing-service key.
+    // modelId defaults to id ('luma-ray-3.2') — matches the backend pricing key.
     id: "luma-ray-3.2",
     name: "Luma Ray 3.2",
     addedAt: "2026-06-11",
@@ -4079,9 +4160,9 @@ var { MODELS: MODELS14 } = defineModels("seedream", [
     estimatedTime: { "1K": 20, "2K": 35 },
     mode: "image",
     inputType: "t2i",
-    // Backend (pa-bytedance-pluggable-worker) gates 5.0-pro to 1K/2K — it
-    // rejects 3K/4K ("not supported by model seedream_5_0_pro"). Single-image
-    // only (no group/sequential), up to 10 reference images.
+    // The backend gates 5.0-pro to 1K/2K — it rejects 3K/4K ("not supported by
+    // model seedream_5_0_pro"). Single-image only (no group/sequential), up to
+    // 10 reference images.
     description: "Top-tier single-image generation with up to 10 reference images and 2K detail.",
     features: [feat("Multi-Image Input", "input"), feat("2K", "resolution")],
     // Single-image only (no sequential/batch) → no `count` param, unlike the V2 models.
@@ -4105,9 +4186,9 @@ var { MODELS: MODELS14 } = defineModels("seedream", [
     mode: "image",
     inputType: "t2i",
     badge: ["popular"],
-    // Backend (pa-bytedance-pluggable-worker) gates 5.0-lite to 2K/3K — it
-    // rejects 4K ("not supported by model seedream_5_0_lite") even though the
-    // SeedreamResolution enum defines a 4K member. Boundary-verified 2026-05-25.
+    // The backend gates 5.0-lite to 2K/3K — it rejects 4K ("not supported by
+    // model seedream_5_0_lite") even though the SeedreamResolution enum defines
+    // a 4K member. Boundary-verified 2026-05-25.
     description: "Speedy 3K output with negative prompt and dual-image input support.",
     features: [feat("Multi-Image Input", "input"), feat("3K", "resolution")],
     paramConfig: {
@@ -6619,7 +6700,6 @@ var { MODELS: MODELS27 } = defineModels("ideogram", [
   {
     id: "ideogram-p-image",
     name: "Ideogram P-Image",
-    release: "preview",
     addedAt: "2026-07-28",
     workflow: "ideogram/p-image/generate",
     buildPayload: buildIdeogramPImagePayload,
@@ -10409,6 +10489,7 @@ 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";
@@ -10607,6 +10688,7 @@ var Models = {
   GrokImagineVideo,
   GrokImagineVideo15,
   GrokTts,
+  Hailuo03,
   Hailuo23,
   Hailuo23Fast,
   Hailuo23FastPro,

package/package.json

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