@picsart/ai-sdk 3.25.0 → 3.27.0

package/index.d.ts

@@ -69,6 +69,14 @@ type ModelInputById = {
         imageUrls: [string, ...string[]];
         audioUrl: string;
     };
+    "bytedance-video-enhance": {
+        videoUrl: string;
+        quality?: "standard" | "professional";
+        resolution?: "source" | "720p" | "1080p" | "2k" | "4k" | "8k";
+        fps?: 30 | 60 | 120;
+        scene?: "common" | "ugc" | "short_series" | "aigc" | "old_film";
+        bitrateLevel?: "low" | "medium" | "high";
+    };
     "bytedance-video-upscaler": {
         videoUrl: string;
     };
@@ -409,6 +417,11 @@ type ModelInputById = {
         count?: 1 | 2 | 4 | 6 | 8 | 10;
         imageUrls: [string, ...string[]];
     };
+    "ideogram-p-image": {
+        prompt: string;
+        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";
+        renderingSpeed?: "very-low" | "low" | "medium" | "high";
+    };
     "ideogram-v3": {
         prompt: string;
         aspectRatio?: "16:9" | "9:16" | "1:1" | "3:4" | "4:3";
@@ -2128,6 +2141,7 @@ interface ModelFilter {
 declare const Models: {
     readonly AsyncFlashV1: "async-flash-v1";
     readonly BytedanceOmnihumanV15: "bytedance-omnihuman-v1.5";
+    readonly BytedanceVideoEnhance: "bytedance-video-enhance";
     readonly BytedanceVideoUpscaler: "bytedance-video-upscaler";
     readonly ClaudeHaiku45: "claude-haiku-4-5";
     readonly ClaudeOpus48: "claude-opus-4-8";
@@ -2185,6 +2199,7 @@ declare const Models: {
     readonly HeygenVideoAvatar: "heygen-video-avatar";
     readonly HunyuanV3: "hunyuan-v3";
     readonly IdeogramCharacter: "ideogram-character";
+    readonly IdeogramPImage: "ideogram-p-image";
     readonly IdeogramV3: "ideogram-v3";
     readonly IdeogramV4: "ideogram-v4";
     readonly Imagen40: "imagen-4.0";

package/index.js

@@ -2652,6 +2652,22 @@ var { MODELS: MODELS5 } = defineModels("ovi", [
 ]);
 
 // src/vendors/catalog/bytedance.ts
+var BYTEDANCE_ENHANCE_RESOLUTION_OPTIONS = [
+  "source",
+  "720p",
+  "1080p",
+  "2k",
+  "4k",
+  "8k"
+];
+var BYTEDANCE_ENHANCE_FPS_OPTIONS = [30, 60, 120];
+var BYTEDANCE_ENHANCE_SCENE_OPTIONS = [
+  "common",
+  "ugc",
+  "short_series",
+  "aigc",
+  "old_film"
+];
 var buildBytedanceUpscalerPayload = (ctx) => ({
   video_url: ctx.videoUrl,
   target_resolution: "1080p"
@@ -2694,9 +2710,67 @@ var { MODELS: MODELS6 } = defineModels("bytedance", [
       ...params.imageInput(1, "Portrait Image", true),
       ...params.audioInput("Audio Track", true)
     }
+  },
+  {
+    id: "bytedance-video-enhance",
+    name: "ByteDance Video Enhance",
+    addedAt: "2026-07-29",
+    workflow: "bytedance/video-enhance",
+    // Measured on the live API: 303s end-to-end for a 5s 720p→1080p@60fps
+    // professional run. Wall time scales with source duration, so this is a
+    // representative short-clip figure, not a ceiling.
+    estimatedTime: 300,
+    mode: "video",
+    inputType: "v2v",
+    // The pa-bytedance-pluggable-worker MR adding this task is still open, so
+    // the workflow is not deployed. Flip this off once the worker ships.
+    disabled: true,
+    description: "Denoise, color-correct and super-resolve existing footage up to 8K, with frame-rate conversion.",
+    features: [feat("Video Required", "input"), feat("Up to 8K", "resolution"), feat("Enhance", "quality")],
+    paramConfig: {
+      ...params.videoInput("Source Video", "asset", true),
+      ...p.quality(["standard", "professional"], "standard"),
+      ...p.enum("resolution", [...BYTEDANCE_ENHANCE_RESOLUTION_OPTIONS], "source"),
+      // Always sent — the backend rejects a request it cannot price, and the
+      // source frame rate is not discoverable from file metadata.
+      ...p.enum("fps", [...BYTEDANCE_ENHANCE_FPS_OPTIONS], 30),
+      ...p.enum("scene", [...BYTEDANCE_ENHANCE_SCENE_OPTIONS], "common"),
+      ...p.enum("bitrateLevel", ["low", "medium", "high"], "medium")
+    },
+    constraints: [
+      {
+        when: { quality: { is: "professional" } },
+        then: { scene: { disabled: true, reason: "Scene presets only apply to the standard version" } }
+      }
+    ]
   }
 ]);
 
+// src/vendors/catalog/bytedance.payloads.ts
+var DEFAULT_TOOL_VERSION = "standard";
+var buildBytedanceVideoEnhancePayload = (input) => {
+  const toolVersion = input.quality ?? DEFAULT_TOOL_VERSION;
+  return {
+    video_url: input.videoUrl,
+    tool_version: toolVersion,
+    bitrate_level: input.bitrateLevel ?? "medium",
+    // Always sent: the backend resolves the billing tier before generating and
+    // rejects the request (`billing_undetermined`) when the output frame rate is
+    // unknown — it cannot read the source frame rate from file metadata.
+    fps: input.fps ?? 30,
+    // `source` is the SDK-only sentinel for "keep the source resolution"; the
+    // backend expresses that by omitting the field. Sending an explicit tier
+    // instead would silently rescale (and reprice) every request.
+    ...input.resolution && input.resolution !== "source" ? { resolution: input.resolution } : {},
+    // The vendor ignores `scene` unless tool_version is standard, and the
+    // backend validator rejects the combination outright.
+    ...input.scene && toolVersion === DEFAULT_TOOL_VERSION ? { scene: input.scene } : {}
+  };
+};
+registerPayloads(MODELS6, {
+  "bytedance-video-enhance": buildBytedanceVideoEnhancePayload
+});
+
 // src/vendors/catalog/videography.ts
 var buildVideographyPayload = (ctx) => ({
   imageUrl: ctx.imageUrls?.[0]
@@ -6492,6 +6566,11 @@ var buildIdeogramV4GeneratePayload = (ctx) => ({
   ...ctx.renderingSpeed ? { rendering_speed: ctx.renderingSpeed } : {},
   ...ctx.enableCopyrightDetection ? { enable_copyright_detection: true } : {}
 });
+var buildIdeogramPImagePayload = (ctx) => ({
+  prompt: ctx.prompt,
+  resolution: ctx.resolution ?? "1024x1024",
+  rendering_speed: ctx.renderingSpeed ?? "medium"
+});
 var { MODELS: MODELS27 } = defineModels("ideogram", [
   {
     id: "ideogram-v4",
@@ -6537,6 +6616,68 @@ var { MODELS: MODELS27 } = defineModels("ideogram", [
       ...p.boolean("enableCopyrightDetection", false, "Copyright Detection")
     }
   },
+  {
+    id: "ideogram-p-image",
+    name: "Ideogram P-Image",
+    release: "preview",
+    addedAt: "2026-07-28",
+    workflow: "ideogram/p-image/generate",
+    buildPayload: buildIdeogramPImagePayload,
+    estimatedTime: 15,
+    mode: "image",
+    inputType: "t2i",
+    description: "Tiered Ideogram text-to-image \u2014 pick a speed/quality tier from very-low (fastest) to high (max quality).",
+    features: [feat("Speed Tiers", "style"), feat("Up to 2K", "resolution")],
+    paramConfig: {
+      ...params.prompt(),
+      ...params.resolution([
+        // 2K bucket (~3–4 MP)
+        "2048x2048",
+        "1440x2880",
+        "2880x1440",
+        "1664x2496",
+        "2496x1664",
+        "1792x2240",
+        "2240x1792",
+        "1440x2560",
+        "2560x1440",
+        "1600x2560",
+        "2560x1600",
+        "1728x2304",
+        "2304x1728",
+        "1296x3168",
+        "3168x1296",
+        "1152x2944",
+        "2944x1152",
+        "1248x3328",
+        "3328x1248",
+        "1280x3072",
+        "3072x1280",
+        "1024x3072",
+        "3072x1024",
+        // 1K bucket (~1 MP)
+        "1024x1024",
+        "896x1120",
+        "1120x896",
+        "864x1152",
+        "1152x864",
+        "832x1248",
+        "1248x832",
+        "800x1280",
+        "1280x800",
+        "720x1280",
+        "1280x720",
+        "720x1440",
+        "1440x720"
+      ], "1024x1024"),
+      ...params.renderingSpeed([
+        { id: "very-low", label: "Very Low" },
+        { id: "low", label: "Low" },
+        { id: "medium", label: "Balanced" },
+        { id: "high", label: "Quality" }
+      ], "medium")
+    }
+  },
   {
     id: "ideogram-v3",
     name: "Ideogram v3",
@@ -10202,6 +10343,7 @@ var catalog = {
 // src/generated/model-constants.ts
 var AsyncFlashV1 = "async-flash-v1";
 var BytedanceOmnihumanV15 = "bytedance-omnihuman-v1.5";
+var BytedanceVideoEnhance = "bytedance-video-enhance";
 var BytedanceVideoUpscaler = "bytedance-video-upscaler";
 var ClaudeHaiku45 = "claude-haiku-4-5";
 var ClaudeOpus48 = "claude-opus-4-8";
@@ -10259,6 +10401,7 @@ var HeygenTalkingPhoto = "heygen-talking-photo";
 var HeygenVideoAvatar = "heygen-video-avatar";
 var HunyuanV3 = "hunyuan-v3";
 var IdeogramCharacter = "ideogram-character";
+var IdeogramPImage = "ideogram-p-image";
 var IdeogramV3 = "ideogram-v3";
 var IdeogramV4 = "ideogram-v4";
 var Imagen40 = "imagen-4.0";
@@ -10397,6 +10540,7 @@ var Wan27VideoEdit = "wan-2.7-video-edit";
 var Models = {
   AsyncFlashV1,
   BytedanceOmnihumanV15,
+  BytedanceVideoEnhance,
   BytedanceVideoUpscaler,
   ClaudeHaiku45,
   ClaudeOpus48,
@@ -10454,6 +10598,7 @@ var Models = {
   HeygenVideoAvatar,
   HunyuanV3,
   IdeogramCharacter,
+  IdeogramPImage,
   IdeogramV3,
   IdeogramV4,
   Imagen40,

package/package.json

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