@picsart/ai-sdk 5.26.3 → 5.28.0

package/index.d.ts

@@ -297,6 +297,11 @@ type ModelInputById = {
         imageUrls?: string[];
         thinking?: "off" | "low" | "medium" | "high";
     };
+    "gemini-3.8-flash": {
+        prompt: string;
+        imageUrls?: string[];
+        thinking?: "off" | "low" | "medium" | "high";
+    };
     "gemini-omni-1.1-flash-preview": {
         prompt: string;
         aspectRatio?: "16:9" | "9:16";
@@ -811,6 +816,17 @@ type ModelInputById = {
         seed?: number;
         enableSafetyChecker?: boolean;
     };
+    "minimax-h3-max-turbo": {
+        prompt: string;
+        startFrame?: string;
+        endFrame?: string;
+        resolution?: "480p" | "768p";
+        duration?: number;
+        aspectRatio?: "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16";
+        promptExpansionMode?: "balanced" | "quality";
+        seed?: number;
+        enableSafetyChecker?: boolean;
+    };
     "minimax-music-v2": {
         prompt: string;
         lyricsPrompt?: string;
@@ -1603,7 +1619,7 @@ type ModelInputById = {
 type TypedModelId = keyof ModelInputById;
 type ModelInput<M extends TypedModelId> = ModelInputById[M];
 /** IDs of text-generation (LLM) models — narrows generateText(). */
-type TextModelId = "claude-haiku-4-5" | "claude-opus-4-8" | "claude-sonnet-4-6" | "gemini-3-pro" | "gemini-3.5-flash-lite" | "gemini-3.6-flash" | "gemini-3.7-flash" | "gpt-5.5";
+type TextModelId = "claude-haiku-4-5" | "claude-opus-4-8" | "claude-sonnet-4-6" | "gemini-3-pro" | "gemini-3.5-flash-lite" | "gemini-3.6-flash" | "gemini-3.7-flash" | "gemini-3.8-flash" | "gpt-5.5";
 type TextModelInputById = Pick<ModelInputById, TextModelId>;
 
 /**
@@ -2586,6 +2602,7 @@ declare const Models: {
     readonly Gemini35FlashLite: "gemini-3.5-flash-lite";
     readonly Gemini36Flash: "gemini-3.6-flash";
     readonly Gemini37Flash: "gemini-3.7-flash";
+    readonly Gemini38Flash: "gemini-3.8-flash";
     readonly GeminiOmni11FlashPreview: "gemini-omni-1.1-flash-preview";
     readonly GeminiOmniFlashPreview: "gemini-omni-flash-preview";
     readonly Gpt55: "gpt-5.5";
@@ -2655,6 +2672,7 @@ declare const Models: {
     readonly MinimaxH3: "minimax-h3";
     readonly MinimaxH3Max: "minimax-h3-max";
     readonly MinimaxH3MaxR2v: "minimax-h3-max-r2v";
+    readonly MinimaxH3MaxTurbo: "minimax-h3-max-turbo";
     readonly MinimaxMusicV2: "minimax-music-v2";
     readonly MinimaxMusicV3: "minimax-music-v3";
     readonly MuseImage10: "muse-image-1.0";

package/index.js

@@ -6663,6 +6663,54 @@ var { MODELS: MODELS26 } = defineModels("minimax", [
       } }
     ]
   },
+  {
+    // Turbo sibling of minimax-h3-max — same fal.ai worker, same wire shape,
+    // tuned for speed (faster-than-realtime generation). The only schema
+    // difference: prompt expansion has no 'disabled' mode on this endpoint.
+    id: "minimax-h3-max-turbo",
+    name: "MiniMax H3 Max Turbo",
+    modelId: "fal-ai-h3-max-turbo",
+    addedAt: "2026-09-03",
+    workflow: "minimax/h3-max-turbo/text-to-video",
+    editWorkflow: "minimax/h3-max-turbo/image-to-video",
+    estimatedTime: 5,
+    mode: "video",
+    inputType: "t2v",
+    description: "Faster-than-realtime MiniMax H3 Max Turbo video from text or a start/end frame, with prompt expansion. Up to 15s at 768p.",
+    features: [
+      feat("Fast", "characteristic"),
+      feat("Image Input", "input"),
+      feat("Start/End Frame", "frame"),
+      feat("768p", "resolution"),
+      feat("5-15 sec", "duration")
+    ],
+    paramConfig: {
+      ...params.prompt(),
+      ...params.startFrame(),
+      ...params.endFrame(),
+      // Lowercase on purpose: the worker uppercases for the fal wire ('768P')
+      // and the pricing qualities are lowercase, so this casing serves both.
+      ...params.resolution(["480p", "768p"], "768p"),
+      ...params.durationRange(5, 15, 5),
+      ...params.aspectRatio(["21:9", "16:9", "4:3", "1:1", "3:4", "9:16"], "16:9"),
+      // Unlike minimax-h3-max, the turbo wire has no 'disabled' expansion mode.
+      ...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")
+    },
+    constraints: [
+      // The T2V wire has no end_image_url — an end frame only reaches the
+      // vendor on the I2V route, which needs a start frame to trigger.
+      { when: { startFrame: { exists: false } }, then: {
+        endFrame: { disabled: true, reason: "An end frame requires a start frame." }
+      } },
+      // I2V derives the ratio from the input image (no aspect_ratio on that wire).
+      { when: { startFrame: { exists: true } }, then: {
+        aspectRatio: { disabled: true, reason: "Aspect ratio follows the start frame image." }
+      } }
+    ]
+  },
   {
     // Reference-to-video sibling of minimax-h3-max (same fal.ai worker).
     // The prompt addresses references by modality and order — Image 1,
@@ -6736,6 +6784,19 @@ var buildMinimaxH3MaxPayload = (input) => ({
   ...input.seed != null && input.seed !== -1 ? { seed: input.seed } : {},
   enable_safety_checker: input.enableSafetyChecker ?? true
 });
+var buildMinimaxH3MaxTurboPayload = (input) => ({
+  prompt: input.prompt,
+  prompt_expansion_mode: input.promptExpansionMode ?? "balanced",
+  duration: input.duration ?? 5,
+  resolution: input.resolution ?? "768p",
+  ...input.startFrame ? {
+    image_url: input.startFrame,
+    ...input.endFrame ? { end_image_url: input.endFrame } : {}
+  } : { aspect_ratio: input.aspectRatio ?? "16:9" },
+  // -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
+});
 var buildMinimaxH3MaxR2VPayload = (input) => ({
   prompt: input.prompt,
   prompt_expansion_mode: input.promptExpansionMode ?? "balanced",
@@ -6752,10 +6813,12 @@ var buildMinimaxH3MaxR2VPayload = (input) => ({
 registerPayloads(MODELS26, {
   "minimax-music-v3": buildMinimaxMusicV3Payload,
   "minimax-h3-max": buildMinimaxH3MaxPayload,
+  "minimax-h3-max-turbo": buildMinimaxH3MaxTurboPayload,
   "minimax-h3-max-r2v": buildMinimaxH3MaxR2VPayload
 });
 registerEditPayloads(MODELS26, {
-  "minimax-h3-max": buildMinimaxH3MaxPayload
+  "minimax-h3-max": buildMinimaxH3MaxPayload,
+  "minimax-h3-max-turbo": buildMinimaxH3MaxTurboPayload
 });
 
 // src/vendors/catalog/ideogram.ts
@@ -8640,6 +8703,23 @@ var { MODELS: GEMINI_LLM } = defineModels("google", [
       ...thinkingParam(["low", "high"])
     }
   },
+  {
+    id: "gemini-3.8-flash",
+    name: "Gemini 3.8 Flash",
+    workflow: "chat-completions",
+    addedAt: "2026-09-03",
+    estimatedTime: 5,
+    mode: "text",
+    inputType: "i2t",
+    badge: ["fast"],
+    description: "Latest fast Gemini model \u2014 low-latency multimodal text generation.",
+    features: [feat("Vision", "input"), feat("Thinking", "characteristic")],
+    paramConfig: {
+      ...params.prompt(),
+      ...params.imageInput(8, "Images"),
+      ...thinkingParam(["low", "medium", "high"])
+    }
+  },
   {
     id: "gemini-3.7-flash",
     name: "Gemini 3.7 Flash",
@@ -8649,7 +8729,7 @@ var { MODELS: GEMINI_LLM } = defineModels("google", [
     mode: "text",
     inputType: "i2t",
     badge: ["fast"],
-    description: "Latest fast Gemini model \u2014 low-latency multimodal text generation.",
+    description: "Fast Gemini model \u2014 low-latency multimodal text generation.",
     features: [feat("Vision", "input"), feat("Thinking", "characteristic")],
     paramConfig: {
       ...params.prompt(),
@@ -8750,6 +8830,7 @@ registerPayloads(MODELS36, {
   "gemini-3-pro": buildGeminiPayload("gemini-3-pro-preview"),
   // Flash models route through chat-completions (OpenAI-shaped), not the
   // native `gemini` workflow. flash-lite has no thinking param → reasoning_effort omitted.
+  "gemini-3.8-flash": buildOpenAiPayload("gemini-3.8-flash"),
   "gemini-3.7-flash": buildOpenAiPayload("gemini-3.7-flash"),
   "gemini-3.6-flash": buildOpenAiPayload("gemini-3.6-flash"),
   "gemini-3.5-flash-lite": buildOpenAiPayload("gemini-3.5-flash-lite")
@@ -11096,6 +11177,7 @@ var Gemini31FlashLiteImage = "gemini-3.1-flash-lite-image";
 var Gemini35FlashLite = "gemini-3.5-flash-lite";
 var Gemini36Flash = "gemini-3.6-flash";
 var Gemini37Flash = "gemini-3.7-flash";
+var Gemini38Flash = "gemini-3.8-flash";
 var GeminiOmni11FlashPreview = "gemini-omni-1.1-flash-preview";
 var GeminiOmniFlashPreview = "gemini-omni-flash-preview";
 var Gpt55 = "gpt-5.5";
@@ -11165,6 +11247,7 @@ var Minimax02Hd = "minimax-02-hd";
 var MinimaxH3 = "minimax-h3";
 var MinimaxH3Max = "minimax-h3-max";
 var MinimaxH3MaxR2v = "minimax-h3-max-r2v";
+var MinimaxH3MaxTurbo = "minimax-h3-max-turbo";
 var MinimaxMusicV2 = "minimax-music-v2";
 var MinimaxMusicV3 = "minimax-music-v3";
 var MuseImage10 = "muse-image-1.0";
@@ -11310,6 +11393,7 @@ var Models = {
   Gemini35FlashLite,
   Gemini36Flash,
   Gemini37Flash,
+  Gemini38Flash,
   GeminiOmni11FlashPreview,
   GeminiOmniFlashPreview,
   Gpt55,
@@ -11379,6 +11463,7 @@ var Models = {
   MinimaxH3,
   MinimaxH3Max,
   MinimaxH3MaxR2v,
+  MinimaxH3MaxTurbo,
   MinimaxMusicV2,
   MinimaxMusicV3,
   MuseImage10,

package/package.json

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