@picsart/ai-sdk 6.28.0 → 6.30.0

package/index.d.ts

@@ -506,6 +506,15 @@ type ModelInputById = {
             voiceName: string;
         }>;
     };
+    "gemini-nano-banana-2.1": {
+        prompt: string;
+        aspectRatio?: "1:1" | "16:9" | "9:16" | "3:4" | "4:3" | "2:3" | "21:9" | "auto";
+        resolution?: "1K" | "2K" | "4K";
+        count?: 1 | 2 | 4 | 6 | 8 | 10;
+        seed?: number;
+        thinkingLevel?: "minimal" | "medium" | "high";
+        imageUrls?: string[];
+    };
     "gemini-omni-1.1-flash-preview": {
         prompt: string;
         aspectRatio?: "16:9" | "9:16";
@@ -1194,6 +1203,14 @@ type ModelInputById = {
         seed?: number;
         enableSafetyChecker?: boolean;
     };
+    "minimax-h3-max-relight": {
+        videoUrl: string;
+        imageUrls: [string, ...string[]];
+        resolution?: "480p" | "768p" | "1080p" | "2k";
+        aspectRatio?: "adaptive" | "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16";
+        seed?: number;
+        enableSafetyChecker?: boolean;
+    };
     "minimax-h3-max-turbo": {
         prompt: string;
         startFrame?: string;
@@ -1894,14 +1911,6 @@ type ModelInputById = {
         imageUrls?: string[];
         negativePrompt?: string;
     };
-    "spicy-mayo": {
-        prompt: string;
-        aspectRatio?: "1:1" | "16:9" | "9:16" | "3:4" | "4:3" | "2:3" | "21:9" | "auto";
-        count?: 1 | 2 | 4 | 6 | 8 | 10;
-        seed?: number;
-        thinkingLevel?: "minimal" | "medium" | "high";
-        imageUrls?: string[];
-    };
     "topaz-upscale-image": {
         imageUrls: [string, ...string[]];
         model?: "Standard V2" | "Standard MAX" | "Low Resolution V2" | "High Fidelity V2" | "CGI" | "Text Refine" | "Redefine" | "Recovery" | "Recovery V2" | "Wonder" | "Wonder 3";
@@ -3385,6 +3394,7 @@ declare const Models: {
     readonly Gemini38Flash: "gemini-3.8-flash";
     readonly Gemini38FlashLiteTts: "gemini-3.8-flash-lite-tts";
     readonly Gemini38FlashTts: "gemini-3.8-flash-tts";
+    readonly GeminiNanoBanana21: "gemini-nano-banana-2.1";
     readonly GeminiOmni11FlashPreview: "gemini-omni-1.1-flash-preview";
     readonly GeminiOmniFlashPreview: "gemini-omni-flash-preview";
     readonly Gpt41Mini: "gpt-4.1-mini";
@@ -3475,6 +3485,7 @@ declare const Models: {
     readonly MinimaxH3MaxCameraControls: "minimax-h3-max-camera-controls";
     readonly MinimaxH3MaxExtend: "minimax-h3-max-extend";
     readonly MinimaxH3MaxLipSync: "minimax-h3-max-lip-sync";
+    readonly MinimaxH3MaxRelight: "minimax-h3-max-relight";
     readonly MinimaxH3MaxTurbo: "minimax-h3-max-turbo";
     readonly MinimaxMusicV2: "minimax-music-v2";
     readonly MinimaxMusicV3: "minimax-music-v3";
@@ -3567,7 +3578,6 @@ declare const Models: {
     readonly Seedream50Flash: "seedream-5.0-flash";
     readonly Seedream50Lite: "seedream-5.0-lite";
     readonly Seedream50Pro: "seedream-5.0-pro";
-    readonly SpicyMayo: "spicy-mayo";
     readonly TopazUpscaleImage: "topaz-upscale-image";
     readonly TopazUpscaleVideo: "topaz-upscale-video";
     readonly TypesafeEvaluate: "typesafe-evaluate";

package/index.js

@@ -3287,6 +3287,41 @@ var { MODELS: MODELS9 } = defineModels("minimax", [
       // Default-less on purpose: unset means the vendor picks a random seed.
       ...params.seed()
     }
+  },
+  {
+    // Relight sibling of minimax-h3-max: re-lights an existing clip to match
+    // a lighting-reference image (a sphere render showing the target light).
+    // No prompt and no duration on this wire — the output keeps the source
+    // clip's length (the source is converted to constant 24 fps and trimmed
+    // to the closest 17n+5 frame count, with at least ~2.33s remaining).
+    id: "minimax-h3-max-relight",
+    name: "MiniMax H3 Max Relight",
+    modelId: "fal-ai-h3-max-relight",
+    addedAt: "2026-10-08",
+    workflow: "minimax/h3-max/relight",
+    estimatedTime: 120,
+    mode: "video",
+    inputType: "v2v",
+    description: "Relight an existing video with MiniMax H3 Max \u2014 a sphere-render reference image sets the target lighting and the output keeps the source clip's length. Sources up to 15s, output up to 2K.",
+    features: [
+      feat("Relight", "characteristic"),
+      feat("Video Input", "input"),
+      feat("Image Input", "input"),
+      feat("2K", "resolution")
+    ],
+    paramConfig: {
+      ...params.videoInput("Source Video", "asset", true, 15),
+      // The target lighting, as a sphere render.
+      ...params.imageInput(1, "Lighting Reference", true, "reference"),
+      // 480p/768p generate natively; 1080p and 2K are latent refinements
+      // of a native 768p generation.
+      ...params.resolution(["480p", "768p", "1080p", "2k"], "768p"),
+      // 'adaptive' follows the source video's ratio.
+      ...params.aspectRatio(["adaptive", "21:9", "16:9", "4:3", "1:1", "3:4", "9:16"], "16:9"),
+      // Default-less on purpose: unset means the vendor picks a random seed.
+      ...params.seed(),
+      ...p.boolean("enableSafetyChecker", true, "Safety Checker")
+    }
   }
 ]);
 
@@ -6489,14 +6524,14 @@ var buildGemini31FlashLiteImagePayload = (ctx) => ({
   imageSize: ctx.resolution ?? "1K",
   ...buildThinkingConfig(ctx)
 });
-var buildSpicyMayoPayload = (ctx) => ({
+var buildNanoBanana21Payload = (ctx) => ({
   prompt: ctx.prompt,
-  model: "spicy-mayo",
+  model: "gemini-nano-banana-2.1",
   count: ctx.count ?? 1,
   ...ctx.seed != null ? { seed: ctx.seed } : {},
   ...ctx.imageUrls?.length ? { imageUrls: ctx.imageUrls } : {},
   aspectRatio: ctx.aspectRatio ?? "1:1",
-  imageSize: "1K",
+  imageSize: ctx.resolution ?? "1K",
   ...buildThinkingConfig(ctx)
 });
 function inferMimeType2(url) {
@@ -6577,7 +6612,7 @@ var thinkingBudgetParam = {
     descriptor: { kind: "range", min: 128, max: 24576, step: 128, default: 128 }
   }
 };
-var spicyMayoThinkingParam = {
+var nanoBanana21ThinkingParam = {
   thinkingLevel: {
     label: "Thinking",
     descriptor: {
@@ -6595,31 +6630,28 @@ var spicyMayoThinkingParam = {
 var { MODELS: MODELS22 } = defineModels("google", [
   // ── Image ─────────────────────────────────────────────────────────
   {
-    id: "spicy-mayo",
-    name: "Spicy Mayo",
-    addedAt: "2026-10-02",
-    // Confidential early access at the vendor, authorized for named projects
-    // only — stage until the co-launch clears it for prod.
-    release: "preview",
+    id: "gemini-nano-banana-2.1",
+    name: "Nano Banana 2.1",
+    addedAt: "2026-10-06",
     workflow: "gemini/v2/images",
-    buildPayload: buildSpicyMayoPayload,
-    // Measured end-to-end against stage at 1K/1:1: 9s to generate, 13s to edit
-    // with two reference images. Rounded up — vendor testing capacity is capped.
-    estimatedTime: 15,
+    buildPayload: buildNanoBanana21Payload,
+    // Measured end-to-end through the worker (generation plus the CDN upload a caller
+    // waits on), two runs per tier: 1K 15-17s, 2K 28-29s, 4K 45-50s. Rounded up.
+    estimatedTime: { "1K": 18, "2K": 30, "4K": 50 },
     mode: "image",
     inputType: "t2i",
-    modelId: "spicy-mayo",
+    modelId: "gemini-nano-banana-2.1",
     badge: ["fast"],
     description: "Fast Google image generation and editing with multi-image references.",
-    // Only the 1K tier is priced, so no `resolution` param: the builder pins
-    // imageSize and anything else is a 400 from the worker.
-    features: [feat("Multi-Image Input", "input"), feat("1K", "resolution")],
+    features: [feat("Multi-Image Input", "input"), feat("4K", "resolution")],
     paramConfig: {
       ...params.prompt(),
       ...params.aspectRatio([...GEMINI_AR_WIDE], "1:1"),
+      // 0.5K is rejected by the vendor; 1K/2K/4K each genuinely scale the output.
+      ...params.resolution(["1K", "2K", "4K"], "1K"),
       ...params.count(),
       ...params.seed(),
-      ...spicyMayoThinkingParam,
+      ...nanoBanana21ThinkingParam,
       ...params.imageInput(14, "Source Images")
     }
   },
@@ -8004,13 +8036,24 @@ var buildMinimaxH3MaxExtendPayload = (input) => ({
   enable_prompt_expansion: input.enhancePrompt ?? true,
   enable_safety_checker: input.enableSafetyChecker ?? true
 });
+var buildMinimaxH3MaxRelightPayload = (input) => ({
+  video_url: input.videoUrl,
+  // The single lighting reference travels as a scalar on the wire.
+  reference_image_url: input.imageUrls?.[0],
+  // The vendor enum is uppercase; paramConfig keeps the lowercase form.
+  resolution: (input.resolution ?? "768p").toUpperCase(),
+  aspect_ratio: input.aspectRatio ?? "16:9",
+  ...input.seed != null ? { seed: input.seed } : {},
+  enable_safety_checker: input.enableSafetyChecker ?? true
+});
 registerPayloads(MODELS9, {
   "minimax-music-v3": buildMinimaxMusicV3Payload,
   "minimax-h3-max": buildMinimaxH3MaxPayload,
   "minimax-h3-max-turbo": buildMinimaxH3MaxTurboPayload,
   "minimax-h3-max-camera-controls": buildMinimaxH3MaxCameraControlsPayload,
   "minimax-h3-max-lip-sync": buildMinimaxH3MaxLipSyncPayload,
-  "minimax-h3-max-extend": buildMinimaxH3MaxExtendPayload
+  "minimax-h3-max-extend": buildMinimaxH3MaxExtendPayload,
+  "minimax-h3-max-relight": buildMinimaxH3MaxRelightPayload
 });
 registerEditPayloads(MODELS9, {
   "minimax-h3-max-turbo": buildMinimaxH3MaxTurboPayload
@@ -13646,6 +13689,7 @@ var Gemini37Flash = "gemini-3.7-flash";
 var Gemini38Flash = "gemini-3.8-flash";
 var Gemini38FlashLiteTts = "gemini-3.8-flash-lite-tts";
 var Gemini38FlashTts = "gemini-3.8-flash-tts";
+var GeminiNanoBanana21 = "gemini-nano-banana-2.1";
 var GeminiOmni11FlashPreview = "gemini-omni-1.1-flash-preview";
 var GeminiOmniFlashPreview = "gemini-omni-flash-preview";
 var Gpt41Mini = "gpt-4.1-mini";
@@ -13736,6 +13780,7 @@ var MinimaxH3Max = "minimax-h3-max";
 var MinimaxH3MaxCameraControls = "minimax-h3-max-camera-controls";
 var MinimaxH3MaxExtend = "minimax-h3-max-extend";
 var MinimaxH3MaxLipSync = "minimax-h3-max-lip-sync";
+var MinimaxH3MaxRelight = "minimax-h3-max-relight";
 var MinimaxH3MaxTurbo = "minimax-h3-max-turbo";
 var MinimaxMusicV2 = "minimax-music-v2";
 var MinimaxMusicV3 = "minimax-music-v3";
@@ -13828,7 +13873,6 @@ var Seedream47 = "seedream-4.7";
 var Seedream50Flash = "seedream-5.0-flash";
 var Seedream50Lite = "seedream-5.0-lite";
 var Seedream50Pro = "seedream-5.0-pro";
-var SpicyMayo = "spicy-mayo";
 var TopazUpscaleImage = "topaz-upscale-image";
 var TopazUpscaleVideo = "topaz-upscale-video";
 var TypesafeEvaluate = "typesafe-evaluate";
@@ -13903,6 +13947,7 @@ var Models = {
   Gemini38Flash,
   Gemini38FlashLiteTts,
   Gemini38FlashTts,
+  GeminiNanoBanana21,
   GeminiOmni11FlashPreview,
   GeminiOmniFlashPreview,
   Gpt41Mini,
@@ -13993,6 +14038,7 @@ var Models = {
   MinimaxH3MaxCameraControls,
   MinimaxH3MaxExtend,
   MinimaxH3MaxLipSync,
+  MinimaxH3MaxRelight,
   MinimaxH3MaxTurbo,
   MinimaxMusicV2,
   MinimaxMusicV3,
@@ -14085,7 +14131,6 @@ var Models = {
   Seedream50Flash,
   Seedream50Lite,
   Seedream50Pro,
-  SpicyMayo,
   TopazUpscaleImage,
   TopazUpscaleVideo,
   TypesafeEvaluate,

package/package.json

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