@picsart/ai-sdk 6.39.0 → 6.41.0

package/index.d.ts

@@ -728,6 +728,15 @@ type ModelInputById = {
         prompt: string;
         voiceId?: string;
     };
+    "hailuo-02": {
+        prompt: string;
+        enhancePrompt?: boolean;
+        resolution?: "512P" | "768P" | "1080P";
+        duration?: 6 | 10;
+        startFrame?: string;
+        endFrame?: string;
+        imageUrls?: string[];
+    };
     "hailuo-2.3": {
         prompt: string;
         enhancePrompt?: boolean;
@@ -1189,6 +1198,16 @@ type ModelInputById = {
         duration?: number;
         aspectRatio?: "adaptive" | "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16";
     };
+    "minimax-h3-context-ir": {
+        prompt: string;
+        startFrame?: string;
+        endFrame?: string;
+        imageUrls?: string[];
+        videoUrls?: string[];
+        audioUrls?: string[];
+        duration?: number;
+        aspectRatio?: "adaptive" | "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16";
+    };
     "minimax-h3-max": {
         prompt: string;
         startFrame?: string;
@@ -2104,7 +2123,7 @@ type ModelInputById = {
 type TypedModelId = keyof ModelInputById;
 type ModelInput<M extends TypedModelId> = ModelInputById[M];
 /** IDs of text-generation (LLM) models — narrows generateText(). */
-type TextModelId = "claude-fable-5" | "claude-fable-5-1" | "claude-haiku-4-5" | "claude-haiku-5-5" | "claude-opus-4-8" | "claude-opus-5" | "claude-sonnet-4-5" | "claude-sonnet-4-6" | "claude-sonnet-5" | "eleven-speech-to-text" | "gemini-2.5-flash" | "gemini-3-pro" | "gemini-3.5-flash-lite" | "gemini-3.6-flash" | "gemini-3.7-flash" | "gemini-3.8-flash" | "gemini-4-argon" | "gpt-4.1-mini" | "gpt-4.1-nano" | "gpt-4o" | "gpt-4o-mini" | "gpt-5" | "gpt-5-mini" | "gpt-5.1" | "gpt-5.2" | "gpt-5.5" | "gpt-5.6-luna" | "gpt-5.6-sol" | "gpt-5.6-terra" | "gpt-6-astra" | "gpt-6-luna" | "gpt-6-sol" | "grok-4.7" | "kimi-k3";
+type TextModelId = "claude-fable-5" | "claude-fable-5-1" | "claude-haiku-4-5" | "claude-haiku-5-5" | "claude-opus-4-8" | "claude-opus-5" | "claude-sonnet-4-5" | "claude-sonnet-4-6" | "claude-sonnet-5" | "eleven-speech-to-text" | "gemini-2.5-flash" | "gemini-3-pro" | "gemini-3.5-flash-lite" | "gemini-3.6-flash" | "gemini-3.7-flash" | "gemini-3.8-flash" | "gemini-4-argon" | "gpt-4.1-mini" | "gpt-4.1-nano" | "gpt-4o" | "gpt-4o-mini" | "gpt-5" | "gpt-5-mini" | "gpt-5.1" | "gpt-5.2" | "gpt-5.5" | "gpt-5.6-luna" | "gpt-5.6-sol" | "gpt-5.6-terra" | "gpt-6-astra" | "gpt-6-luna" | "gpt-6-sol" | "grok-4.7" | "kimi-k3" | "minimax-h3-context-ir";
 type TextModelInputById = Pick<ModelInputById, TextModelId>;
 /** IDs of structured-output (json-mode) models — narrows run()'s result type. */
 type JsonModelId = "typesafe-evaluate";
@@ -3555,6 +3574,7 @@ declare const Models: {
     readonly GrokImagineVideo15: "grok-imagine-video-1.5";
     readonly GrokImagineVideo15Lite: "grok-imagine-video-1.5-lite";
     readonly GrokTts: "grok-tts";
+    readonly Hailuo02: "hailuo-02";
     readonly Hailuo23: "hailuo-2.3";
     readonly Hailuo23Fast: "hailuo-2.3-fast";
     readonly Hailuo23FastPro: "hailuo-2.3-fast-pro";
@@ -3612,6 +3632,7 @@ declare const Models: {
     readonly Lyria3Pro: "lyria-3-pro";
     readonly Lyria35: "lyria-3.5";
     readonly MinimaxH3: "minimax-h3";
+    readonly MinimaxH3ContextIr: "minimax-h3-context-ir";
     readonly MinimaxH3Max: "minimax-h3-max";
     readonly MinimaxH3MaxCameraControls: "minimax-h3-max-camera-controls";
     readonly MinimaxH3MaxExtend: "minimax-h3-max-extend";

package/index.js

@@ -3437,10 +3437,70 @@ var minimaxH3Constraints = [
     audioUrls: { disabled: true, reason: AUDIO_NEEDS_VISUAL2 }
   } }
 ];
+var HAILUO_02_1080P_6S = "1080P supports a 6s duration only.";
+var HAILUO_02_512P_I2V = "512P needs a start frame and has no end frame.";
+var HAILUO_02_ONE_SOURCE = "Use either the start frame or the start image.";
+var hailuo02Constraints = [
+  { when: { resolution: { is: "1080P" } }, then: {
+    duration: { allowed: [6], reason: HAILUO_02_1080P_6S }
+  } },
+  { when: { duration: { is: 10 } }, then: {
+    resolution: { allowed: ["512P", "768P"], reason: HAILUO_02_1080P_6S }
+  } },
+  { when: { startFrame: { exists: false }, imageUrls: { exists: false } }, then: {
+    endFrame: { disabled: true, reason: LAST_NEEDS_FIRST },
+    resolution: { allowed: ["768P", "1080P"], reason: HAILUO_02_512P_I2V }
+  } },
+  { when: { startFrame: { exists: true } }, then: {
+    imageUrls: { disabled: true, reason: HAILUO_02_ONE_SOURCE }
+  } },
+  { when: { imageUrls: { exists: true } }, then: {
+    startFrame: { disabled: true, reason: HAILUO_02_ONE_SOURCE }
+  } },
+  { when: { endFrame: { exists: true } }, then: {
+    resolution: { allowed: ["768P", "1080P"], reason: HAILUO_02_512P_I2V }
+  } },
+  { when: { resolution: { is: "512P" } }, then: {
+    endFrame: { disabled: true, reason: HAILUO_02_512P_I2V }
+  } }
+];
 var base = {
   mode: "video"
 };
 var { MODELS: MODELS10 } = defineModels("minimax", [
+  {
+    // Builder lives in hailuo.payloads.ts. One task for every mode and
+    // resolution — the worker picks text- or image-to-video from image_url
+    // and resolves pricing per mode and resolution.
+    // Preview until minimax/hailuo-02/video-generation is deployed.
+    ...base,
+    id: "hailuo-02",
+    name: "Hailuo 02",
+    modelId: "minimax-hailuo-02",
+    addedAt: "2026-08-15",
+    release: "preview",
+    inputType: "t2v",
+    workflow: "minimax/hailuo-02/video-generation",
+    estimatedTime: 300,
+    description: "Up to 1080p video from text or a start/end frame, with strong physics and instruction following.",
+    features: [
+      feat("Start Frame", "frame"),
+      feat("End Frame", "frame"),
+      feat("1080p", "resolution"),
+      feat("10 sec", "duration")
+    ],
+    paramConfig: {
+      ...params.prompt({ maxLength: 2e3 }),
+      ...params.enhancePrompt(),
+      ...params.resolution(["512P", "768P", "1080P"], "768P"),
+      ...params.duration([6, 10]),
+      ...params.startFrame(),
+      ...params.endFrame(),
+      // Same first frame for callers that send images as imageUrls.
+      ...params.imageInput(1, "Start Image")
+    },
+    constraints: hailuo02Constraints
+  },
   {
     ...base,
     id: "hailuo-2.3",
@@ -3556,6 +3616,25 @@ var { MODELS: MODELS10 } = defineModels("minimax", [
   }
 ]);
 
+// src/vendors/catalog/hailuo.payloads.ts
+var buildHailuo02Payload = (input) => {
+  const startFrame = input.startFrame || input.imageUrls?.[0];
+  if (input.endFrame && !startFrame) {
+    throw new ApiError("Hailuo 02: an end frame requires a start frame.", { status: 400, code: "validation_error" });
+  }
+  return {
+    prompt: input.prompt,
+    ...input.enhancePrompt !== void 0 ? { prompt_optimizer: input.enhancePrompt } : {},
+    ...input.resolution ? { resolution: input.resolution } : {},
+    ...input.duration ? { duration: input.duration } : {},
+    ...startFrame ? { image_url: startFrame } : {},
+    ...input.endFrame ? { end_image_url: input.endFrame } : {}
+  };
+};
+registerPayloads(MODELS10, {
+  "hailuo-02": buildHailuo02Payload
+});
+
 // src/vendors/catalog/wan.ts
 var buildWanT2VPayload = (ctx) => ({
   prompt: ctx.prompt,
@@ -10664,7 +10743,56 @@ var { MODELS: GROK_LLM } = defineModels("grok", [
     }
   }
 ]);
-var MODELS35 = [...ANTHROPIC, ...OPENAI_LLM, ...GEMINI_LLM, ...KIMI_LLM, ...GROK_LLM];
+var H3_FRAME_REF_EXCLUSIVE = "References and start/end frames cannot be combined.";
+var H3_FRAME_EXCLUDES_REFERENCES = {
+  imageUrls: { disabled: true, reason: H3_FRAME_REF_EXCLUSIVE },
+  videoUrls: { disabled: true, reason: H3_FRAME_REF_EXCLUSIVE },
+  audioUrls: { disabled: true, reason: H3_FRAME_REF_EXCLUSIVE }
+};
+var H3_REFERENCE_EXCLUDES_FRAMES = {
+  startFrame: { disabled: true, reason: H3_FRAME_REF_EXCLUSIVE },
+  endFrame: { disabled: true, reason: H3_FRAME_REF_EXCLUSIVE }
+};
+var h3ContextIrConstraints = [
+  { when: { startFrame: { exists: true } }, then: H3_FRAME_EXCLUDES_REFERENCES },
+  { when: { endFrame: { exists: true } }, then: H3_FRAME_EXCLUDES_REFERENCES },
+  { when: { imageUrls: { exists: true } }, then: H3_REFERENCE_EXCLUDES_FRAMES },
+  { when: { videoUrls: { exists: true } }, then: H3_REFERENCE_EXCLUDES_FRAMES },
+  { when: { audioUrls: { exists: true } }, then: H3_REFERENCE_EXCLUDES_FRAMES }
+];
+var { MODELS: MINIMAX_LLM } = defineModels("minimax", [
+  {
+    id: "minimax-h3-context-ir",
+    name: "MiniMax H3 Context IR",
+    workflow: "minimax/v2/h3-context-ir",
+    addedAt: "2026-10-14",
+    estimatedTime: 8,
+    mode: "text",
+    inputType: "v2t",
+    badge: ["new"],
+    description: "MiniMax H3 Context IR \u2014 enhances a video prompt from text plus optional first/last frame, reference images, videos, and audio. Returns an enhanced prompt, not a video.",
+    features: [
+      feat("Vision", "input"),
+      feat("Video Input", "input"),
+      feat("Audio Input", "input"),
+      feat("Start/End Frame", "frame")
+    ],
+    paramConfig: {
+      ...params.prompt(),
+      ...params.startFrame("Start Frame", false),
+      ...params.endFrame("End Frame"),
+      ...params.imageInput(9, "Reference Images", false, "reference"),
+      ...params.videoInputs(3, "Reference Videos", false),
+      ...params.audioInputs(3, "Reference Audios", false),
+      // Target video shape the enhancement is written towards (4-15s; the
+      // ratio defaults to 'adaptive' — follow the references).
+      ...params.durationRange(4, 15, 5),
+      ...params.aspectRatio(["adaptive", "21:9", "16:9", "4:3", "1:1", "3:4", "9:16"], "adaptive")
+    },
+    constraints: h3ContextIrConstraints
+  }
+]);
+var MODELS35 = [...ANTHROPIC, ...OPENAI_LLM, ...GEMINI_LLM, ...KIMI_LLM, ...GROK_LLM, ...MINIMAX_LLM];
 
 // src/vendors/catalog/llm.payloads.ts
 var CLAUDE_MAX_TOKENS = 8192;
@@ -10715,7 +10843,22 @@ var buildGeminiPayload = (modelId) => (input) => {
     ...level ? { generationConfig: { thinkingConfig: { thinkingLevel: level } } } : {}
   };
 };
+var buildMinimaxH3ContextIrPayload = (input) => {
+  const content = [{ type: "text", text: input.prompt }];
+  if (input.startFrame) content.push({ type: "image_url", image_url: { url: input.startFrame }, role: "first_frame" });
+  if (input.endFrame) content.push({ type: "image_url", image_url: { url: input.endFrame }, role: "last_frame" });
+  for (const url of input.imageUrls ?? []) content.push({ type: "image_url", image_url: { url }, role: "reference_image" });
+  for (const url of input.videoUrls ?? []) content.push({ type: "video_url", video_url: { url }, role: "reference_video" });
+  for (const url of input.audioUrls ?? []) content.push({ type: "audio_url", audio_url: { url }, role: "reference_audio" });
+  return {
+    model: "MiniMax-H3",
+    content,
+    duration: input.duration ?? 5,
+    ...input.aspectRatio ? { ratio: input.aspectRatio } : {}
+  };
+};
 registerPayloads(MODELS35, {
+  "minimax-h3-context-ir": buildMinimaxH3ContextIrPayload,
   "claude-fable-5-1": buildClaudePayload("claude-fable-5-1"),
   "claude-fable-5": buildClaudePayload("claude-fable-5"),
   "claude-opus-5": buildClaudePayload("claude-opus-5"),
@@ -14806,6 +14949,7 @@ var GrokImagineVideo = "grok-imagine-video";
 var GrokImagineVideo15 = "grok-imagine-video-1.5";
 var GrokImagineVideo15Lite = "grok-imagine-video-1.5-lite";
 var GrokTts = "grok-tts";
+var Hailuo02 = "hailuo-02";
 var Hailuo23 = "hailuo-2.3";
 var Hailuo23Fast = "hailuo-2.3-fast";
 var Hailuo23FastPro = "hailuo-2.3-fast-pro";
@@ -14863,6 +15007,7 @@ var Lyria3Clip = "lyria-3-clip";
 var Lyria3Pro = "lyria-3-pro";
 var Lyria35 = "lyria-3.5";
 var MinimaxH3 = "minimax-h3";
+var MinimaxH3ContextIr = "minimax-h3-context-ir";
 var MinimaxH3Max = "minimax-h3-max";
 var MinimaxH3MaxCameraControls = "minimax-h3-max-camera-controls";
 var MinimaxH3MaxExtend = "minimax-h3-max-extend";
@@ -15071,6 +15216,7 @@ var Models = {
   GrokImagineVideo15,
   GrokImagineVideo15Lite,
   GrokTts,
+  Hailuo02,
   Hailuo23,
   Hailuo23Fast,
   Hailuo23FastPro,
@@ -15128,6 +15274,7 @@ var Models = {
   Lyria3Pro,
   Lyria35,
   MinimaxH3,
+  MinimaxH3ContextIr,
   MinimaxH3Max,
   MinimaxH3MaxCameraControls,
   MinimaxH3MaxExtend,

package/package.json

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