@picsart/ai-sdk 3.29.0 → 3.30.0

package/index.d.ts

@@ -405,11 +405,14 @@ type ModelInputById = {
         imageUrls: [string, ...string[]];
         resolution?: "4k" | "1080p" | "720p";
         aspectRatio?: "16:9" | "9:16";
+        voiceId: string;
         prompt: string;
     };
     "heygen-video-avatar": {
+        videoId: string;
         resolution?: "4k" | "1080p" | "720p";
         aspectRatio?: "16:9" | "9:16";
+        voiceId: string;
         prompt: string;
     };
     "hunyuan-v3": {
@@ -1299,6 +1302,7 @@ type ModelInputById = {
     };
     "sora-2-extend": {
         prompt: string;
+        videoId?: string;
         duration?: 4 | 8 | 12 | 16 | 20;
     };
     "sora-2-pro": {

package/index.js

@@ -2857,6 +2857,42 @@ var buildMinimaxH3 = (ctx) => {
     ...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"
 };
@@ -2949,7 +2985,6 @@ var { MODELS: MODELS9 } = defineModels("minimax", [
     workflow: "minimax/v2/video-generation",
     buildPayload: buildMinimaxH3,
     estimatedTime: 300,
-    release: "preview",
     description: "MiniMax H3 2K video from text, start/last frame, or image/video/audio references.",
     features: [
       feat("Start Frame", "frame"),
@@ -2967,7 +3002,8 @@ var { MODELS: MODELS9 } = defineModels("minimax", [
       ...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
   }
 ]);
 
@@ -6489,14 +6525,14 @@ var { MODELS: MODELS25 } = defineModels("heygen", [
     id: "heygen-video-avatar",
     modelId: "heygen-avatar-iv",
     addedAt: "2026-03-17",
-    // disabled 2026-05-08: backend/catalog mismatch.
-    //   heygen/v1/video/generate uses Avatar IV mode but heygen/v1/avatars/list
-    //   returns 1287 Avatar III avatars (all preview URLs are /avatar/v3/), so
-    //   every avatar from the list is rejected with "This video avatar does not
-    //   support Avatar IV video generation". Talking Photo (i2v) path is
-    //   unaffected. Re-enable once backend exposes an Avatar IV catalog OR
-    //   downgrades the worker to Avatar III mode.
-    disabled: true,
+    // Disabled 2026-05-08 because the avatar list carried no way to tell an
+    // Avatar IV-compatible avatar from an incompatible one, so picks were
+    // rejected at submit. The worker now serves `heygen/v1/avatars/list` from
+    // HeyGen v3 looks filtered by `supported_api_engines`, so every id it offers
+    // is one the engine accepts. Kept at `preview` until that runs on
+    // production — the tag is opt-in, so only stage surfaces asking for it will
+    // list the model.
+    release: "preview",
     name: "HeyGen Video Avatar",
     workflow: "heygen/v1/video/generate",
     buildPayload: buildHeyGenVideoAvatarPayload,
@@ -6664,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,

package/package.json

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