@picsart/ai-sdk 1.137.3 → 1.139.0

package/_cli.js

@@ -583,8 +583,14 @@ function validateDescriptor(key, d, val, required) {
       }
       break;
     case "file":
-      if (d.accept === "image" && key !== "startFrame" && key !== "endFrame") {
+      if (d.array) {
         if (!Array.isArray(val)) throw new Error(`"${key}" must be an array of URLs`);
+        if (d.array.min != null && val.length < d.array.min) {
+          throw new Error(`"${key}" needs at least ${d.array.min} items`);
+        }
+        if (d.array.max != null && val.length > d.array.max) {
+          throw new Error(`"${key}" allows at most ${d.array.max} items`);
+        }
       } else {
         if (typeof val !== "string") throw new Error(`"${key}" must be a string URL`);
       }
@@ -907,7 +913,7 @@ var init_presets = __esm({
             descriptor: {
               kind: "file",
               accept,
-              max: opts?.max ?? 1
+              ...opts?.array ? { array: opts.array } : {}
             }
           }
         };
@@ -1103,7 +1109,7 @@ var init_define = __esm({
       videoId: p.videoId,
       language: p.language,
       // File presets — key matches the runtime GenerationContext field name:
-      imageInput: (max = 1, label = "Start Image", required = false) => p.file("imageUrls", "image", { max, label, required }),
+      imageInput: (max = 1, label = "Start Image", required = false) => p.file("imageUrls", "image", { array: { max }, label, required }),
       videoInput: (label = "Source Video") => p.file("videoUrl", "video", { label, required: true }),
       audioInput: (label = "Audio Track", required = false) => p.file("audioUrl", "audio", { label, required }),
       startFrame: (label = "Start Frame", required = false) => p.file("startFrame", "image", { label, required }),
@@ -2552,7 +2558,6 @@ var init_wan = __esm({
         estimatedTime: 26,
         mode: "video",
         inputType: "v2v",
-        disabled: true,
         badge: ["popular", "new"],
         description: "Wan 2.7 Video Edit \u2014 restyle or modify existing video with reference images.",
         features: [feat("Video Input", "input"), feat("Image Input", "input"), feat("1080P", "resolution")],
@@ -3929,10 +3934,10 @@ var init_gemini = __esm({
         specName: "Gemini 3 Pro Image",
         workflow: "gemini/v2/images",
         buildPayload: buildGemini3ProImagePayload,
-        toolId: { by: "resolution", map: { "0.5K": "image-gen.gemini-3-pro-image.0.5k", "1K": "image-gen.gemini-3-pro-image.1k", "2K": "image-gen.gemini-3-pro-image.2k", "4K": "image-gen.gemini-3-pro-image.4k" } },
-        creditPrice: { "image-gen.gemini-3-pro-image.0.5k": 2, "image-gen.gemini-3-pro-image.1k": 3, "image-gen.gemini-3-pro-image.2k": 4, "image-gen.gemini-3-pro-image.4k": 5 },
+        toolId: { by: "resolution", map: { "1K": "image-gen.gemini-3-pro-image.1k", "2K": "image-gen.gemini-3-pro-image.2k", "4K": "image-gen.gemini-3-pro-image.4k" } },
+        creditPrice: { "image-gen.gemini-3-pro-image.1k": 3, "image-gen.gemini-3-pro-image.2k": 4, "image-gen.gemini-3-pro-image.4k": 5 },
         pricingUnit: "per_image",
-        estimatedTime: { "0.5K": 15, "1K": 30, "2K": 57, "4K": 74 },
+        estimatedTime: { "1K": 30, "2K": 57, "4K": 74 },
         mode: "image",
         inputType: "t2i",
         modelId: "gemini-3-pro-image-preview",
@@ -3942,7 +3947,7 @@ var init_gemini = __esm({
         paramConfig: {
           ...params.prompt(),
           ...params.aspectRatio([...GEMINI_AR_WIDE], "1:1"),
-          ...params.resolution(["0.5K", "1K", "2K", "4K"], "2K"),
+          ...params.resolution(["1K", "2K", "4K"], "2K"),
           ...params.count(),
           ...params.imageInput(14, "Source Images")
         }
@@ -4276,7 +4281,7 @@ var init_elevenlabs = __esm({
         buildPayload: buildElevenLabsSTSPayload,
         toolId: "audio-gen.eleven-sts-v2",
         creditPrice: { "audio-gen.eleven-sts-v2": 1 },
-        pricingUnit: "per_second",
+        pricingUnit: "per_minute",
         estimatedTime: 15,
         mode: "audio",
         inputType: "sts",
@@ -5324,17 +5329,17 @@ var init_picsart = __esm({
       upscale: { enabled: true, target_scale: 2 },
       face_enhancement: { enabled: true },
       colour_correction: { enabled: false },
-      output_format: "png"
+      output_format: "PNG"
     });
     ({ MODELS: MODELS31, PRICES: PRICES31 } = defineModels("picsart", [
       {
         id: "picsart-change-bg",
         name: "Picsart Change Background",
-        workflow: "v3/smart-background",
+        workflow: "v4/smart-background",
         syncExecute: true,
         buildPayload: buildChangeBgPayload,
-        toolId: "image-gen.picsart-change-bg",
-        creditPrice: { "image-gen.picsart-change-bg": 2 },
+        toolId: "image-to-image.picsart-change-bg",
+        creditPrice: { "image-to-image.picsart-change-bg": 1 },
         pricingUnit: "per_image",
         mode: "image",
         inputType: "i2i",
@@ -5350,8 +5355,10 @@ var init_picsart = __esm({
         name: "Remove Background",
         workflow: "pcp/v2/sod",
         syncExecute: true,
-        disabled: true,
         buildPayload: buildRemoveBgPayload,
+        toolId: "image-to-image.picsart-sod",
+        creditPrice: { "image-to-image.picsart-sod": 1 },
+        pricingUnit: "per_image",
         outputSchema: sodOutputSchema,
         mode: "image",
         inputType: "i2i",
@@ -5363,8 +5370,10 @@ var init_picsart = __esm({
         id: "picsart-enhance",
         name: "Enhance",
         workflow: "pcp/v1/enhancement",
-        disabled: true,
         buildPayload: buildEnhancePayload,
+        toolId: "image-to-image.picsart-enhance",
+        creditPrice: { "image-to-image.picsart-enhance": 1 },
+        pricingUnit: "per_image",
         mode: "image",
         inputType: "i2i",
         estimatedTime: 30,
@@ -6359,52 +6368,6 @@ var init_client = __esm({
   }
 });
 
-// src/core/descriptors/param-access.ts
-function getEnumOptions(model, key) {
-  const entry = model.paramConfig[key];
-  if (!entry) return null;
-  const d = entry.descriptor;
-  if (d.kind === "enum") {
-    return d.options.map((o) => o.id);
-  }
-  return null;
-}
-function getDefault(model, key) {
-  const entry = model.paramConfig[key];
-  if (!entry) return void 0;
-  const d = entry.descriptor;
-  return "default" in d ? d.default : void 0;
-}
-function getRange(model, key) {
-  const entry = model.paramConfig[key];
-  if (!entry) return null;
-  const d = entry.descriptor;
-  if (d.kind === "range") {
-    const r = d;
-    return { min: r.min, max: r.max, step: r.step, default: r.default };
-  }
-  return null;
-}
-function getFileParam(model, key) {
-  const entry = model.paramConfig[key];
-  if (!entry) return null;
-  const d = entry.descriptor;
-  if (d.kind === "file") {
-    const f = d;
-    return {
-      required: entry.required ?? false,
-      max: f.max,
-      label: entry.label,
-      accept: f.accept
-    };
-  }
-  return null;
-}
-var init_param_access = __esm({
-  "src/core/descriptors/param-access.ts"() {
-  }
-});
-
 // src/core/descriptors/model-accessor.ts
 function _model(id) {
   return new ModelDescriptorImpl(resolveModel(id));
@@ -6429,7 +6392,6 @@ function _search(query) {
 var ModelParamsAccessorImpl, ModelMetaImpl, ModelDescriptorImpl, Model;
 var init_model_accessor = __esm({
   "src/core/descriptors/model-accessor.ts"() {
-    init_param_access();
     init_utils();
     init_resolve();
     init_catalog();
@@ -6439,7 +6401,10 @@ var init_model_accessor = __esm({
         this.def = def;
       }
       param(key) {
-        return this.def.paramConfig[key];
+        const entry = this.def.paramConfig[key];
+        if (!entry) return void 0;
+        const { descriptor, ...meta } = entry;
+        return { ...meta, ...descriptor };
       }
       hasParam(key) {
         return key in this.def.paramConfig;
@@ -6492,19 +6457,19 @@ var init_model_accessor = __esm({
         return Object.values(this.def.paramConfig).some((e) => e.descriptor.kind === "file");
       }
       getDefault(key) {
-        return getDefault(this.def, key);
+        const entry = this.def.paramConfig[key];
+        if (!entry) return void 0;
+        const d = entry.descriptor;
+        return "default" in d ? d.default : void 0;
       }
       getDefaults() {
         return extractDefaults(this.def.paramConfig);
       }
+      /** @deprecated Use `enum(key)` instead. */
       getEnumOptions(key) {
-        return getEnumOptions(this.def, key);
-      }
-      getRange(key) {
-        return getRange(this.def, key);
-      }
-      getFileParam(key) {
-        return getFileParam(this.def, key);
+        const entry = this.def.paramConfig[key];
+        if (!entry || entry.descriptor.kind !== "enum") return null;
+        return entry.descriptor.options.map((o) => o.id);
       }
       toSchema() {
         return descriptorsToSchema(this.def.paramConfig);
@@ -6514,9 +6479,8 @@ var init_model_accessor = __esm({
       }
       narrow(key, kind) {
         const entry = this.param(key);
-        if (!entry || entry.descriptor.kind !== kind) return void 0;
-        const { descriptor, ...meta } = entry;
-        return { ...meta, ...descriptor };
+        if (!entry || entry.kind !== kind) return void 0;
+        return entry;
       }
     };
     ModelMetaImpl = class {
@@ -6878,9 +6842,11 @@ var init_model_constants = __esm({
       toSchema(id) {
         return Model(id).params().toSchema();
       },
-      /** @deprecated Use `Model(id).params().getFileParam(key)` instead. */
+      /** @deprecated Use `Model(id).params().file(key)` instead. */
       getFileParam(id, key) {
-        return Model(id).params().getFileParam(key);
+        const f = Model(id).params().file(key);
+        if (!f) return null;
+        return { required: f.required ?? false, max: f.array?.max ?? 1, label: f.label, accept: f.accept };
       },
       /** @deprecated Use `Model(id).params().hasParam(key)` instead. */
       hasParam(id, key) {
@@ -6895,7 +6861,6 @@ var init_descriptors = __esm({
   "src/core/descriptors/index.ts"() {
     init_utils();
     init_presets();
-    init_param_access();
     init_model_accessor();
   }
 });

package/index.d.ts

@@ -1122,7 +1122,11 @@ interface TextDescriptor {
 interface FileDescriptor {
     kind: 'file';
     accept: 'image' | 'video' | 'audio' | 'media';
-    max: number;
+    /** Present = array; absent = single. `min`/`max` bound the array length. */
+    array?: {
+        min?: number;
+        max?: number;
+    };
 }
 interface ObjectDescriptor {
     kind: 'object';
@@ -1175,7 +1179,7 @@ interface ModelMeta {
 }
 /** Parameter operations — fluent access to model params, schemas, defaults. */
 interface ModelParamsAccessor {
-    param(key: string): ParamEntry | undefined;
+    param(key: string): (EntryMeta & ParamDescriptor) | undefined;
     hasParam(key: string): boolean;
     all(): FlatParamEntry[];
     enum(key: string): EnumEntry | undefined;
@@ -1193,19 +1197,8 @@ interface ModelParamsAccessor {
     hasFileInput(): boolean;
     getDefault(key: string): unknown;
     getDefaults(): Record<string, unknown>;
+    /** @deprecated Use `enum(key)` instead — returns full `EnumEntry` with `.options`, `.default`, etc. */
     getEnumOptions(key: string): (string | number)[] | null;
-    getRange(key: string): {
-        min: number;
-        max: number;
-        step?: number;
-        default: number;
-    } | null;
-    getFileParam(key: string): {
-        required: boolean;
-        max: number;
-        label?: string;
-        accept?: string;
-    } | null;
     toSchema(): ModelParamSchema;
     transferValues(prev: Record<string, unknown>): Record<string, unknown>;
 }
@@ -1579,7 +1572,7 @@ declare const Models: {
     readonly validate: (model: string, input: unknown) => ValidationResult;
     /** @deprecated Use `Model(id).params().toSchema()` instead. */
     readonly toSchema: (id: string) => ModelParamSchema;
-    /** @deprecated Use `Model(id).params().getFileParam(key)` instead. */
+    /** @deprecated Use `Model(id).params().file(key)` instead. */
     readonly getFileParam: (id: string, key: string) => {
         required: boolean;
         max: number;

package/index.js

@@ -176,8 +176,14 @@ function validateDescriptor(key, d, val, required) {
       }
       break;
     case "file":
-      if (d.accept === "image" && key !== "startFrame" && key !== "endFrame") {
+      if (d.array) {
         if (!Array.isArray(val)) throw new Error(`"${key}" must be an array of URLs`);
+        if (d.array.min != null && val.length < d.array.min) {
+          throw new Error(`"${key}" needs at least ${d.array.min} items`);
+        }
+        if (d.array.max != null && val.length > d.array.max) {
+          throw new Error(`"${key}" allows at most ${d.array.max} items`);
+        }
       } else {
         if (typeof val !== "string") throw new Error(`"${key}" must be a string URL`);
       }
@@ -488,7 +494,7 @@ var p = {
         descriptor: {
           kind: "file",
           accept,
-          max: opts?.max ?? 1
+          ...opts?.array ? { array: opts.array } : {}
         }
       }
     };
@@ -668,7 +674,7 @@ var params = {
   videoId: p.videoId,
   language: p.language,
   // File presets — key matches the runtime GenerationContext field name:
-  imageInput: (max = 1, label = "Start Image", required = false) => p.file("imageUrls", "image", { max, label, required }),
+  imageInput: (max = 1, label = "Start Image", required = false) => p.file("imageUrls", "image", { array: { max }, label, required }),
   videoInput: (label = "Source Video") => p.file("videoUrl", "video", { label, required: true }),
   audioInput: (label = "Audio Track", required = false) => p.file("audioUrl", "audio", { label, required }),
   startFrame: (label = "Start Frame", required = false) => p.file("startFrame", "image", { label, required }),
@@ -2056,7 +2062,6 @@ var { MODELS: MODELS10} = defineModels("wan", [
     estimatedTime: 26,
     mode: "video",
     inputType: "v2v",
-    disabled: true,
     badge: ["popular", "new"],
     description: "Wan 2.7 Video Edit \u2014 restyle or modify existing video with reference images.",
     features: [feat("Video Input", "input"), feat("Image Input", "input"), feat("1080P", "resolution")],
@@ -3358,10 +3363,10 @@ var { MODELS: MODELS21} = defineModels("google", [
     specName: "Gemini 3 Pro Image",
     workflow: "gemini/v2/images",
     buildPayload: buildGemini3ProImagePayload,
-    toolId: { by: "resolution", map: { "0.5K": "image-gen.gemini-3-pro-image.0.5k", "1K": "image-gen.gemini-3-pro-image.1k", "2K": "image-gen.gemini-3-pro-image.2k", "4K": "image-gen.gemini-3-pro-image.4k" } },
-    creditPrice: { "image-gen.gemini-3-pro-image.0.5k": 2, "image-gen.gemini-3-pro-image.1k": 3, "image-gen.gemini-3-pro-image.2k": 4, "image-gen.gemini-3-pro-image.4k": 5 },
+    toolId: { by: "resolution", map: { "1K": "image-gen.gemini-3-pro-image.1k", "2K": "image-gen.gemini-3-pro-image.2k", "4K": "image-gen.gemini-3-pro-image.4k" } },
+    creditPrice: { "image-gen.gemini-3-pro-image.1k": 3, "image-gen.gemini-3-pro-image.2k": 4, "image-gen.gemini-3-pro-image.4k": 5 },
     pricingUnit: "per_image",
-    estimatedTime: { "0.5K": 15, "1K": 30, "2K": 57, "4K": 74 },
+    estimatedTime: { "1K": 30, "2K": 57, "4K": 74 },
     mode: "image",
     inputType: "t2i",
     modelId: "gemini-3-pro-image-preview",
@@ -3371,7 +3376,7 @@ var { MODELS: MODELS21} = defineModels("google", [
     paramConfig: {
       ...params.prompt(),
       ...params.aspectRatio([...GEMINI_AR_WIDE], "1:1"),
-      ...params.resolution(["0.5K", "1K", "2K", "4K"], "2K"),
+      ...params.resolution(["1K", "2K", "4K"], "2K"),
       ...params.count(),
       ...params.imageInput(14, "Source Images")
     }
@@ -3689,7 +3694,7 @@ var { MODELS: MODELS23} = defineModels("elevenlabs", [
     buildPayload: buildElevenLabsSTSPayload,
     toolId: "audio-gen.eleven-sts-v2",
     creditPrice: { "audio-gen.eleven-sts-v2": 1 },
-    pricingUnit: "per_second",
+    pricingUnit: "per_minute",
     estimatedTime: 15,
     mode: "audio",
     inputType: "sts",
@@ -4681,17 +4686,17 @@ var buildEnhancePayload = (ctx) => ({
   upscale: { enabled: true, target_scale: 2 },
   face_enhancement: { enabled: true },
   colour_correction: { enabled: false },
-  output_format: "png"
+  output_format: "PNG"
 });
 var { MODELS: MODELS31} = defineModels("picsart", [
   {
     id: "picsart-change-bg",
     name: "Picsart Change Background",
-    workflow: "v3/smart-background",
+    workflow: "v4/smart-background",
     syncExecute: true,
     buildPayload: buildChangeBgPayload,
-    toolId: "image-gen.picsart-change-bg",
-    creditPrice: { "image-gen.picsart-change-bg": 2 },
+    toolId: "image-to-image.picsart-change-bg",
+    creditPrice: { "image-to-image.picsart-change-bg": 1 },
     pricingUnit: "per_image",
     mode: "image",
     inputType: "i2i",
@@ -4707,8 +4712,10 @@ var { MODELS: MODELS31} = defineModels("picsart", [
     name: "Remove Background",
     workflow: "pcp/v2/sod",
     syncExecute: true,
-    disabled: true,
     buildPayload: buildRemoveBgPayload,
+    toolId: "image-to-image.picsart-sod",
+    creditPrice: { "image-to-image.picsart-sod": 1 },
+    pricingUnit: "per_image",
     outputSchema: sodOutputSchema,
     mode: "image",
     inputType: "i2i",
@@ -4720,8 +4727,10 @@ var { MODELS: MODELS31} = defineModels("picsart", [
     id: "picsart-enhance",
     name: "Enhance",
     workflow: "pcp/v1/enhancement",
-    disabled: true,
     buildPayload: buildEnhancePayload,
+    toolId: "image-to-image.picsart-enhance",
+    creditPrice: { "image-to-image.picsart-enhance": 1 },
+    pricingUnit: "per_image",
     mode: "image",
     inputType: "i2i",
     estimatedTime: 30,
@@ -5622,48 +5631,6 @@ function createClient(config) {
   };
 }
 
-// src/core/descriptors/param-access.ts
-function getEnumOptions(model, key) {
-  const entry = model.paramConfig[key];
-  if (!entry) return null;
-  const d = entry.descriptor;
-  if (d.kind === "enum") {
-    return d.options.map((o) => o.id);
-  }
-  return null;
-}
-function getDefault(model, key) {
-  const entry = model.paramConfig[key];
-  if (!entry) return void 0;
-  const d = entry.descriptor;
-  return "default" in d ? d.default : void 0;
-}
-function getRange(model, key) {
-  const entry = model.paramConfig[key];
-  if (!entry) return null;
-  const d = entry.descriptor;
-  if (d.kind === "range") {
-    const r = d;
-    return { min: r.min, max: r.max, step: r.step, default: r.default };
-  }
-  return null;
-}
-function getFileParam(model, key) {
-  const entry = model.paramConfig[key];
-  if (!entry) return null;
-  const d = entry.descriptor;
-  if (d.kind === "file") {
-    const f = d;
-    return {
-      required: entry.required ?? false,
-      max: f.max,
-      label: entry.label,
-      accept: f.accept
-    };
-  }
-  return null;
-}
-
 // src/core/descriptors/model-accessor.ts
 var ModelParamsAccessorImpl = class {
   def;
@@ -5671,7 +5638,10 @@ var ModelParamsAccessorImpl = class {
     this.def = def;
   }
   param(key) {
-    return this.def.paramConfig[key];
+    const entry = this.def.paramConfig[key];
+    if (!entry) return void 0;
+    const { descriptor, ...meta } = entry;
+    return { ...meta, ...descriptor };
   }
   hasParam(key) {
     return key in this.def.paramConfig;
@@ -5724,19 +5694,19 @@ var ModelParamsAccessorImpl = class {
     return Object.values(this.def.paramConfig).some((e) => e.descriptor.kind === "file");
   }
   getDefault(key) {
-    return getDefault(this.def, key);
+    const entry = this.def.paramConfig[key];
+    if (!entry) return void 0;
+    const d = entry.descriptor;
+    return "default" in d ? d.default : void 0;
   }
   getDefaults() {
     return extractDefaults(this.def.paramConfig);
   }
+  /** @deprecated Use `enum(key)` instead. */
   getEnumOptions(key) {
-    return getEnumOptions(this.def, key);
-  }
-  getRange(key) {
-    return getRange(this.def, key);
-  }
-  getFileParam(key) {
-    return getFileParam(this.def, key);
+    const entry = this.def.paramConfig[key];
+    if (!entry || entry.descriptor.kind !== "enum") return null;
+    return entry.descriptor.options.map((o) => o.id);
   }
   toSchema() {
     return descriptorsToSchema(this.def.paramConfig);
@@ -5746,9 +5716,8 @@ var ModelParamsAccessorImpl = class {
   }
   narrow(key, kind) {
     const entry = this.param(key);
-    if (!entry || entry.descriptor.kind !== kind) return void 0;
-    const { descriptor, ...meta } = entry;
-    return { ...meta, ...descriptor };
+    if (!entry || entry.kind !== kind) return void 0;
+    return entry;
   }
 };
 var ModelMetaImpl = class {
@@ -6121,9 +6090,11 @@ var Models = {
   toSchema(id) {
     return Model(id).params().toSchema();
   },
-  /** @deprecated Use `Model(id).params().getFileParam(key)` instead. */
+  /** @deprecated Use `Model(id).params().file(key)` instead. */
   getFileParam(id, key) {
-    return Model(id).params().getFileParam(key);
+    const f = Model(id).params().file(key);
+    if (!f) return null;
+    return { required: f.required ?? false, max: f.array?.max ?? 1, label: f.label, accept: f.accept };
   },
   /** @deprecated Use `Model(id).params().hasParam(key)` instead. */
   hasParam(id, key) {

package/package.json

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