@picsart/ai-sdk 6.23.0 → 6.25.0

package/index.d.ts

@@ -342,8 +342,8 @@ type ModelInputById = {
     };
     "flux-3-image": {
         prompt: string;
-        aspectRatio?: "auto" | "21:9" | "2:1" | "16:9" | "3:2" | "7:5" | "4:3" | "5:4" | "1:1" | "4:5" | "3:4" | "5:7" | "2:3" | "9:16" | "1:2";
-        resolution?: "512sq" | "768sq" | "1k" | "2k" | "4k";
+        aspectRatio?: "auto" | "21:9" | "2:1" | "16:9" | "3:2" | "7:5" | "4:3" | "5:4" | "1:1" | "4:5" | "3:4" | "5:7" | "2:3" | "9:16" | "9:21" | "1:2";
+        resolution?: "768sq" | "1k" | "1.5k" | "2k" | "4k";
         count?: 1 | 2 | 4 | 6 | 8 | 10;
         imageUrls?: string[];
         safetyTolerance?: number;
@@ -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";
@@ -1073,19 +1085,6 @@ type ModelInputById = {
         startFrame?: string;
         endFrame?: string;
     };
-    "luma-ray-2": {
-        prompt: string;
-        aspectRatio?: "16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "21:9" | "9:21";
-        resolution?: "540p" | "720p" | "1080p" | "4k";
-        duration?: 5 | 9;
-        startFrame?: string;
-        endFrame?: string;
-    };
-    "luma-ray-2-reframe-video": {
-        prompt?: string;
-        aspectRatio?: "16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "21:9" | "9:21";
-        videoUrl: string;
-    };
     "luma-ray-3.2": {
         prompt: string;
         aspectRatio?: "9:16" | "3:4" | "1:1" | "4:3" | "16:9" | "21:9";
@@ -1112,19 +1111,6 @@ type ModelInputById = {
         videoUrl: string;
         resolution?: "540p" | "720p" | "1080p";
     };
-    "luma-ray-flash-2": {
-        prompt: string;
-        aspectRatio?: "16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "21:9" | "9:21";
-        resolution?: "540p" | "720p" | "1080p" | "4k";
-        duration?: 5 | 9;
-        startFrame: string;
-        endFrame?: string;
-    };
-    "luma-ray-flash-2-reframe-video": {
-        prompt?: string;
-        aspectRatio?: "16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "21:9" | "9:21";
-        videoUrl: string;
-    };
     "luma-uni-1": {
         prompt: string;
         aspectRatio?: "3:1" | "2:1" | "16:9" | "3:2" | "1:1" | "2:3" | "9:16" | "1:2" | "1:3";
@@ -3387,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";
@@ -3423,13 +3410,9 @@ declare const Models: {
     readonly LtxV23Retake: "ltx-v2.3-retake";
     readonly LtxV25Fast: "ltx-v2.5-fast";
     readonly LtxV25Pro: "ltx-v2.5-pro";
-    readonly LumaRay2: "luma-ray-2";
-    readonly LumaRay2ReframeVideo: "luma-ray-2-reframe-video";
     readonly LumaRay32: "luma-ray-3.2";
     readonly LumaRay32Edit: "luma-ray-3.2-edit";
     readonly LumaRay32ReframeVideo: "luma-ray-3.2-reframe-video";
-    readonly LumaRayFlash2: "luma-ray-flash-2";
-    readonly LumaRayFlash2ReframeVideo: "luma-ray-flash-2-reframe-video";
     readonly LumaUni1: "luma-uni-1";
     readonly LumaUni1Max: "luma-uni-1-max";
     readonly Lyria3Clip: "lyria-3-clip";

package/index.js

@@ -3881,52 +3881,7 @@ registerPayloads(MODELS11, {
 });
 
 // src/vendors/catalog/luma.ts
-var buildLumaRay2Payload = (ctx) => {
-  const keyframes = {};
-  if (ctx.startFrame) keyframes.frame0 = { type: "image", url: ctx.startFrame };
-  if (ctx.endFrame) keyframes.frame1 = { type: "image", url: ctx.endFrame };
-  return {
-    prompt: ctx.prompt,
-    model: "ray-2",
-    ...Object.keys(keyframes).length ? { keyframes } : {},
-    aspect_ratio: ctx.aspectRatio ?? "16:9",
-    resolution: ctx.resolution ?? "720p",
-    duration: `${ctx.duration ?? 5}s`
-  };
-};
-var buildLumaFlash2I2VPayload = (ctx) => {
-  const keyframes = {};
-  if (ctx.startFrame) keyframes.frame0 = { type: "image", url: ctx.startFrame };
-  if (ctx.endFrame) keyframes.frame1 = { type: "image", url: ctx.endFrame };
-  return {
-    prompt: ctx.prompt,
-    model: "ray-flash-2",
-    ...Object.keys(keyframes).length ? { keyframes } : {},
-    aspect_ratio: ctx.aspectRatio ?? "16:9",
-    resolution: ctx.resolution ?? "720p",
-    duration: `${ctx.duration ?? 5}s`
-  };
-};
-var WORKFLOW = "luma-image-to-video-generation";
-var REFRAME_WORKFLOW = "luma-media-reframe";
-var makeReframeVideoPayload = (model) => (ctx) => ({
-  generation_type: "reframe_video",
-  model,
-  media: { url: ctx.videoUrl ?? "" },
-  aspect_ratio: ctx.aspectRatio ?? "16:9",
-  ...ctx.prompt ? { prompt: ctx.prompt } : {}
-});
-var buildLumaRay2ReframeVideoPayload = makeReframeVideoPayload("ray-2");
-var buildLumaRayFlash2ReframeVideoPayload = makeReframeVideoPayload("ray-flash-2");
-var LUMA_AR = ["16:9", "9:16", "1:1", "4:3", "3:4", "21:9", "9:21"];
-var LUMA_RESOLUTIONS = ["540p", "720p", "1080p", "4k"];
 var LUMA_PROMPT_MAX = 5e3;
-var lumaParamConfig = {
-  ...params.prompt({ maxLength: LUMA_PROMPT_MAX }),
-  ...params.aspectRatio(LUMA_AR),
-  ...params.resolution(LUMA_RESOLUTIONS, "720p"),
-  ...params.duration([5, 9], 5)
-};
 var LUMA_UNI1_AR = ["3:1", "2:1", "16:9", "3:2", "1:1", "2:3", "9:16", "1:2", "1:3"];
 var LUMA_UNI1_STYLES = [
   { id: "auto", label: "Auto" },
@@ -4025,71 +3980,6 @@ var ray32EditConstraints = [
   } }
 ];
 var { MODELS: MODELS12 } = defineModels("luma", [
-  {
-    id: "luma-ray-2",
-    name: "Luma Ray 2",
-    addedAt: "2026-02-06",
-    workflow: WORKFLOW,
-    editWorkflow: WORKFLOW,
-    buildPayload: buildLumaRay2Payload,
-    estimatedTime: 18,
-    editEstimatedTime: 24,
-    mode: "video",
-    inputType: "t2v",
-    description: "Smooth video with a dreamy, polished aesthetic \u2014 up to 4K resolution.",
-    features: [feat("Image Input", "input"), feat("Start/End Frame", "frame"), feat("Up to 4K", "resolution"), feat("5/9 sec", "duration")],
-    paramConfig: { ...lumaParamConfig, ...params.startFrame(), ...params.endFrame() }
-  },
-  {
-    id: "luma-ray-flash-2",
-    name: "Luma Flash 2",
-    addedAt: "2026-02-06",
-    workflow: WORKFLOW,
-    buildPayload: buildLumaFlash2I2VPayload,
-    estimatedTime: 9,
-    mode: "video",
-    inputType: "i2v",
-    description: "Quick image-to-video with smooth, stylized motion \u2014 up to 4K.",
-    features: [feat("Image Input", "input"), feat("Start/End Frame", "frame"), feat("Up to 4K", "resolution"), feat("5/9 sec", "duration")],
-    paramConfig: { ...lumaParamConfig, ...params.startFrame("Start Frame", true), ...params.endFrame() }
-  },
-  // ── Reframe video (ray-2 + ray-flash-2; image reframe not supported) ──
-  {
-    id: "luma-ray-2-reframe-video",
-    name: "Luma Ray 2 Reframe",
-    modelId: "luma-ray-2",
-    addedAt: "2026-05-21",
-    workflow: REFRAME_WORKFLOW,
-    buildPayload: buildLumaRay2ReframeVideoPayload,
-    estimatedTime: 20,
-    mode: "video",
-    inputType: "v2v",
-    description: "Reframe a video to a new aspect ratio using Luma Ray 2.",
-    features: [feat("Video Input", "input"), feat("Reframe", "characteristic")],
-    paramConfig: {
-      ...params.prompt({ required: false, maxLength: LUMA_PROMPT_MAX }),
-      ...params.aspectRatio(LUMA_AR, "16:9"),
-      ...params.videoInput("Source Video")
-    }
-  },
-  {
-    id: "luma-ray-flash-2-reframe-video",
-    name: "Luma Flash 2 Reframe",
-    modelId: "luma-ray-flash-2",
-    addedAt: "2026-05-21",
-    workflow: REFRAME_WORKFLOW,
-    buildPayload: buildLumaRayFlash2ReframeVideoPayload,
-    estimatedTime: 12,
-    mode: "video",
-    inputType: "v2v",
-    description: "Reframe a video to a new aspect ratio using Luma Flash 2.",
-    features: [feat("Video Input", "input"), feat("Reframe", "characteristic")],
-    paramConfig: {
-      ...params.prompt({ required: false, maxLength: LUMA_PROMPT_MAX }),
-      ...params.aspectRatio(LUMA_AR, "16:9"),
-      ...params.videoInput("Source Video")
-    }
-  },
   {
     id: "luma-uni-1",
     name: "Luma UNI-1",
@@ -6231,9 +6121,10 @@ var flux3ImageAspectRatios = [
   "5:7",
   "2:3",
   "9:16",
+  "9:21",
   "1:2"
 ];
-var flux3ImageResolutions = ["512sq", "768sq", "1k", "2k", "4k"];
+var flux3ImageResolutions = ["768sq", "1k", "1.5k", "2k", "4k"];
 var buildFluxV2Payload = (modelId) => (ctx) => ({
   prompt: ctx.prompt,
   model: modelId,
@@ -6402,7 +6293,7 @@ var { MODELS: MODELS21 } = defineModels("flux", [
     // count (up to 10) samples further into the tail. Stage has seen 4+ minutes,
     // and one 512sq run took 287s. Over-estimating only makes the bar finish
     // early; under-estimating parks it at 99%.
-    estimatedTime: { "512sq": 90, "768sq": 110, "1k": 150, "2k": 240, "4k": 360 },
+    estimatedTime: { "768sq": 110, "1k": 150, "1.5k": 195, "2k": 240, "4k": 360 },
     description: "Generate and edit images with up to 10 references \u2014 multi-reference composition, precise local edits and text rendering, natively up to 4K.",
     features: [
       feat("Multi-Image Input", "input"),
@@ -7859,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) ────────────────────────────────────────────
   {
@@ -7913,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,
@@ -13579,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";
@@ -13615,13 +13597,9 @@ var LtxV23Reframe = "ltx-v2.3-reframe";
 var LtxV23Retake = "ltx-v2.3-retake";
 var LtxV25Fast = "ltx-v2.5-fast";
 var LtxV25Pro = "ltx-v2.5-pro";
-var LumaRay2 = "luma-ray-2";
-var LumaRay2ReframeVideo = "luma-ray-2-reframe-video";
 var LumaRay32 = "luma-ray-3.2";
 var LumaRay32Edit = "luma-ray-3.2-edit";
 var LumaRay32ReframeVideo = "luma-ray-3.2-reframe-video";
-var LumaRayFlash2 = "luma-ray-flash-2";
-var LumaRayFlash2ReframeVideo = "luma-ray-flash-2-reframe-video";
 var LumaUni1 = "luma-uni-1";
 var LumaUni1Max = "luma-uni-1-max";
 var Lyria3Clip = "lyria-3-clip";
@@ -13838,6 +13816,7 @@ var Models = {
   Happyhorse11R2v,
   Happyhorse11T2v,
   HeygenTalkingPhoto,
+  HeygenVideo1,
   HeygenVideoAvatar,
   HunyuanV3,
   Ideogram45,
@@ -13874,13 +13853,9 @@ var Models = {
   LtxV23Retake,
   LtxV25Fast,
   LtxV25Pro,
-  LumaRay2,
-  LumaRay2ReframeVideo,
   LumaRay32,
   LumaRay32Edit,
   LumaRay32ReframeVideo,
-  LumaRayFlash2,
-  LumaRayFlash2ReframeVideo,
   LumaUni1,
   LumaUni1Max,
   Lyria3Clip,

package/package.json

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