@picsart/ai-sdk 1.138.1 → 1.140.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")],
@@ -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",
@@ -5353,6 +5358,7 @@ var init_picsart = __esm({
         buildPayload: buildRemoveBgPayload,
         toolId: "image-to-image.picsart-sod",
         creditPrice: { "image-to-image.picsart-sod": 1 },
+        pricingUnit: "per_image",
         outputSchema: sodOutputSchema,
         mode: "image",
         inputType: "i2i",
@@ -5367,6 +5373,7 @@ var init_picsart = __esm({
         buildPayload: buildEnhancePayload,
         toolId: "image-to-image.picsart-enhance",
         creditPrice: { "image-to-image.picsart-enhance": 1 },
+        pricingUnit: "per_image",
         mode: "image",
         inputType: "i2i",
         estimatedTime: 30,
@@ -6263,11 +6270,19 @@ function createClient(config) {
       const completed = await executeModel(resolved, workflow, finalPayload, options?.signal);
       return parseResult(completed, resolved, contract);
     },
+    /** @deprecated Use `getCredits()` instead. */
+    async estimate(model, params2) {
+      if (!transport.options) return null;
+      const resolved = resolveModel(model);
+      const { workflow, payload } = prepareRequest(resolved, params2);
+      return await transport.options(workflow, payload) ?? null;
+    },
     /**
-     * Estimate credit cost for a generation.
+     * Get exact credit cost for a model with specific parameters.
+     * Calls the backend /options endpoint for real-time pricing.
      * Returns null if pricing is unavailable.
      */
-    async estimate(model, params2) {
+    async getCredits(model, params2) {
       if (!transport.options) return null;
       const resolved = resolveModel(model);
       const { workflow, payload } = prepareRequest(resolved, params2);
@@ -6361,52 +6376,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));
@@ -6431,7 +6400,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();
@@ -6441,7 +6409,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;
@@ -6494,19 +6465,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);
@@ -6516,9 +6487,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 {
@@ -6880,9 +6850,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) {
@@ -6897,7 +6869,6 @@ var init_descriptors = __esm({
   "src/core/descriptors/index.ts"() {
     init_utils();
     init_presets();
-    init_param_access();
     init_model_accessor();
   }
 });

package/index.d.ts

@@ -940,8 +940,10 @@ interface GenerateOptions {
 interface AiClient {
     /** Generate content using a model. Params are type-checked against the model's schema. */
     generate<M extends TypedModelId>(model: M, params: ModelInputById[M], options?: GenerateOptions): Promise<GenerateResult>;
-    /** Estimate credit cost for a generation. */
+    /** @deprecated Use `getCredits()` instead. */
     estimate<M extends TypedModelId>(model: M, params: ModelInputById[M]): Promise<number | null>;
+    /** Get exact credit cost for a model with specific parameters. */
+    getCredits<M extends TypedModelId>(model: M, params: ModelInputById[M]): Promise<number | null>;
     /** Submit a generation job and get a handle back. */
     submit<M extends TypedModelId>(model: M, params: ModelInputById[M], options?: GenerateOptions): Promise<WorkflowJobHandle>;
     /** Check the current status of a submitted job. */
@@ -1122,7 +1124,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 +1181,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 +1199,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 +1574,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")],
@@ -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",
@@ -4710,6 +4715,7 @@ var { MODELS: MODELS31} = defineModels("picsart", [
     buildPayload: buildRemoveBgPayload,
     toolId: "image-to-image.picsart-sod",
     creditPrice: { "image-to-image.picsart-sod": 1 },
+    pricingUnit: "per_image",
     outputSchema: sodOutputSchema,
     mode: "image",
     inputType: "i2i",
@@ -4724,6 +4730,7 @@ var { MODELS: MODELS31} = defineModels("picsart", [
     buildPayload: buildEnhancePayload,
     toolId: "image-to-image.picsart-enhance",
     creditPrice: { "image-to-image.picsart-enhance": 1 },
+    pricingUnit: "per_image",
     mode: "image",
     inputType: "i2i",
     estimatedTime: 30,
@@ -5538,11 +5545,19 @@ function createClient(config) {
       const completed = await executeModel(resolved, workflow, finalPayload, options?.signal);
       return parseResult(completed, resolved, contract);
     },
+    /** @deprecated Use `getCredits()` instead. */
+    async estimate(model, params2) {
+      if (!transport.options) return null;
+      const resolved = resolveModel(model);
+      const { workflow, payload } = prepareRequest(resolved, params2);
+      return await transport.options(workflow, payload) ?? null;
+    },
     /**
-     * Estimate credit cost for a generation.
+     * Get exact credit cost for a model with specific parameters.
+     * Calls the backend /options endpoint for real-time pricing.
      * Returns null if pricing is unavailable.
      */
-    async estimate(model, params2) {
+    async getCredits(model, params2) {
       if (!transport.options) return null;
       const resolved = resolveModel(model);
       const { workflow, payload } = prepareRequest(resolved, params2);
@@ -5624,48 +5639,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;
@@ -5673,7 +5646,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;
@@ -5726,19 +5702,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);
@@ -5748,9 +5724,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 {
@@ -6123,9 +6098,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.138.1",
+  "version": "1.140.0",
   "type": "module",
   "description": "Type-safe SDK for 100+ AI models — image, video, and audio generation with Picsart",
   "license": "MIT",