@picsart/ai-sdk 6.32.0 → 6.33.0

package/index.d.ts

@@ -1622,6 +1622,13 @@ type ModelInputById = {
         aspectRatio?: "16:9" | "9:16";
         imageUrls?: string[];
     };
+    "sam-3-video": {
+        prompt: string;
+        videoUrl: string;
+        detectionThreshold?: number;
+        applyMask?: boolean;
+        outputFormat?: "mp4" | "webm";
+    };
     "seed-audio-1.0": {
         prompt: string;
         voiceId?: string;
@@ -3563,6 +3570,7 @@ declare const Models: {
     readonly RunwayGen4Aleph: "runway-gen4-aleph";
     readonly RunwayGen4Ref: "runway-gen4-ref";
     readonly RunwayGen45: "runway-gen4.5";
+    readonly Sam3Video: "sam-3-video";
     readonly SeedAudio10: "seed-audio-1.0";
     readonly SeedAudio10Multilingual: "seed-audio-1.0-multilingual";
     readonly Seedance15Pro: "seedance-1.5-pro";

package/index.js

@@ -10686,6 +10686,30 @@ var { MODELS: MODELS37 } = defineModels("meta", [
       ...params.count(),
       ...params.imageInput(5, "Source Images")
     }
+  },
+  // ── Video ─────────────────────────────────────────
+  {
+    // Billed per second of the source clip at one flat rate, so none of the
+    // knobs below changes the price.
+    id: "sam-3-video",
+    name: "SAM 3 Video",
+    modelId: "fal-ai-sam-3-video",
+    addedAt: "2026-10-12",
+    workflow: "sam-3/video",
+    estimatedTime: 60,
+    mode: "video",
+    inputType: "v2v",
+    description: "Segment and track objects through a video from a text prompt \u2014 name several objects separated by commas and SAM 3 keeps each one masked across every frame.",
+    features: [feat("Segmentation", "characteristic"), feat("Object Tracking", "characteristic"), feat("Video Input", "input")],
+    paramConfig: {
+      ...params.prompt({ placeholder: "person, cloth" }),
+      ...params.videoInput("Source Video", "asset", true),
+      // Lower finds more objects but less precisely.
+      ...p.range("detectionThreshold", 0, 1, 0.5, { step: 0.05, label: "Detection Threshold" }),
+      // Off returns the source frames without the mask overlay.
+      ...p.boolean("applyMask", true, "Apply Mask"),
+      ...p.enum("outputFormat", ["mp4", "webm"], "mp4", { label: "Format" })
+    }
   }
 ]);
 
@@ -10718,8 +10742,20 @@ var buildMuseImageEditPayload = (input) => ({
   ...buildMuseCommonPayload(input),
   images: input.imageUrls ?? []
 });
+var SAM3_OUTPUT_TYPE = {
+  mp4: "X264 (.mp4)",
+  webm: "VP9 (.webm)"
+};
+var buildSam3VideoPayload = (input) => ({
+  video_url: input.videoUrl,
+  prompt: input.prompt,
+  detection_threshold: input.detectionThreshold ?? 0.5,
+  apply_mask: input.applyMask ?? true,
+  video_output_type: SAM3_OUTPUT_TYPE[input.outputFormat ?? "mp4"]
+});
 registerPayloads(MODELS37, {
-  "muse-image-1.0": buildMuseImagePayload
+  "muse-image-1.0": buildMuseImagePayload,
+  "sam-3-video": buildSam3VideoPayload
 });
 registerEditPayloads(MODELS37, {
   "muse-image-1.0": buildMuseImageEditPayload
@@ -13910,6 +13946,7 @@ var RunwayGen3aTurbo = "runway-gen3a-turbo";
 var RunwayGen4Aleph = "runway-gen4-aleph";
 var RunwayGen4Ref = "runway-gen4-ref";
 var RunwayGen45 = "runway-gen4.5";
+var Sam3Video = "sam-3-video";
 var SeedAudio10 = "seed-audio-1.0";
 var SeedAudio10Multilingual = "seed-audio-1.0-multilingual";
 var Seedance15Pro = "seedance-1.5-pro";
@@ -14170,6 +14207,7 @@ var Models = {
   RunwayGen4Aleph,
   RunwayGen4Ref,
   RunwayGen45,
+  Sam3Video,
   SeedAudio10,
   SeedAudio10Multilingual,
   Seedance15Pro,

package/package.json

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