@picsart/ai-sdk 5.38.0 → 5.40.0

package/index.d.ts

@@ -566,9 +566,11 @@ type ModelInputById = {
     };
     "ideogram-v4": {
         prompt: string;
-        resolution?: "2048x2048" | "1440x2880" | "2880x1440" | "1664x2496" | "2496x1664" | "1792x2240" | "2240x1792" | "1440x2560" | "2560x1440" | "1600x2560" | "2560x1600" | "1728x2304" | "2304x1728" | "1296x3168" | "3168x1296" | "1152x2944" | "2944x1152" | "1248x3328" | "3328x1248" | "1280x3072" | "3072x1280";
+        resolution?: "2048x2048" | "1440x2880" | "2880x1440" | "1664x2496" | "2496x1664" | "1792x2240" | "2240x1792" | "1440x2560" | "2560x1440" | "1600x2560" | "2560x1600" | "1728x2304" | "2304x1728" | "1296x3168" | "3168x1296" | "1152x2944" | "2944x1152" | "1248x3328" | "3328x1248" | "1280x3072" | "3072x1280" | "1024x3072" | "3072x1024" | "1024x1024" | "896x1120" | "1120x896" | "864x1152" | "1152x864" | "832x1248" | "1248x832" | "800x1280" | "1280x800" | "720x1280" | "1280x720" | "720x1440" | "1440x720" | "512x1536" | "1536x512";
         renderingSpeed?: "TURBO" | "DEFAULT" | "QUALITY";
         enableCopyrightDetection?: boolean;
+        imageUrls?: string[];
+        imageWeight?: number;
     };
     "kling-3.0-image": {
         prompt: string;
@@ -876,6 +878,21 @@ type ModelInputById = {
         seed?: number;
         enableSafetyChecker?: boolean;
     };
+    "minimax-h3-max-camera-controls": {
+        prompt?: string;
+        startFrame: string;
+        resolution?: "480p" | "768p" | "1080p";
+        duration?: number;
+        cameraTrajectory?: Array<{
+            time: number;
+            azimuth: number;
+            elevation: number;
+            distance: number;
+        }>;
+        promptExpansionMode?: "balanced" | "quality";
+        seed?: number;
+        enableSafetyChecker?: boolean;
+    };
     "minimax-h3-max-turbo": {
         prompt: string;
         startFrame?: string;
@@ -2781,6 +2798,7 @@ declare const Models: {
     readonly Minimax02Hd: "minimax-02-hd";
     readonly MinimaxH3: "minimax-h3";
     readonly MinimaxH3Max: "minimax-h3-max";
+    readonly MinimaxH3MaxCameraControls: "minimax-h3-max-camera-controls";
     readonly MinimaxH3MaxTurbo: "minimax-h3-max-turbo";
     readonly MinimaxMusicV2: "minimax-music-v2";
     readonly MinimaxMusicV3: "minimax-music-v3";

package/index.js

@@ -6942,6 +6942,60 @@ var { MODELS: MODELS25 } = defineModels("minimax", [
         aspectRatio: { disabled: true, reason: "Aspect ratio follows the frame image." }
       } }
     ]
+  },
+  {
+    // Camera-controls sibling of minimax-h3-max: animates a single start
+    // frame along scripted camera keyframes. The prompt is optional — blank
+    // freezes the scene and moves only the camera. No aspect ratio on this
+    // wire; the output follows the frame image.
+    id: "minimax-h3-max-camera-controls",
+    name: "MiniMax H3 Max Camera Controls",
+    modelId: "fal-ai-h3-max-camera-controls",
+    addedAt: "2026-09-14",
+    workflow: "minimax/h3-max/camera-controls",
+    estimatedTime: 5,
+    mode: "video",
+    inputType: "i2v",
+    description: "MiniMax H3 Max video from a start frame with scripted camera motion \u2014 2-12 keyframes set the camera angle, height, and distance over time. Leave the prompt blank to freeze the scene and move only the camera. Up to 15s at 1080p.",
+    features: [
+      feat("Camera Controls", "characteristic"),
+      feat("Image Input", "input"),
+      feat("1080p", "resolution"),
+      feat("5-15 sec", "duration")
+    ],
+    paramConfig: {
+      ...params.prompt({
+        maxLength: H3_MAX_PROMPT_MAX,
+        required: false,
+        placeholder: "Optional \u2014 leave blank to freeze the scene and move only the camera..."
+      }),
+      ...params.startFrame("Start Frame", true),
+      // Native 480p default here (the siblings default to 768p); 1080p is a
+      // latent refinement of a native 768p generation.
+      ...params.resolution(["480p", "768p", "1080p"], "480p"),
+      ...params.durationRange(5, 15, 5),
+      // Ordered camera keyframes: the first pose is held before its time and
+      // the final pose for the remainder. Azimuth keeps signed full turns,
+      // capped at ±32 turns of total travel; distance is in normalized scene
+      // units and must stay above zero (the wire has no upper bound).
+      cameraTrajectory: {
+        label: "Camera Trajectory",
+        descriptor: {
+          kind: "object",
+          array: { min: 2, max: 12 },
+          fields: {
+            time: { kind: "range", min: 0, max: 1, step: 0.01, default: 0 },
+            azimuth: { kind: "range", min: -11520, max: 11520, default: 0 },
+            elevation: { kind: "range", min: -90, max: 90, default: 0 },
+            distance: { kind: "range", min: 0.01, max: 100, default: 1 }
+          }
+        }
+      },
+      ...p.enum("promptExpansionMode", ["balanced", "quality"], "balanced", { label: "Prompt Expansion" }),
+      // -1 (sentinel) means "pick a random seed"; the builder drops it.
+      ...p.range("seed", -1, 2147483647, -1),
+      ...p.boolean("enableSafetyChecker", true, "Safety Checker")
+    }
   }
 ]);
 
@@ -7001,10 +7055,25 @@ var buildMinimaxH3MaxTurboPayload = (input) => ({
   ...input.seed != null && input.seed !== -1 ? { seed: input.seed } : {},
   enable_safety_checker: input.enableSafetyChecker ?? true
 });
+var buildMinimaxH3MaxCameraControlsPayload = (input) => ({
+  // Blank prompt is meaningful upstream — fal substitutes its frozen-scene
+  // default — so it is omitted rather than sent empty.
+  ...input.prompt ? { prompt: input.prompt } : {},
+  image_url: input.startFrame,
+  ...input.cameraTrajectory?.length ? { camera_trajectory: input.cameraTrajectory } : {},
+  prompt_expansion_mode: input.promptExpansionMode ?? "balanced",
+  duration: input.duration ?? 5,
+  // The vendor enum is uppercase; paramConfig keeps the lowercase form.
+  resolution: (input.resolution ?? "480p").toUpperCase(),
+  // -1 is the paramConfig sentinel for "random seed" — omit it on the wire.
+  ...input.seed != null && input.seed !== -1 ? { seed: input.seed } : {},
+  enable_safety_checker: input.enableSafetyChecker ?? true
+});
 registerPayloads(MODELS25, {
   "minimax-music-v3": buildMinimaxMusicV3Payload,
   "minimax-h3-max": buildMinimaxH3MaxPayload,
-  "minimax-h3-max-turbo": buildMinimaxH3MaxTurboPayload
+  "minimax-h3-max-turbo": buildMinimaxH3MaxTurboPayload,
+  "minimax-h3-max-camera-controls": buildMinimaxH3MaxCameraControlsPayload
 });
 registerEditPayloads(MODELS25, {
   "minimax-h3-max-turbo": buildMinimaxH3MaxTurboPayload
@@ -7046,6 +7115,13 @@ var buildIdeogramV4GeneratePayload = (ctx) => ({
   ...ctx.renderingSpeed ? { rendering_speed: ctx.renderingSpeed } : {},
   ...ctx.enableCopyrightDetection ? { enable_copyright_detection: true } : {}
 });
+var buildIdeogramV4RemixPayload = (ctx) => ({
+  text_prompt: ctx.prompt,
+  image: ctx.startFrame ?? ctx.imageUrls?.[0],
+  ...ctx.imageWeight != null ? { image_weight: ctx.imageWeight } : {},
+  ...ctx.renderingSpeed ? { rendering_speed: ctx.renderingSpeed } : {},
+  ...ctx.enableCopyrightDetection ? { enable_copyright_detection: true } : {}
+});
 var buildIdeogramPImagePayload = (ctx) => ({
   prompt: ctx.prompt,
   resolution: ctx.resolution ?? "1024x1024",
@@ -7057,15 +7133,18 @@ var { MODELS: MODELS26 } = defineModels("ideogram", [
     name: "Ideogram 4.0",
     addedAt: "2026-06-03",
     workflow: "ideogram/v4/generate",
+    editWorkflow: "ideogram/v4/remix",
     buildPayload: buildIdeogramV4GeneratePayload,
+    buildEditPayload: buildIdeogramV4RemixPayload,
     estimatedTime: 20,
     mode: "image",
     inputType: "t2i",
     description: "Ideogram's latest model \u2014 class-leading text rendering at up to ~3K resolution.",
-    features: [feat("Text Rendering", "style"), feat("Up to 3K", "resolution")],
+    features: [feat("Text Rendering", "style"), feat("Up to 3K", "resolution"), feat("Image Remix", "input")],
     paramConfig: {
       ...params.prompt(),
       ...params.resolution([
+        // 2K bucket (~3–4 MP)
         "2048x2048",
         "1440x2880",
         "2880x1440",
@@ -7086,14 +7165,36 @@ var { MODELS: MODELS26 } = defineModels("ideogram", [
         "1248x3328",
         "3328x1248",
         "1280x3072",
-        "3072x1280"
+        "3072x1280",
+        "1024x3072",
+        "3072x1024",
+        // 1K bucket (~1 MP)
+        "1024x1024",
+        "896x1120",
+        "1120x896",
+        "864x1152",
+        "1152x864",
+        "832x1248",
+        "1248x832",
+        "800x1280",
+        "1280x800",
+        "720x1280",
+        "1280x720",
+        "720x1440",
+        "1440x720",
+        "512x1536",
+        "1536x512"
       ], "2048x2048"),
       ...params.renderingSpeed([
         { id: "TURBO", label: "Turbo" },
         { id: "DEFAULT", label: "Balanced" },
         { id: "QUALITY", label: "Quality" }
       ], "DEFAULT"),
-      ...p.boolean("enableCopyrightDetection", false, "Copyright Detection")
+      ...p.boolean("enableCopyrightDetection", false, "Copyright Detection"),
+      // Remix (editWorkflow) inputs — an image switches the request to
+      // ideogram/v4/remix. Weight minimum is 1; the API rejects 0.
+      ...params.imageInput(1, "Source Image"),
+      ...params.imageWeight(1, 100, 50, 5)
     }
   },
   {
@@ -11545,6 +11646,7 @@ var Lyria35 = "lyria-3.5";
 var Minimax02Hd = "minimax-02-hd";
 var MinimaxH3 = "minimax-h3";
 var MinimaxH3Max = "minimax-h3-max";
+var MinimaxH3MaxCameraControls = "minimax-h3-max-camera-controls";
 var MinimaxH3MaxTurbo = "minimax-h3-max-turbo";
 var MinimaxMusicV2 = "minimax-music-v2";
 var MinimaxMusicV3 = "minimax-music-v3";
@@ -11770,6 +11872,7 @@ var Models = {
   Minimax02Hd,
   MinimaxH3,
   MinimaxH3Max,
+  MinimaxH3MaxCameraControls,
   MinimaxH3MaxTurbo,
   MinimaxMusicV2,
   MinimaxMusicV3,

package/package.json

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