@picsart/ai-sdk 6.8.0 → 6.10.0

package/index.d.ts

@@ -862,6 +862,25 @@ type ModelInputById = {
         imageUrls?: string[];
         endFrame?: string;
     };
+    "ltx-v2.3-outpaint": {
+        prompt: string;
+        videoUrl: string;
+        negativePrompt?: string;
+        aspectRatio?: "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16" | "9:21";
+        resolution?: "480p" | "720p" | "1080p";
+        numFrames?: number;
+        fps?: number;
+        sourceScale?: number;
+        videoStrength?: number;
+        cfgScale?: number;
+        numInferenceSteps?: number;
+        videoQuality?: "low" | "medium" | "high" | "maximum";
+        videoWriteMode?: "fast" | "balanced" | "small";
+        enhancePrompt?: boolean;
+        generateAudio?: boolean;
+        enableSafetyChecker?: boolean;
+        seed?: number;
+    };
     "ltx-v2.3-pro": {
         prompt: string;
         duration?: 6 | 8 | 10;
@@ -872,6 +891,11 @@ type ModelInputById = {
         imageUrls?: string[];
         endFrame?: string;
     };
+    "ltx-v2.3-reframe": {
+        videoUrl: string;
+        resolution?: "720p" | "1080p";
+        aspectRatio?: "16:9" | "9:16" | "1:1" | "4:5" | "5:4";
+    };
     "ltx-v2.3-retake": {
         prompt: string;
         duration?: number;
@@ -879,6 +903,28 @@ type ModelInputById = {
         startTime?: number;
         videoUrl: string;
     };
+    "ltx-v2.5-fast": {
+        prompt: string;
+        duration?: 6 | 8 | 10 | 12 | 14 | 16 | 18 | 20;
+        resolution?: "720p" | "1080p" | "1440p" | "2160p";
+        aspectRatio?: "16:9" | "9:16";
+        fps?: 24 | 25 | 48 | 50;
+        cameraMotion?: "none" | "static" | "dolly_in" | "dolly_out" | "dolly_left" | "dolly_right" | "jib_up" | "jib_down" | "focus_shift";
+        generateAudio?: boolean;
+        startFrame?: string;
+        endFrame?: string;
+    };
+    "ltx-v2.5-pro": {
+        prompt: string;
+        duration?: 6 | 8 | 10;
+        resolution?: "720p" | "1080p";
+        aspectRatio?: "16:9" | "9:16";
+        fps?: 24 | 25 | 50;
+        cameraMotion?: "none" | "static" | "dolly_in" | "dolly_out" | "dolly_left" | "dolly_right" | "jib_up" | "jib_down" | "focus_shift";
+        generateAudio?: boolean;
+        startFrame?: string;
+        endFrame?: string;
+    };
     "luma-ray-2": {
         prompt: string;
         aspectRatio?: "16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "21:9" | "9:21";
@@ -3099,8 +3145,12 @@ declare const Models: {
     readonly LtxV2Retake: "ltx-v2-retake";
     readonly LtxV23Extend: "ltx-v2.3-extend";
     readonly LtxV23Fast: "ltx-v2.3-fast";
+    readonly LtxV23Outpaint: "ltx-v2.3-outpaint";
     readonly LtxV23Pro: "ltx-v2.3-pro";
+    readonly LtxV23Reframe: "ltx-v2.3-reframe";
     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";

package/index.js

@@ -2111,6 +2111,34 @@ var LTX_RESOLUTIONS = ["1080p", "1440p", "2160p"];
 var LTX_23_AR = ["16:9", "9:16"];
 var LTX_23_FPS = [24, 25, 48, 50];
 var LTX_PROMPT_MAX = 5e3;
+var LTX_23_REFRAME_RESOLUTIONS = ["720p", "1080p"];
+var LTX_23_REFRAME_AR = ["16:9", "9:16", "1:1", "4:5", "5:4"];
+var LTX_23_OUTPAINT_RESOLUTIONS = ["480p", "720p", "1080p"];
+var LTX_23_OUTPAINT_AR = ["21:9", "16:9", "4:3", "1:1", "3:4", "9:16", "9:21"];
+var LTX_25_AR = ["16:9", "9:16"];
+var LTX_25_PRO_RESOLUTIONS = ["720p", "1080p"];
+var LTX_25_FAST_RESOLUTIONS = ["720p", "1080p", "1440p", "2160p"];
+var LTX_25_PRO_FPS = [24, 25, 50];
+var LTX_25_FAST_FPS = [24, 25, 48, 50];
+var LTX_25_CAMERA_MOTIONS = [
+  { id: "none", label: "None" },
+  { id: "static", label: "Static" },
+  { id: "dolly_in", label: "Dolly In" },
+  { id: "dolly_out", label: "Dolly Out" },
+  { id: "dolly_left", label: "Dolly Left" },
+  { id: "dolly_right", label: "Dolly Right" },
+  { id: "jib_up", label: "Jib Up" },
+  { id: "jib_down", label: "Jib Down" },
+  { id: "focus_shift", label: "Focus Shift" }
+];
+var LTX_25_FAST_LONG = "Videos longer than 10s render at 720p/1080p and 24 or 25 fps.";
+var ltx25FastLongConstraints = [12, 14, 16, 18, 20].map((d) => ({
+  when: { duration: { is: d } },
+  then: {
+    resolution: { allowed: ["720p", "1080p"], reason: LTX_25_FAST_LONG },
+    fps: { allowed: [24, 25], reason: LTX_25_FAST_LONG }
+  }
+}));
 var FAST_LONG = "Videos longer than 10s render at 1080p / 25 fps.";
 var ltxFastLongConstraints = [12, 14, 16, 18, 20].map((d) => ({
   when: { duration: { is: d } },
@@ -2387,6 +2415,128 @@ var { MODELS: MODELS2 } = defineModels("ltx", [
       },
       ...params.videoInput("Source Video")
     }
+  },
+  {
+    id: "ltx-v2.3-reframe",
+    name: "LTX 2.3 Reframe",
+    modelId: "fal-ai-ltx-2.3-reframe",
+    addedAt: "2026-09-23",
+    workflow: "ltx-2.3/reframe",
+    estimatedTime: 45,
+    mode: "video",
+    inputType: "v2v",
+    description: "Reframe a video into a new aspect ratio \u2014 the source is re-cropped and the newly exposed edges are generated to match. Takes no prompt.",
+    features: [feat("Video Input", "input"), feat("Aspect Ratio", "characteristic"), feat("Up to 1080p", "resolution")],
+    paramConfig: {
+      ...params.videoInput("Source Video", "asset", true),
+      ...params.resolution(LTX_23_REFRAME_RESOLUTIONS, "1080p"),
+      ...params.aspectRatio(LTX_23_REFRAME_AR)
+    }
+  },
+  {
+    // fal serves this one from the `ltx-2.3-quality` model id, hence the
+    // workflow path; `modelId` mirrors it so the pricing key reads the same.
+    id: "ltx-v2.3-outpaint",
+    name: "LTX 2.3 Outpaint",
+    modelId: "fal-ai-ltx-2.3-quality-outpaint",
+    addedAt: "2026-09-23",
+    workflow: "ltx-2.3-quality/outpaint",
+    estimatedTime: 180,
+    mode: "video",
+    inputType: "v2v",
+    description: "Expand a video past its original frame \u2014 the source stays put inside a wider canvas and the surrounding region is generated to match.",
+    features: [feat("Video Input", "input"), feat("Outpaint", "characteristic"), feat("Audio", "audio"), feat("Up to 1080p", "resolution")],
+    paramConfig: {
+      ...params.prompt({ maxLength: LTX_PROMPT_MAX }),
+      ...params.videoInput("Source Video", "asset", true),
+      ...params.negativePrompt(),
+      ...params.aspectRatio(LTX_23_OUTPAINT_AR),
+      ...params.resolution(LTX_23_OUTPAINT_RESOLUTIONS, "720p"),
+      ...p.range("numFrames", 9, 481, 121, { label: "Frames" }),
+      ...p.range("fps", 1, 60, 24, { label: "FPS" }),
+      // 1.0 fits the source as large as the canvas allows; lower values zoom it
+      // out and leave a wider generated border, which the vendor calls less stable.
+      ...p.range("sourceScale", 0.25, 1, 1, { step: 0.05, label: "Source Scale" }),
+      // How strongly the original content is preserved inside the new canvas.
+      ...p.range("videoStrength", 0, 1, 1, { step: 0.05, label: "Source Strength" }),
+      ...params.cfgScale(1, 20, 1),
+      ...p.range("numInferenceSteps", 8, 30, 15, { label: "Inference Steps" }),
+      ...p.enum("videoQuality", ["low", "medium", "high", "maximum"], "high", { label: "Video Quality" }),
+      ...p.enum("videoWriteMode", ["fast", "balanced", "small"], "balanced", { label: "Write Mode" }),
+      ...params.enhancePrompt(),
+      ...params.generateAudio(),
+      ...p.boolean("enableSafetyChecker", true, "Safety Checker"),
+      // Default-less on purpose: unset means the vendor picks a random seed.
+      ...params.seed()
+    }
+  },
+  // ── LTX 2.5 ──────────────────────────────────────────────────────
+  // One entry per tier: text-to-video on `workflow`, image-to-video on
+  // `editWorkflow`. A start or end frame is what routes a call to the image
+  // side (see `resolvePayloadBuild`), and `end_image_url` — a transition from
+  // the start frame to the end one — exists only there.
+  {
+    id: "ltx-v2.5-pro",
+    name: "LTX 2.5 Pro",
+    modelId: "fal-ai-ltx-2.5-pro",
+    addedAt: "2026-09-23",
+    workflow: "lightricks/ltx-2.5/text-to-video/pro",
+    editWorkflow: "lightricks/ltx-2.5/image-to-video/pro",
+    estimatedTime: 75,
+    editEstimatedTime: 78,
+    mode: "video",
+    inputType: "t2v",
+    description: "Quality-optimized 2.5 with synchronized native audio in a single pass \u2014 720p/1080p, 6-10s, with camera motion control.",
+    features: [feat("Image Input", "input"), feat("Start Frame", "frame"), feat("End Frame", "frame"), feat("Audio", "audio"), feat("Camera Motion", "characteristic"), feat("6/8/10 sec", "duration")],
+    paramConfig: {
+      ...params.prompt({ maxLength: LTX_PROMPT_MAX }),
+      ...params.duration(PRO_DURATIONS, 6),
+      ...params.resolution(LTX_25_PRO_RESOLUTIONS, "1080p"),
+      ...params.aspectRatio(LTX_25_AR),
+      ...p.enum("fps", LTX_25_PRO_FPS, 25, { label: "FPS" }),
+      ...p.enum("cameraMotion", LTX_25_CAMERA_MOTIONS, "none", { label: "Camera Motion" }),
+      ...params.generateAudio(),
+      ...params.startFrame("Start Frame"),
+      ...params.endFrame()
+    },
+    constraints: [
+      // end_image_url exists only on the I2V route, which a start frame triggers.
+      { when: { startFrame: { exists: false } }, then: {
+        endFrame: { disabled: true, reason: "An end frame requires a start image." }
+      } }
+    ]
+  },
+  {
+    id: "ltx-v2.5-fast",
+    name: "LTX 2.5 Fast",
+    modelId: "fal-ai-ltx-2.5-fast",
+    addedAt: "2026-09-23",
+    workflow: "lightricks/ltx-2.5/text-to-video/fast",
+    editWorkflow: "lightricks/ltx-2.5/image-to-video/fast",
+    estimatedTime: 38,
+    editEstimatedTime: 40,
+    mode: "video",
+    inputType: "t2v",
+    description: "Speed-optimized 2.5 with synchronized native audio \u2014 up to 4K, up to 20s, with camera motion control.",
+    features: [feat("Image Input", "input"), feat("Start Frame", "frame"), feat("End Frame", "frame"), feat("Fast", "duration"), feat("Up to 20s", "duration"), feat("Audio", "audio"), feat("4K", "resolution"), feat("Camera Motion", "characteristic")],
+    paramConfig: {
+      ...params.prompt({ maxLength: LTX_PROMPT_MAX }),
+      ...params.duration(FAST_DURATIONS, 6),
+      ...params.resolution(LTX_25_FAST_RESOLUTIONS, "1080p"),
+      ...params.aspectRatio(LTX_25_AR),
+      ...p.enum("fps", LTX_25_FAST_FPS, 25, { label: "FPS" }),
+      ...p.enum("cameraMotion", LTX_25_CAMERA_MOTIONS, "none", { label: "Camera Motion" }),
+      ...params.generateAudio(),
+      ...params.startFrame("Start Frame"),
+      ...params.endFrame()
+    },
+    constraints: [
+      ...ltx25FastLongConstraints,
+      // end_image_url exists only on the I2V route, which a start frame triggers.
+      { when: { startFrame: { exists: false } }, then: {
+        endFrame: { disabled: true, reason: "An end frame requires a start image." }
+      } }
+    ]
   }
 ]);
 
@@ -9642,6 +9792,107 @@ registerPayloads(MODELS3, {
   "creatify-boreal": buildCreatifyBorealPayload
 });
 
+// src/vendors/catalog/ltx.payloads.ts
+function requireStartFrame(input) {
+  if (!input.startFrame) {
+    throw new ApiError("LTX 2.5: an end frame requires a start image.", {
+      status: 400,
+      code: "validation_error"
+    });
+  }
+  return input.startFrame;
+}
+var buildLtx25ProT2VPayload = (input) => ({
+  prompt: input.prompt,
+  ...input.duration != null ? { duration: input.duration } : {},
+  ...input.resolution ? { resolution: input.resolution } : {},
+  ...input.aspectRatio ? { aspect_ratio: input.aspectRatio } : {},
+  ...input.fps != null ? { fps: input.fps } : {},
+  // `none` is the paramConfig sentinel for "leave the camera alone": the wire
+  // has no such value and omitting the field is the vendor's default. Spelled
+  // out per builder rather than shared, so the check narrows the literal union
+  // instead of widening it to `string`. (`static` is a real, locked-off camera.)
+  ...input.cameraMotion && input.cameraMotion !== "none" ? { camera_motion: input.cameraMotion } : {},
+  generate_audio: input.generateAudio ?? true
+});
+var buildLtx25ProI2VPayload = (input) => ({
+  prompt: input.prompt,
+  image_url: requireStartFrame(input),
+  ...input.endFrame ? { end_image_url: input.endFrame } : {},
+  ...input.duration != null ? { duration: input.duration } : {},
+  ...input.resolution ? { resolution: input.resolution } : {},
+  ...input.aspectRatio ? { aspect_ratio: input.aspectRatio } : {},
+  ...input.fps != null ? { fps: input.fps } : {},
+  // `none` is the paramConfig sentinel for "leave the camera alone": the wire
+  // has no such value and omitting the field is the vendor's default. Spelled
+  // out per builder rather than shared, so the check narrows the literal union
+  // instead of widening it to `string`. (`static` is a real, locked-off camera.)
+  ...input.cameraMotion && input.cameraMotion !== "none" ? { camera_motion: input.cameraMotion } : {},
+  generate_audio: input.generateAudio ?? true
+});
+var buildLtx25FastT2VPayload = (input) => ({
+  prompt: input.prompt,
+  ...input.duration != null ? { duration: input.duration } : {},
+  ...input.resolution ? { resolution: input.resolution } : {},
+  ...input.aspectRatio ? { aspect_ratio: input.aspectRatio } : {},
+  ...input.fps != null ? { fps: input.fps } : {},
+  // `none` is the paramConfig sentinel for "leave the camera alone": the wire
+  // has no such value and omitting the field is the vendor's default. Spelled
+  // out per builder rather than shared, so the check narrows the literal union
+  // instead of widening it to `string`. (`static` is a real, locked-off camera.)
+  ...input.cameraMotion && input.cameraMotion !== "none" ? { camera_motion: input.cameraMotion } : {},
+  generate_audio: input.generateAudio ?? true
+});
+var buildLtx25FastI2VPayload = (input) => ({
+  prompt: input.prompt,
+  image_url: requireStartFrame(input),
+  ...input.endFrame ? { end_image_url: input.endFrame } : {},
+  ...input.duration != null ? { duration: input.duration } : {},
+  ...input.resolution ? { resolution: input.resolution } : {},
+  ...input.aspectRatio ? { aspect_ratio: input.aspectRatio } : {},
+  ...input.fps != null ? { fps: input.fps } : {},
+  // `none` is the paramConfig sentinel for "leave the camera alone": the wire
+  // has no such value and omitting the field is the vendor's default. Spelled
+  // out per builder rather than shared, so the check narrows the literal union
+  // instead of widening it to `string`. (`static` is a real, locked-off camera.)
+  ...input.cameraMotion && input.cameraMotion !== "none" ? { camera_motion: input.cameraMotion } : {},
+  generate_audio: input.generateAudio ?? true
+});
+var buildLtx23ReframePayload = (input) => ({
+  video_url: input.videoUrl,
+  ...input.resolution ? { resolution: input.resolution } : {},
+  ...input.aspectRatio ? { aspect_ratio: input.aspectRatio } : {}
+});
+var buildLtx23OutpaintPayload = (input) => ({
+  prompt: input.prompt,
+  video_url: input.videoUrl,
+  ...input.negativePrompt ? { negative_prompt: input.negativePrompt } : {},
+  ...input.aspectRatio ? { aspect_ratio: input.aspectRatio } : {},
+  ...input.resolution ? { output_resolution: input.resolution } : {},
+  ...input.numFrames != null ? { num_frames: input.numFrames } : {},
+  ...input.fps != null ? { frames_per_second: input.fps } : {},
+  ...input.sourceScale != null ? { source_scale: input.sourceScale } : {},
+  ...input.videoStrength != null ? { video_strength: input.videoStrength } : {},
+  ...input.cfgScale != null ? { guidance_scale: input.cfgScale } : {},
+  ...input.numInferenceSteps != null ? { num_inference_steps: input.numInferenceSteps } : {},
+  ...input.videoQuality ? { video_quality: input.videoQuality } : {},
+  ...input.videoWriteMode ? { video_write_mode: input.videoWriteMode } : {},
+  ...input.seed != null ? { seed: input.seed } : {},
+  enable_prompt_expansion: input.enhancePrompt ?? true,
+  generate_audio: input.generateAudio ?? true,
+  enable_safety_checker: input.enableSafetyChecker ?? true
+});
+registerPayloads(MODELS2, {
+  "ltx-v2.5-pro": buildLtx25ProT2VPayload,
+  "ltx-v2.5-fast": buildLtx25FastT2VPayload,
+  "ltx-v2.3-reframe": buildLtx23ReframePayload,
+  "ltx-v2.3-outpaint": buildLtx23OutpaintPayload
+});
+registerEditPayloads(MODELS2, {
+  "ltx-v2.5-pro": buildLtx25ProI2VPayload,
+  "ltx-v2.5-fast": buildLtx25FastI2VPayload
+});
+
 // src/vendors/catalog/index.ts
 var ALL_MODELS = [
   ...MODELS,
@@ -12305,8 +12556,12 @@ var LtxV2Fast = "ltx-v2-fast";
 var LtxV2Retake = "ltx-v2-retake";
 var LtxV23Extend = "ltx-v2.3-extend";
 var LtxV23Fast = "ltx-v2.3-fast";
+var LtxV23Outpaint = "ltx-v2.3-outpaint";
 var LtxV23Pro = "ltx-v2.3-pro";
+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";
@@ -12546,8 +12801,12 @@ var Models = {
   LtxV2Retake,
   LtxV23Extend,
   LtxV23Fast,
+  LtxV23Outpaint,
   LtxV23Pro,
+  LtxV23Reframe,
   LtxV23Retake,
+  LtxV25Fast,
+  LtxV25Pro,
   LumaRay2,
   LumaRay2ReframeVideo,
   LumaRay32,

package/package.json

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