@picsart/ai-sdk 6.51.2 → 6.53.0

package/index.d.ts

@@ -379,6 +379,27 @@ type ModelInputById = {
         steps?: number;
         safetyTolerance?: number;
     };
+    "flux-3-max": {
+        prompt: string;
+        startFrame?: string;
+        endFrame?: string;
+        aspectRatio?: "auto" | "21:9" | "2:1" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16";
+        resolution?: "720p" | "1080p";
+        duration?: number;
+        generateAudio?: boolean;
+        reasoningLevel?: "low" | "high";
+        seed?: number;
+    };
+    "flux-3-max-keyframes": {
+        prompt: string;
+        imageUrls: [string, ...string[]];
+        aspectRatio?: "auto" | "21:9" | "2:1" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16";
+        resolution?: "720p" | "1080p";
+        duration?: number;
+        generateAudio?: boolean;
+        reasoningLevel?: "low" | "high";
+        seed?: number;
+    };
     "flux-3-video": {
         prompt: string;
         aspectRatio?: "auto" | "21:9" | "2:1" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16";
@@ -910,6 +931,18 @@ type ModelInputById = {
         imageUrls?: string[];
         imageWeight?: number;
     };
+    "ideogram-vector-1": {
+        prompt: string;
+        imageUrls?: string[];
+        aspectRatio?: "auto" | "1:1" | "16:9" | "9:16" | "4:3" | "3:4" | "3:2" | "2:3" | "5:4" | "4:5" | "16:10" | "10:16" | "2:1" | "1:2" | "3:1" | "1:3" | "4:1" | "1:4";
+        quality?: "low" | "medium" | "high";
+        count?: 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;
+        seed?: number;
+    };
+    "ideogram-vector-1-vectorize": {
+        startFrame: string;
+        mode?: "default" | "simple";
+    };
     "kimi-k3": {
         prompt: string;
         imageUrls?: string[];
@@ -3544,6 +3577,8 @@ declare const Models: {
     readonly Flux2Pro: "flux-2-pro";
     readonly Flux3Image: "flux-3-image";
     readonly Flux3ImageKlein: "flux-3-image-klein";
+    readonly Flux3Max: "flux-3-max";
+    readonly Flux3MaxKeyframes: "flux-3-max-keyframes";
     readonly Flux3Video: "flux-3-video";
     readonly FluxKontextMax: "flux-kontext-max";
     readonly FluxKontextPro: "flux-kontext-pro";
@@ -3617,6 +3652,8 @@ declare const Models: {
     readonly IdeogramPImage: "ideogram-p-image";
     readonly IdeogramV3: "ideogram-v3";
     readonly IdeogramV4: "ideogram-v4";
+    readonly IdeogramVector1: "ideogram-vector-1";
+    readonly IdeogramVector1Vectorize: "ideogram-vector-1-vectorize";
     readonly KimiK3: "kimi-k3";
     readonly Kling30Image: "kling-3.0-image";
     readonly KlingAvatar: "kling-avatar";

package/index.js

@@ -6283,6 +6283,7 @@ var flux3ImageAspectRatios = [
   "9:21",
   "1:2"
 ];
+var flux3MaxAspectRatios = ["auto", "21:9", "2:1", "16:9", "4:3", "1:1", "3:4", "9:16"];
 var flux3ImageResolutions = ["768sq", "1k", "1.5k", "2k", "4k"];
 var buildFluxV2Payload = (modelId) => (ctx) => ({
   prompt: ctx.prompt,
@@ -6610,6 +6611,84 @@ var { MODELS: MODELS20 } = defineModels("flux", [
       // Moderation level: 0 (strict) … 4 (permissive).
       ...p.range("safetyTolerance", 0, 4, 2, { label: "Safety Tolerance" })
     }
+  },
+  {
+    // FLUX 3 Max video — text-to-video, or image-to-video from a start (and
+    // optional end) frame: a frame routes to the `flux-3-max/image-to-video`
+    // endpoint via editWorkflow. Keyframe interpolation is its own entry
+    // (flux-3-max-keyframes) because routing has only two slots. The worker
+    // forwards the command straight to fal, so the builders emit fal snake_case.
+    id: "flux-3-max",
+    name: "Flux 3 Max",
+    modelId: "fal-ai-flux-3-max",
+    workflow: "flux-3-max/text-to-video",
+    editWorkflow: "flux-3-max/image-to-video",
+    mode: "video",
+    inputType: "t2v",
+    addedAt: "2026-10-21",
+    estimatedTime: 60,
+    description: "Text-to-video with synchronized audio, or image-to-video from a start (and optional end) frame. Up to 20s at 1080p.",
+    features: [
+      feat("Start/End Frame", "frame"),
+      feat("Audio", "audio"),
+      feat("Up to 20s", "duration"),
+      feat("1080p", "resolution")
+    ],
+    paramConfig: {
+      ...params.prompt(),
+      // A start frame routes to image-to-video (image_url); end frame is the
+      // optional end_image_url.
+      ...params.startFrame("Start Frame", false),
+      ...params.endFrame("End Frame"),
+      ...params.aspectRatio(flux3MaxAspectRatios, "16:9"),
+      ...params.resolution(["720p", "1080p"], "720p"),
+      ...params.durationRange(5, 20, 5),
+      ...params.generateAudio(true),
+      // Vendor reasoning tier for the planner; vendor default high.
+      ...p.enum("reasoningLevel", ["low", "high"], "high", { label: "Reasoning" }),
+      // -1 (sentinel) means "pick a random seed"; the builder drops it.
+      ...p.range("seed", -1, 2147483647, -1)
+    },
+    constraints: [
+      // image-to-video requires image_url; end_image_url alone is invalid. An
+      // end frame is only ever a second keyframe, so require a start frame
+      // whenever one is supplied rather than let the request reach fal and 400.
+      { when: { endFrame: { exists: true } }, then: {
+        startFrame: { required: true, reason: "An end frame needs a start frame \u2014 image-to-video animates from the start image." }
+      } }
+    ]
+  },
+  {
+    // Keyframe-interpolation sibling: 1–10 positioned images animate into a
+    // video via `flux-3-max/keyframes-to-video`. Shares the image-to-video
+    // pricing tier (same modelId). The images are spaced evenly across the
+    // 24 fps timeline in flux.payloads.ts.
+    id: "flux-3-max-keyframes",
+    name: "Flux 3 Max Keyframes",
+    modelId: "fal-ai-flux-3-max",
+    workflow: "flux-3-max/keyframes-to-video",
+    mode: "video",
+    inputType: "i2v",
+    addedAt: "2026-10-21",
+    estimatedTime: 60,
+    description: "Animate a video between up to 10 positioned keyframe images, with synchronized audio. Up to 20s at 1080p.",
+    features: [
+      feat("Multi-Image Input", "input"),
+      feat("Audio", "audio"),
+      feat("Up to 20s", "duration"),
+      feat("1080p", "resolution")
+    ],
+    paramConfig: {
+      ...params.prompt(),
+      // imageUrls → keyframes[]; combined ≤10 is backend-enforced.
+      ...params.imageInput(10, "Keyframes", true, "asset"),
+      ...params.aspectRatio(flux3MaxAspectRatios, "16:9"),
+      ...params.resolution(["720p", "1080p"], "720p"),
+      ...params.durationRange(5, 20, 5),
+      ...params.generateAudio(true),
+      ...p.enum("reasoningLevel", ["low", "high"], "high", { label: "Reasoning" }),
+      ...p.range("seed", -1, 2147483647, -1)
+    }
   }
 ]);
 
@@ -6634,6 +6713,45 @@ var buildFlux3VideoPayload = (input) => {
 registerPayloads(MODELS20, {
   "flux-3-video": buildFlux3VideoPayload
 });
+var flux3MaxShared = (i) => ({
+  aspect_ratio: i.aspectRatio ?? "16:9",
+  resolution: i.resolution ?? "720p",
+  duration: Number(i.duration ?? 5),
+  generate_audio: i.generateAudio ?? true,
+  reasoning_level: i.reasoningLevel ?? "high",
+  // -1 is the "random seed" sentinel — omit so fal picks one.
+  ...i.seed != null && i.seed !== -1 ? { seed: i.seed } : {}
+});
+var buildFlux3MaxPayload = (i) => ({
+  prompt: i.prompt,
+  ...flux3MaxShared(i)
+});
+var buildFlux3MaxEditPayload = (i) => ({
+  prompt: i.prompt,
+  image_url: i.startFrame,
+  ...i.endFrame ? { end_image_url: i.endFrame } : {},
+  ...flux3MaxShared(i)
+});
+var buildFlux3MaxKeyframesPayload = (i) => {
+  const imgs = i.imageUrls ?? [];
+  const last = Number(i.duration ?? 5) * 24;
+  const keyframes = imgs.map((url, idx) => ({
+    image_url: url,
+    frame_index: imgs.length <= 1 ? 0 : Math.round(last * idx / (imgs.length - 1))
+  }));
+  return {
+    prompt: i.prompt,
+    keyframes,
+    ...flux3MaxShared(i)
+  };
+};
+registerPayloads(MODELS20, {
+  "flux-3-max": buildFlux3MaxPayload,
+  "flux-3-max-keyframes": buildFlux3MaxKeyframesPayload
+});
+registerEditPayloads(MODELS20, {
+  "flux-3-max": buildFlux3MaxEditPayload
+});
 
 // src/vendors/catalog/gemini.ts
 function buildThinkingConfig(ctx) {
@@ -8461,7 +8579,75 @@ var ideogram45Constraints = [
     resolution: { disabled: true, reason: "The output keeps the source image size." }
   } }
 ];
+var IDEOGRAM_VECTOR_IMAGE_BOUNDS = {
+  maxBytes: 50 * 1024 * 1024
+};
+var IDEOGRAM_VECTOR_ASPECT_RATIOS = [
+  "auto",
+  "1:1",
+  "16:9",
+  "9:16",
+  "4:3",
+  "3:4",
+  "3:2",
+  "2:3",
+  "5:4",
+  "4:5",
+  "16:10",
+  "10:16",
+  "2:1",
+  "1:2",
+  "3:1",
+  "1:3",
+  "4:1",
+  "1:4"
+];
+var IDEOGRAM_VECTOR_QUALITIES = ["low", "medium", "high"];
 var { MODELS: MODELS25 } = defineModels("ideogram", [
+  {
+    id: "ideogram-vector-1",
+    name: "Ideogram Vector",
+    addedAt: "2026-10-21",
+    workflow: "ideogram/vector/generate",
+    // The worker returns SVG and exposes no format param.
+    outputExtension: "svg",
+    estimatedTime: 30,
+    mode: "image",
+    inputType: "t2i",
+    description: "Ideogram Vector \u2014 SVG logos, icons and illustrations from a prompt, optionally guided by up to 5 reference images.",
+    features: [feat("Vector/SVG", "characteristic"), feat("Reference Images", "input")],
+    paramConfig: {
+      ...params.prompt({ maxLength: 9500 }),
+      // imageUrls[0] is the primary source; the rest are additional references.
+      ...params.imageInput(5, "Reference Images", false, "reference", IDEOGRAM_VECTOR_IMAGE_BOUNDS),
+      ...params.aspectRatio(IDEOGRAM_VECTOR_ASPECT_RATIOS, "auto"),
+      ...p.quality(IDEOGRAM_VECTOR_QUALITIES, "medium"),
+      ...params.count(IDEOGRAM_45_COUNTS, 1),
+      ...params.seed()
+    }
+  },
+  {
+    id: "ideogram-vector-1-vectorize",
+    name: "Ideogram Vectorize",
+    addedAt: "2026-10-21",
+    workflow: "ideogram/vector/vectorize",
+    syncExecute: true,
+    // The worker returns SVG and exposes no format param.
+    outputExtension: "svg",
+    estimatedTime: 8,
+    mode: "image",
+    inputType: "i2i",
+    description: "Ideogram Vectorize \u2014 convert a raster image (JPEG, PNG or WebP) into an SVG.",
+    features: [feat("Vector/SVG", "characteristic"), feat("Image to SVG", "input")],
+    paramConfig: {
+      ...params.startFrame("Source Image", true, IDEOGRAM_VECTOR_IMAGE_BOUNDS),
+      // `simple` traces fewer, simpler shapes; `default` preserves finer details.
+      ...p.enum("mode", [
+        { id: "default", label: "Detailed" },
+        { id: "simple", label: "Simple" }
+      ], "default", { label: "Detail" })
+    }
+  },
   {
     id: "ideogram-4-5",
     name: "Ideogram 4.5",
@@ -8760,9 +8946,23 @@ var buildIdeogram45PreciseEditPayload = (input) => {
     ...input.enableCopyrightDetection ? { enable_copyright_detection: true } : {}
   };
 };
+var buildIdeogramVectorPayload = (input) => ({
+  prompt: input.prompt,
+  ...input.imageUrls?.length ? { images: input.imageUrls } : {},
+  ...input.aspectRatio ? { aspect_ratio: input.aspectRatio } : {},
+  quality: input.quality ?? "medium",
+  num_images: input.count ?? 1,
+  ...input.seed != null ? { seed: input.seed } : {}
+});
+var buildIdeogramVectorizePayload = (input) => ({
+  image: input.startFrame,
+  mode: input.mode ?? "default"
+});
 registerPayloads(MODELS25, {
   "ideogram-4-5": buildIdeogram45Payload,
-  "ideogram-4-5-precise-edit": buildIdeogram45PreciseEditPayload
+  "ideogram-4-5-precise-edit": buildIdeogram45PreciseEditPayload,
+  "ideogram-vector-1": buildIdeogramVectorPayload,
+  "ideogram-vector-1-vectorize": buildIdeogramVectorizePayload
 });
 
 // src/vendors/catalog/qwen.ts
@@ -15059,6 +15259,8 @@ var Flux2Max = "flux-2-max";
 var Flux2Pro = "flux-2-pro";
 var Flux3Image = "flux-3-image";
 var Flux3ImageKlein = "flux-3-image-klein";
+var Flux3Max = "flux-3-max";
+var Flux3MaxKeyframes = "flux-3-max-keyframes";
 var Flux3Video = "flux-3-video";
 var FluxKontextMax = "flux-kontext-max";
 var FluxKontextPro = "flux-kontext-pro";
@@ -15132,6 +15334,8 @@ var IdeogramCharacter = "ideogram-character";
 var IdeogramPImage = "ideogram-p-image";
 var IdeogramV3 = "ideogram-v3";
 var IdeogramV4 = "ideogram-v4";
+var IdeogramVector1 = "ideogram-vector-1";
+var IdeogramVector1Vectorize = "ideogram-vector-1-vectorize";
 var KimiK3 = "kimi-k3";
 var Kling30Image = "kling-3.0-image";
 var KlingAvatar = "kling-avatar";
@@ -15323,6 +15527,8 @@ var Models = {
   Flux2Pro,
   Flux3Image,
   Flux3ImageKlein,
+  Flux3Max,
+  Flux3MaxKeyframes,
   Flux3Video,
   FluxKontextMax,
   FluxKontextPro,
@@ -15396,6 +15602,8 @@ var Models = {
   IdeogramPImage,
   IdeogramV3,
   IdeogramV4,
+  IdeogramVector1,
+  IdeogramVector1Vectorize,
   KimiK3,
   Kling30Image,
   KlingAvatar,

package/package.json

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