@picsart/ai-sdk 6.24.1 → 6.25.0

package/index.d.ts

@@ -759,6 +759,18 @@ type ModelInputById = {
         voiceId: string;
         prompt: string;
     };
+    "heygen-video-1": {
+        prompt: string;
+        startFrame?: string;
+        imageUrls?: string[];
+        videoUrls?: string[];
+        audioUrls?: string[];
+        resolution?: "480p" | "768p";
+        duration?: number;
+        aspectRatio?: "adaptive" | "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16";
+        promptEnhancement?: "turbo" | "quality" | "disabled";
+        seed?: number;
+    };
     "heygen-video-avatar": {
         videoId: string;
         engine?: "avatar_iv" | "avatar_v";
@@ -3361,6 +3373,7 @@ declare const Models: {
     readonly Happyhorse11R2v: "happyhorse-1.1-r2v";
     readonly Happyhorse11T2v: "happyhorse-1.1-t2v";
     readonly HeygenTalkingPhoto: "heygen-talking-photo";
+    readonly HeygenVideo1: "heygen-video-1";
     readonly HeygenVideoAvatar: "heygen-video-avatar";
     readonly HunyuanV3: "hunyuan-v3";
     readonly Ideogram45: "ideogram-4-5";

package/index.js

@@ -7750,6 +7750,32 @@ var dynamicVoiceConfig = {
     catalog: { workflow: "heygen/v1/catalog/voices" }
   })
 };
+var VIDEO1_MODE_EXCLUSIVE = "A first frame and references cannot be combined \u2014 each picks a different mode.";
+var VIDEO1_RATIO_FOLLOWS_FRAME = "Aspect ratio follows the first-frame image.";
+var VIDEO1_ADAPTIVE_NEEDS_REFS = "Adaptive aspect ratio follows the references \u2014 add one to use it.";
+var VIDEO1_RATIOS = ["21:9", "16:9", "4:3", "1:1", "3:4", "9:16"];
+var heygenVideo1Constraints = [
+  { when: { startFrame: { exists: true } }, then: {
+    imageUrls: { disabled: true, reason: VIDEO1_MODE_EXCLUSIVE },
+    videoUrls: { disabled: true, reason: VIDEO1_MODE_EXCLUSIVE },
+    audioUrls: { disabled: true, reason: VIDEO1_MODE_EXCLUSIVE },
+    // image_to_video always follows the first frame — the ratio is not a choice.
+    aspectRatio: { disabled: true, reason: VIDEO1_RATIO_FOLLOWS_FRAME }
+  } },
+  { when: { imageUrls: { exists: true } }, then: {
+    startFrame: { disabled: true, reason: VIDEO1_MODE_EXCLUSIVE }
+  } },
+  { when: { videoUrls: { exists: true } }, then: {
+    startFrame: { disabled: true, reason: VIDEO1_MODE_EXCLUSIVE }
+  } },
+  { when: { audioUrls: { exists: true } }, then: {
+    startFrame: { disabled: true, reason: VIDEO1_MODE_EXCLUSIVE }
+  } },
+  // 'adaptive' means "follow the first reference" — no meaning without one.
+  { when: { imageUrls: { exists: false }, videoUrls: { exists: false }, audioUrls: { exists: false } }, then: {
+    aspectRatio: { allowed: [...VIDEO1_RATIOS], reason: VIDEO1_ADAPTIVE_NEEDS_REFS }
+  } }
+];
 var { MODELS: MODELS25 } = defineModels("heygen", [
   // ── Photo Avatar (i2v) ────────────────────────────────────────────
   {
@@ -7804,9 +7830,73 @@ var { MODELS: MODELS25 } = defineModels("heygen", [
       ...dynamicVoiceConfig,
       ...params.prompt({ minLength: 20, maxLength: 5e3, placeholder: "Write the script your avatar will speak (at least 20 characters)..." })
     }
+  },
+  // ── HeyGen Video (t2v / i2v / r2v) ────────────────────────────────
+  {
+    // One entry for all three modes: the inputs pick it — a first-frame image
+    // animates that image, references generate from references, a bare prompt
+    // generates from text. Payload assembly lives in heygen.payloads.ts.
+    id: "heygen-video-1",
+    name: "HeyGen Video",
+    addedAt: "2026-10-05",
+    workflow: "heygen/v1/models/video/generate",
+    estimatedTime: 60,
+    mode: "video",
+    inputType: "t2v",
+    description: "HeyGen Video \u2014 video with native audio from text, a first-frame image, or up to 12 reference images, videos and audio. Refer to references in the prompt as Picture 1, Video 1, in input order. Up to 15s at 768p.",
+    features: [
+      feat("Start Frame", "frame"),
+      feat("Multi-Image Input", "input"),
+      feat("Video Input", "input"),
+      feat("Audio Input", "input"),
+      feat("Audio", "audio"),
+      feat("5-15 sec", "duration")
+    ],
+    paramConfig: {
+      ...params.prompt({ maxLength: 32e3 }),
+      ...params.startFrame("Start Frame", false),
+      // Reference slots, reference-to-video route. The ≤12 files combined
+      // across images + videos + audios stay backend-enforced.
+      ...params.imageInput(9, "Reference Images", false, "reference"),
+      ...params.videoInputs(3, "Reference Videos"),
+      ...params.audioInputs(3, "Reference Audios"),
+      ...params.resolution(["480p", "768p"], "768p"),
+      ...params.durationRange(5, 15, 5),
+      // 'adaptive' means "follow the references" — constrained below.
+      ...params.aspectRatio(["adaptive", "21:9", "16:9", "4:3", "1:1", "3:4", "9:16"], "16:9"),
+      ...p.enum("promptEnhancement", ["turbo", "quality", "disabled"], "turbo", { label: "Prompt Enhancement" }),
+      // Unsigned 32-bit per the schema; sent only when the user sets it.
+      ...params.seed(4294967295)
+    },
+    constraints: heygenVideo1Constraints
   }
 ]);
 
+// src/vendors/catalog/heygen.payloads.ts
+var asMediaRef = (url) => ({ type: "url", url });
+var buildHeygenVideo1Payload = (input) => {
+  const hasFrame = !!input.startFrame;
+  const hasReferences = !!(input.imageUrls?.length || input.videoUrls?.length || input.audioUrls?.length);
+  return {
+    model: "heygen-video-1",
+    prompt: input.prompt,
+    duration: input.duration ?? 5,
+    resolution: input.resolution ?? "768p",
+    prompt_enhancement: input.promptEnhancement ?? "turbo",
+    // With references the default is 'adaptive' (follow the first one); from
+    // the prompt alone it is 16:9.
+    ...hasFrame ? {} : { aspect_ratio: input.aspectRatio ?? (hasReferences ? "adaptive" : "16:9") },
+    ...input.startFrame ? { image: asMediaRef(input.startFrame) } : {},
+    ...input.imageUrls?.length ? { reference_images: input.imageUrls.map(asMediaRef) } : {},
+    ...input.videoUrls?.length ? { reference_videos: input.videoUrls.map(asMediaRef) } : {},
+    ...input.audioUrls?.length ? { reference_audio: input.audioUrls.map(asMediaRef) } : {},
+    ...input.seed != null ? { seed: input.seed } : {}
+  };
+};
+registerPayloads(MODELS25, {
+  "heygen-video-1": buildHeygenVideo1Payload
+});
+
 // src/vendors/catalog/minimax.payloads.ts
 var buildMinimaxMusicV3Payload = (input) => ({
   prompt: input.prompt,
@@ -13470,6 +13560,7 @@ var Happyhorse10VideoEdit = "happyhorse-1.0-video-edit";
 var Happyhorse11R2v = "happyhorse-1.1-r2v";
 var Happyhorse11T2v = "happyhorse-1.1-t2v";
 var HeygenTalkingPhoto = "heygen-talking-photo";
+var HeygenVideo1 = "heygen-video-1";
 var HeygenVideoAvatar = "heygen-video-avatar";
 var HunyuanV3 = "hunyuan-v3";
 var Ideogram45 = "ideogram-4-5";
@@ -13725,6 +13816,7 @@ var Models = {
   Happyhorse11R2v,
   Happyhorse11T2v,
   HeygenTalkingPhoto,
+  HeygenVideo1,
   HeygenVideoAvatar,
   HunyuanV3,
   Ideogram45,

package/package.json

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