@picsart/ai-sdk 1.139.0 → 1.143.1

package/_cli.js

@@ -6270,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);
@@ -6909,6 +6917,76 @@ var init_deeplink = __esm({
   }
 });
 
+// src/core/pricing.ts
+function resolveToolId(mapping, ctx) {
+  if (!mapping) return void 0;
+  if (typeof mapping === "string") return mapping;
+  let next;
+  switch (mapping.by) {
+    case "audio":
+      next = ctx.generateAudio ?? false ? mapping.on : mapping.off;
+      break;
+    case "resolution": {
+      const key = ctx.resolution ?? Object.keys(mapping.map)[0];
+      next = mapping.map[key] ?? Object.values(mapping.map)[0];
+      break;
+    }
+    case "quality": {
+      const key = String(ctx.quality ?? Object.keys(mapping.map)[0]);
+      next = mapping.map[key] ?? Object.values(mapping.map)[0];
+      break;
+    }
+    case "renderingSpeed": {
+      const key = String(ctx.renderingSpeed ?? Object.keys(mapping.map)[0]);
+      next = mapping.map[key] ?? Object.values(mapping.map)[0];
+      break;
+    }
+    case "duration": {
+      const key = String(ctx.duration ?? Object.keys(mapping.map)[0]);
+      next = mapping.map[key] ?? Object.values(mapping.map)[0];
+      break;
+    }
+    case "megapixel": {
+      const mp = ctx.outputMegapixels ?? 0;
+      const tiers = Object.keys(mapping.map).map(Number).sort((a, b) => a - b);
+      const tier = tiers.find((t) => mp <= t) ?? tiers[tiers.length - 1];
+      next = mapping.map[String(tier)];
+      break;
+    }
+  }
+  return resolveToolId(next, ctx);
+}
+function getAllToolIds(model) {
+  const ids = [];
+  const extract = (m) => {
+    if (!m) return;
+    if (typeof m === "string") {
+      ids.push(m);
+      return;
+    }
+    switch (m.by) {
+      case "resolution":
+      case "quality":
+      case "renderingSpeed":
+      case "duration":
+      case "megapixel":
+        for (const v of Object.values(m.map)) extract(v);
+        break;
+      case "audio":
+        extract(m.on);
+        extract(m.off);
+        break;
+    }
+  };
+  extract(model.toolId);
+  extract(model.editToolId);
+  return ids;
+}
+var init_pricing = __esm({
+  "src/core/pricing.ts"() {
+  }
+});
+
 // src/index.ts
 var init_src = __esm({
   "src/index.ts"() {
@@ -6920,6 +6998,7 @@ var init_src = __esm({
     init_deeplink();
     init_catalog();
     init_model_registry();
+    init_pricing();
   }
 });
 
@@ -11572,74 +11651,7 @@ Done: ${uploaded} uploaded, ${failed} failed`);
 init_base_command();
 init_src();
 init_model_registry();
-
-// src/core/pricing.ts
-function resolveToolId(mapping, ctx) {
-  if (!mapping) return void 0;
-  if (typeof mapping === "string") return mapping;
-  let next;
-  switch (mapping.by) {
-    case "audio":
-      next = ctx.generateAudio ?? false ? mapping.on : mapping.off;
-      break;
-    case "resolution": {
-      const key = ctx.resolution ?? Object.keys(mapping.map)[0];
-      next = mapping.map[key] ?? Object.values(mapping.map)[0];
-      break;
-    }
-    case "quality": {
-      const key = String(ctx.quality ?? Object.keys(mapping.map)[0]);
-      next = mapping.map[key] ?? Object.values(mapping.map)[0];
-      break;
-    }
-    case "renderingSpeed": {
-      const key = String(ctx.renderingSpeed ?? Object.keys(mapping.map)[0]);
-      next = mapping.map[key] ?? Object.values(mapping.map)[0];
-      break;
-    }
-    case "duration": {
-      const key = String(ctx.duration ?? Object.keys(mapping.map)[0]);
-      next = mapping.map[key] ?? Object.values(mapping.map)[0];
-      break;
-    }
-    case "megapixel": {
-      const mp = ctx.outputMegapixels ?? 0;
-      const tiers = Object.keys(mapping.map).map(Number).sort((a, b) => a - b);
-      const tier = tiers.find((t) => mp <= t) ?? tiers[tiers.length - 1];
-      next = mapping.map[String(tier)];
-      break;
-    }
-  }
-  return resolveToolId(next, ctx);
-}
-function getAllToolIds(model) {
-  const ids = [];
-  const extract = (m) => {
-    if (!m) return;
-    if (typeof m === "string") {
-      ids.push(m);
-      return;
-    }
-    switch (m.by) {
-      case "resolution":
-      case "quality":
-      case "renderingSpeed":
-      case "duration":
-      case "megapixel":
-        for (const v of Object.values(m.map)) extract(v);
-        break;
-      case "audio":
-        extract(m.on);
-        extract(m.off);
-        break;
-    }
-  };
-  extract(model.toolId);
-  extract(model.editToolId);
-  return ids;
-}
-
-// _cli/src/commands/pricing.ts
+init_pricing();
 init_usage();
 init_key_value();
 var Pricing = class _Pricing extends BaseCommand {

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. */
@@ -1647,4 +1649,9 @@ declare const getModel: (id: string) => ModelDefinition | undefined;
 /** Find a model by ID, workflow name, or display name (case-insensitive). */
 declare const findModel: (ref: string) => ModelDefinition | undefined;
 
-export { ALL_MODELS, type AiClient, type AuthenticatedFetch, type AvatarOption, type BooleanDescriptor, type BooleanEntry, type ClientConfig, type DeepLinkResult, type DriveConfig, type DriveFileDetails, type DriveFolder, type DriveMediaItem, type DriveSaveResult, type EntryMeta, type EnumDescriptor, type EnumEntry, type FileDescriptor, type FileEntry, type FlatParamEntry, type GenerateOptions, type GenerateResult, type GenerateResultItem, type GenerationContext, type GenerationMode, type ListOptions, type MediaTypeFilter, Model, type ModelDefinition, type ModelDescriptor, type ModelFilter$1 as ModelFilter, type ModelInput, type ModelInputById, type ModelMeta, type ModelParams, type ModelParamsAccessor, Models, type ObjectDescriptor, type ObjectEntry, type ParamDescriptor, type ParamEntry, type ParamOption, type PayloadDriveFolderOptions, type PayloadDriveOptions, type ProviderInfo, type RangeDescriptor, type RangeEntry, type SaveParams, type SdkTransport, type TextDescriptor, type TextEntry, type TypedModelId, type VoiceOption, type WorkflowJobHandle, buildFilename, createClient, decodeDeepLinkPayload, encodeDeepLinkPayload, findModel, getModel, getModelsByMode, getVoiceById, inferResourceType };
+/** Resolve a ToolIdMapping to a concrete toolId for a generation context. Recursive. */
+declare function resolveToolId(mapping: ToolIdMapping | undefined, ctx: Partial<GenerationContext>): string | undefined;
+/** Return all toolIds a model can resolve to (toolId + editToolId variants). Recursive. */
+declare function getAllToolIds(model: ModelDefinition): string[];
+
+export { ALL_MODELS, type AiClient, type AuthenticatedFetch, type AvatarOption, type BooleanDescriptor, type BooleanEntry, type ClientConfig, type DeepLinkResult, type DriveConfig, type DriveFileDetails, type DriveFolder, type DriveMediaItem, type DriveSaveResult, type EntryMeta, type EnumDescriptor, type EnumEntry, type FileDescriptor, type FileEntry, type FlatParamEntry, type GenerateOptions, type GenerateResult, type GenerateResultItem, type GenerationContext, type GenerationMode, type ListOptions, type MediaTypeFilter, Model, type ModelDefinition, type ModelDescriptor, type ModelFilter$1 as ModelFilter, type ModelInput, type ModelInputById, type ModelMeta, type ModelParams, type ModelParamsAccessor, Models, type ObjectDescriptor, type ObjectEntry, type ParamDescriptor, type ParamEntry, type ParamOption, type PayloadDriveFolderOptions, type PayloadDriveOptions, type ProviderInfo, type RangeDescriptor, type RangeEntry, type SaveParams, type SdkTransport, type TextDescriptor, type TextEntry, type TypedModelId, type VoiceOption, type WorkflowJobHandle, buildFilename, createClient, decodeDeepLinkPayload, encodeDeepLinkPayload, findModel, getAllToolIds, getModel, getModelsByMode, getVoiceById, inferResourceType, resolveToolId };

package/index.js

@@ -5545,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);
@@ -6282,4 +6290,70 @@ function decodeDeepLinkPayload(encoded) {
   return deserializePayload(encoded);
 }
 
-export { ALL_MODELS, Model, Models, buildFilename, createClient, decodeDeepLinkPayload, encodeDeepLinkPayload, findModel, getModel, getModelsByMode, getVoiceById, inferResourceType };
+// src/core/pricing.ts
+function resolveToolId(mapping, ctx) {
+  if (!mapping) return void 0;
+  if (typeof mapping === "string") return mapping;
+  let next;
+  switch (mapping.by) {
+    case "audio":
+      next = ctx.generateAudio ?? false ? mapping.on : mapping.off;
+      break;
+    case "resolution": {
+      const key = ctx.resolution ?? Object.keys(mapping.map)[0];
+      next = mapping.map[key] ?? Object.values(mapping.map)[0];
+      break;
+    }
+    case "quality": {
+      const key = String(ctx.quality ?? Object.keys(mapping.map)[0]);
+      next = mapping.map[key] ?? Object.values(mapping.map)[0];
+      break;
+    }
+    case "renderingSpeed": {
+      const key = String(ctx.renderingSpeed ?? Object.keys(mapping.map)[0]);
+      next = mapping.map[key] ?? Object.values(mapping.map)[0];
+      break;
+    }
+    case "duration": {
+      const key = String(ctx.duration ?? Object.keys(mapping.map)[0]);
+      next = mapping.map[key] ?? Object.values(mapping.map)[0];
+      break;
+    }
+    case "megapixel": {
+      const mp = ctx.outputMegapixels ?? 0;
+      const tiers = Object.keys(mapping.map).map(Number).sort((a, b) => a - b);
+      const tier = tiers.find((t) => mp <= t) ?? tiers[tiers.length - 1];
+      next = mapping.map[String(tier)];
+      break;
+    }
+  }
+  return resolveToolId(next, ctx);
+}
+function getAllToolIds(model) {
+  const ids = [];
+  const extract = (m) => {
+    if (!m) return;
+    if (typeof m === "string") {
+      ids.push(m);
+      return;
+    }
+    switch (m.by) {
+      case "resolution":
+      case "quality":
+      case "renderingSpeed":
+      case "duration":
+      case "megapixel":
+        for (const v of Object.values(m.map)) extract(v);
+        break;
+      case "audio":
+        extract(m.on);
+        extract(m.off);
+        break;
+    }
+  };
+  extract(model.toolId);
+  extract(model.editToolId);
+  return ids;
+}
+
+export { ALL_MODELS, Model, Models, buildFilename, createClient, decodeDeepLinkPayload, encodeDeepLinkPayload, findModel, getAllToolIds, getModel, getModelsByMode, getVoiceById, inferResourceType, resolveToolId };

package/package.json

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