@picsart/ai-sdk 5.16.1 → 5.18.0

package/index.d.ts

@@ -17,12 +17,41 @@ interface WorkflowProgress {
     percent?: number;
     estimatedSecondsLeft?: number;
 }
+/**
+ * Per-tool credit usage entry inside {@link CreditUsage.details}
+ * (mirrors `ToolUsage` from `pa-pluggable-api-adapter`).
+ */
+interface ToolUsage {
+    operationId?: string;
+    toolId: string;
+    price: number;
+    amount: number;
+    credits: number;
+    failed?: boolean;
+}
+/**
+ * Credit usage reported on a completed task, as returned by the pluggable
+ * APIs platform on every task response (mirrors the adapter's public
+ * `CreditUsage` from `pa-pluggable-api-adapter`).
+ */
+interface CreditUsage {
+    /** The tool identifier. Set to "total_credits" when subtask usage is present. */
+    toolId?: string;
+    /** Per-tool credit usage breakdown. */
+    details?: ToolUsage[];
+    /** The amount of credits charged. */
+    credits: number;
+    /** The remaining balance. */
+    balance?: number;
+}
 interface WorkflowStatusResult<TResult = unknown> {
     handle: WorkflowJobHandle;
     status: WorkflowStatus;
     result?: TResult;
     error?: string;
     progress?: WorkflowProgress;
+    /** Credit usage reported by the platform, when present on the response. */
+    usage?: CreditUsage;
     raw: unknown;
 }
 /**
@@ -1043,25 +1072,25 @@ type ModelInputById = {
     };
     "recraftv4_styles": {
         prompt: string;
-        styleReferenceUrls: [string, ...string[]];
+        imageUrls: [string, ...string[]];
         aspectRatio?: "1:1" | "4:3" | "3:4" | "3:2" | "2:3" | "16:9" | "9:16" | "2:1" | "1:2";
         count?: 1 | 2 | 4 | 6;
     };
     "recraftv4_styles_pro": {
         prompt: string;
-        styleReferenceUrls: [string, ...string[]];
+        imageUrls: [string, ...string[]];
         aspectRatio?: "1:1" | "4:3" | "3:4" | "3:2" | "2:3" | "16:9" | "9:16" | "2:1" | "1:2";
         count?: 1 | 2 | 4 | 6;
     };
     "recraftv4_styles_pro_vector": {
         prompt: string;
-        styleReferenceUrls: [string, ...string[]];
+        imageUrls: [string, ...string[]];
         aspectRatio?: "1:1" | "4:3" | "3:4" | "3:2" | "2:3" | "16:9" | "9:16" | "2:1" | "1:2";
         count?: 1 | 2 | 4 | 6;
     };
     "recraftv4_styles_vector": {
         prompt: string;
-        styleReferenceUrls: [string, ...string[]];
+        imageUrls: [string, ...string[]];
         aspectRatio?: "1:1" | "4:3" | "3:4" | "3:2" | "2:3" | "16:9" | "9:16" | "2:1" | "1:2";
         count?: 1 | 2 | 4 | 6;
     };
@@ -1487,6 +1516,21 @@ type ModelInputById = {
         watermark?: boolean;
         seed?: number;
     };
+    "wan-3.0-video-prime": {
+        prompt: string;
+        duration?: 5 | 10 | 15 | 30;
+        resolution?: "480P" | "720P" | "1080P";
+        aspectRatio?: "16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "adaptive";
+        generateAudio?: boolean;
+        startFrame?: string;
+        endFrame?: string;
+        imageUrls?: string[];
+        videoUrls?: string[];
+        audioUrls?: string[];
+        enableThinking?: boolean;
+        watermark?: boolean;
+        seed?: number;
+    };
 };
 type TypedModelId = keyof ModelInputById;
 type ModelInput<M extends TypedModelId> = ModelInputById[M];
@@ -1993,9 +2037,6 @@ interface GenerationContext {
     language?: string;
     accent?: string;
     style?: string;
-    /** Recraft V4 Styles — style-reference image URLs (max 5, t2i only).
-     *  Required: the V4 Styles API rejects requests without a style. */
-    styleReferenceUrls?: string[];
     /**
      * Effect template id — a catalog-served content preset id (e.g. a Kling effect
      * scene from `kling/v1/catalog/templates`). Free string; the live catalog is
@@ -2127,6 +2168,15 @@ interface ModelDefinition {
     estimatedTime?: number | Record<string, number>;
     editEstimatedTime?: number | Record<string, number>;
     testTimeout?: number;
+    /**
+     * Per-model polling overrides for async jobs. Widens the global
+     * 2s × 300-attempt (~10 min) default for models whose generations can
+     * outlast it. Explicit per-call poll options still win.
+     */
+    pollOptions?: {
+        intervalMs?: number;
+        maxAttempts?: number;
+    };
 }
 
 /**
@@ -2307,6 +2357,8 @@ interface GenerateResult {
     handle: WorkflowJobHandle;
     /** Raw parsed output for advanced consumers. */
     raw: unknown;
+    /** Credit usage reported by the platform — same structure as the pluggable APIs' GenAITaskResponse. */
+    usage?: CreditUsage;
     /** Present when Drive is enabled and the file was saved. */
     drive?: DriveSaveResult;
 }
@@ -2318,8 +2370,10 @@ interface GenerateTextResult {
     model: string;
     /** Job handle for status tracking. */
     handle: WorkflowJobHandle;
-    /** Raw parsed output — carries usage, finish reason, thinking trace, etc. */
+    /** Raw parsed output — carries vendor token usage, finish reason, thinking trace, etc. */
     raw: unknown;
+    /** Credit usage reported by the platform — same structure as the pluggable APIs' GenAITaskResponse. */
+    usage?: CreditUsage;
 }
 /** Options for individual generate() / submit() calls. */
 interface GenerateOptions {
@@ -2607,6 +2661,7 @@ declare const Models: {
     readonly Wan27T2v: "wan-2.7-t2v";
     readonly Wan27VideoEdit: "wan-2.7-video-edit";
     readonly Wan30Video: "wan-3.0-video";
+    readonly Wan30VideoPrime: "wan-3.0-video-prime";
     /** @deprecated Use the `catalog` accessor (`catalog.all()` / `catalog.find({ output, provider })`) instead. */
     readonly list: (filter?: ModelFilter) => ModelDefinition[];
     /** @deprecated Use `Model(id).validate(input)` instead. */
@@ -2762,4 +2817,4 @@ declare const findModel: (ref: string) => ModelDefinition | undefined;
  */
 declare const KLING_DUAL_IMAGE_EFFECTS: ReadonlySet<string>;
 
-export { ALL_MODELS, type AiClient, type ApiResponse, type ApiRunOptions, type ApiSchemas, type ApisClient, type AppIdentity, type AppType, type AuthenticatedFetch, type AvatarOption, type BooleanDescriptor, type BooleanEntry, type CatalogDescriptor, type CatalogEntry, type CatalogItem, type CatalogKind, type CatalogPage, type CatalogPageOptions, type CatalogPreview, type CatalogQuery, type CatalogResult, type CatalogSource, type CatalogsClient, type CatalogsOptions, type ClientConfig, type CreditRange, type CreditRangeContext, type CreditTier, DEFAULT_VISIBLE_RELEASES, type DeepLinkResult, type DriveAttributes, type DriveClient, type DriveConfig, type DriveFile, type DriveFileDetails, type DriveFolder, type DriveMediaItem, type DriveSaveResult, type EntryMeta, type EnumDescriptor, type EnumEntry, type EnumOption, type FileDescriptor, type FileEntry, type FlatParamEntry, type GenerateOptions, type GenerateResult, type GenerateResultItem, type GenerateTextResult, type GenerationContext, type GenerationFile, type GenerationMode, KLING_DUAL_IMAGE_EFFECTS, type ListOptions, type MediaModelId, 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 PricingOptions, type ProviderInfo, type RangeDescriptor, type RangeEntry, type ReleaseTag, type SaveParams, type SdkPayload, type SdkTransport, type TextDescriptor, type TextEntry, type TextModelId, type TextModelInputById, type TypedModelId, type UserReaction, type ValidationResult$1 as ValidationResult, type VoiceOption, type WorkflowJobHandle, buildFilename, buildGenerationAttributes, catalog, createClient, decodeDeepLinkPayload, encodeDeepLinkPayload, findModel, getModel, getModelsByMode, getVoiceById, inferResourceType, isVisibleForReleases, parseGeneration, releaseOf, toAvatarOption, toVoiceOption };
+export { ALL_MODELS, type AiClient, type ApiResponse, type ApiRunOptions, type ApiSchemas, type ApisClient, type AppIdentity, type AppType, type AuthenticatedFetch, type AvatarOption, type BooleanDescriptor, type BooleanEntry, type CatalogDescriptor, type CatalogEntry, type CatalogItem, type CatalogKind, type CatalogPage, type CatalogPageOptions, type CatalogPreview, type CatalogQuery, type CatalogResult, type CatalogSource, type CatalogsClient, type CatalogsOptions, type ClientConfig, type CreditRange, type CreditRangeContext, type CreditTier, type CreditUsage, DEFAULT_VISIBLE_RELEASES, type DeepLinkResult, type DriveAttributes, type DriveClient, type DriveConfig, type DriveFile, type DriveFileDetails, type DriveFolder, type DriveMediaItem, type DriveSaveResult, type EntryMeta, type EnumDescriptor, type EnumEntry, type EnumOption, type FileDescriptor, type FileEntry, type FlatParamEntry, type GenerateOptions, type GenerateResult, type GenerateResultItem, type GenerateTextResult, type GenerationContext, type GenerationFile, type GenerationMode, KLING_DUAL_IMAGE_EFFECTS, type ListOptions, type MediaModelId, 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 PricingOptions, type ProviderInfo, type RangeDescriptor, type RangeEntry, type ReleaseTag, type SaveParams, type SdkPayload, type SdkTransport, type TextDescriptor, type TextEntry, type TextModelId, type TextModelInputById, type ToolUsage, type TypedModelId, type UserReaction, type ValidationResult$1 as ValidationResult, type VoiceOption, type WorkflowJobHandle, buildFilename, buildGenerationAttributes, catalog, createClient, decodeDeepLinkPayload, encodeDeepLinkPayload, findModel, getModel, getModelsByMode, getVoiceById, inferResourceType, isVisibleForReleases, parseGeneration, releaseOf, toAvatarOption, toVoiceOption };

package/index.js

@@ -474,6 +474,8 @@ function parseWorkflowStatus(handle, raw) {
   const statusRaw = pickFirst(raw, [["response", "status"], ["status"]]);
   const status = normalizeStatus(statusRaw);
   const result = pickFirst(raw, [["response", "result"], ["result"]]);
+  const usageRaw = pickFirst(raw, [["response", "usage"], ["usage"]]);
+  const usage = usageRaw && typeof usageRaw === "object" && (typeof usageRaw.credits === "number" || Array.isArray(usageRaw.details)) ? usageRaw : void 0;
   const errorRaw = pickFirst(raw, [["response", "error"], ["error"], ["message"], ["reason"]]);
   const progressRaw = pickFirst(raw, [["response", "progress"], ["progress"]]);
   const progress = progressRaw && typeof progressRaw === "object" ? {
@@ -486,6 +488,7 @@ function parseWorkflowStatus(handle, raw) {
     result,
     error: typeof errorRaw === "string" ? errorRaw : void 0,
     progress,
+    usage,
     raw
   };
 }
@@ -1198,6 +1201,7 @@ function defineModels(provider, configs) {
     if (c.estimatedTime !== void 0) model.estimatedTime = c.estimatedTime;
     if (c.editEstimatedTime !== void 0) model.editEstimatedTime = c.editEstimatedTime;
     if (c.testTimeout !== void 0) model.testTimeout = c.testTimeout;
+    if (c.pollOptions !== void 0) model.pollOptions = c.pollOptions;
     if (c.badge !== void 0) model.badge = c.badge;
     if (c.addedAt !== void 0) model.addedAt = c.addedAt;
     if (c.disabled !== void 0) model.disabled = c.disabled;
@@ -2924,6 +2928,22 @@ var wanV3Constraints = [
     audioUrls: { disabled: true, reason: WAN_V3_FRAME_REF_REASON }
   } }
 ];
+var wanV3Features = [feat("Image Input", "input"), feat("Video Input", "input"), feat("Audio", "audio"), feat("Start/End Frame", "frame"), feat("1080P", "resolution"), feat("Adaptive Ratio", "resolution")];
+var wanV3ParamConfig = {
+  ...params.prompt(),
+  ...params.duration([5, 10, 15, 30], 5),
+  ...params.resolution(["480P", "720P", "1080P"], "1080P"),
+  ...params.aspectRatio(["16:9", "9:16", "1:1", "4:3", "3:4", "adaptive"]),
+  ...params.generateAudio(true),
+  ...params.startFrame(),
+  ...params.endFrame(),
+  ...params.imageInput(10, "Reference Images"),
+  ...params.videoInputs(5, "Reference Videos", false),
+  ...params.audioInputs(5, "Reference Audios"),
+  ...p.boolean("enableThinking", false, "Deep Thinking"),
+  ...p.boolean("watermark", false, "Watermark"),
+  ...p.range("seed", 0, 2147483647, 0, { label: "Seed" })
+};
 var { MODELS: MODELS10 } = defineModels("wan", [
   // ── Video ─────────────────────────────────────────
   {
@@ -3091,6 +3111,10 @@ var { MODELS: MODELS10 } = defineModels("wan", [
     }
   },
   // ── Wan 3.0 all-in-one Video ─────────────────────────
+  // wan-3.0-video and wan-3.0-video-prime share the wan/v3/video workflow and
+  // the full param surface — the backend `model` enum value (hardcoded per
+  // entry in wan.payloads.ts) is the only wire difference. Prime is the same
+  // model, up to 7x faster.
   {
     id: "wan-3.0-video",
     name: "Wan 3.0",
@@ -3103,28 +3127,32 @@ var { MODELS: MODELS10 } = defineModels("wan", [
     mode: "video",
     inputType: "t2v",
     description: "Wan 3.0 all-in-one \u2014 text, image/video/audio references, and start/end frames with adaptive ratio, intelligent duration, and audio.",
-    features: [feat("Image Input", "input"), feat("Video Input", "input"), feat("Audio", "audio"), feat("Start/End Frame", "frame"), feat("1080P", "resolution"), feat("Adaptive Ratio", "resolution")],
+    features: [...wanV3Features],
     constraints: wanV3Constraints,
-    paramConfig: {
-      ...params.prompt(),
-      ...params.duration([5, 10, 15, 30], 5),
-      ...params.resolution(["480P", "720P", "1080P"], "1080P"),
-      ...params.aspectRatio(["16:9", "9:16", "1:1", "4:3", "3:4", "adaptive"]),
-      ...params.generateAudio(true),
-      ...params.startFrame(),
-      ...params.endFrame(),
-      ...params.imageInput(10, "Reference Images"),
-      ...params.videoInputs(5, "Reference Videos", false),
-      ...params.audioInputs(5, "Reference Audios"),
-      ...p.boolean("enableThinking", false, "Deep Thinking"),
-      ...p.boolean("watermark", false, "Watermark"),
-      ...p.range("seed", 0, 2147483647, 0, { label: "Seed" })
-    }
+    // Generations at 1080P / long durations can outlast the global 10-min
+    // polling default — widen to 5s × 360 attempts (30 min).
+    pollOptions: { intervalMs: 5e3, maxAttempts: 360 },
+    paramConfig: { ...wanV3ParamConfig }
+  },
+  {
+    id: "wan-3.0-video-prime",
+    name: "Wan 3.0 Prime",
+    modelId: "wan3.0-video-prime",
+    addedAt: "2026-08-26",
+    workflow: "wan/v3/video",
+    estimatedTime: 30,
+    mode: "video",
+    inputType: "t2v",
+    description: "Wan 3.0 Prime \u2014 the same all-in-one model as Wan 3.0, up to 7x faster.",
+    features: [...wanV3Features],
+    constraints: wanV3Constraints,
+    pollOptions: { intervalMs: 5e3, maxAttempts: 360 },
+    paramConfig: { ...wanV3ParamConfig }
   }
 ]);
 
 // src/vendors/catalog/wan.payloads.ts
-var buildWanV3VideoPayload = (input) => {
+var makeWanV3VideoPayload = (model) => (input) => {
   const media = [];
   if (input.startFrame) media.push({ type: "first_frame", url: input.startFrame });
   if (input.endFrame) media.push({ type: "last_frame", url: input.endFrame });
@@ -3138,7 +3166,7 @@ var buildWanV3VideoPayload = (input) => {
     for (const url of input.audioUrls) media.push({ type: "reference_audio", url });
   }
   return {
-    model: "wan3.0-video",
+    model,
     resolution: input.resolution ?? "1080P",
     ratio: input.aspectRatio ?? "16:9",
     duration: input.duration ?? 5,
@@ -3151,7 +3179,8 @@ var buildWanV3VideoPayload = (input) => {
   };
 };
 registerPayloads(MODELS10, {
-  "wan-3.0-video": buildWanV3VideoPayload
+  "wan-3.0-video": makeWanV3VideoPayload("wan3.0-video"),
+  "wan-3.0-video-prime": makeWanV3VideoPayload("wan3.0-video-prime")
 });
 
 // src/vendors/catalog/luma.ts
@@ -6712,15 +6741,15 @@ var buildRecraftUtilityPayload = (includePrompt) => (ctx) => ({
   ...includePrompt && ctx.prompt ? { prompt: ctx.prompt } : {}
 });
 var buildRecraftV4StylesPayload = (apiModel) => (ctx) => {
-  if (!ctx.styleReferenceUrls?.length) {
-    throw new Error("V4 Styles models require styleReferenceUrls");
+  if (!ctx.imageUrls?.length) {
+    throw new Error("V4 Styles models require style-reference images");
   }
   return {
     prompt: ctx.prompt,
     model: apiModel,
     n: ctx.count ?? 1,
     ...ctx.aspectRatio ? { size: ctx.aspectRatio } : {},
-    style_reference_urls: ctx.styleReferenceUrls
+    style_reference_urls: ctx.imageUrls
   };
 };
 var buildRecraftV4VariantPayload = (apiModel) => (ctx) => ({
@@ -6739,7 +6768,7 @@ var buildRecraftExploreSimilarPayload = (ctx) => ({
   similarity: ctx.similarity ?? 3,
   ...ctx.aspectRatio ? { size: ctx.aspectRatio } : {}
 });
-var v4StylesParams = p.file("styleReferenceUrls", "image", {
+var v4StylesParams = p.file("imageUrls", "image", {
   label: "Style References",
   required: true,
   array: { min: 1, max: 5 },
@@ -8552,12 +8581,13 @@ var extractAllResults = (result) => {
   }
   return void 0;
 };
-function toCompletedStatus(handle, result, raw) {
+function toCompletedStatus(handle, result, raw, usage) {
   return {
     handle,
     status: "COMPLETED",
     result,
-    raw
+    raw,
+    usage
   };
 }
 
@@ -8710,13 +8740,13 @@ function parseResult(completed, model, contract) {
       url: item.url,
       metadata: item.exploreImageId ? { exploreImageId: item.exploreImageId } : void 0
     }));
-    return { url: results[0].url, results, model: model.id, handle: completed.handle, raw: parsed };
+    return { url: results[0].url, results, model: model.id, handle: completed.handle, raw: parsed, usage: completed.usage };
   }
   const url = extractUrl(parsed);
   if (!url) {
     throw new Error(`${model.name}: unexpected response \u2014 no result URL`);
   }
-  return { url, results: [{ url }], model: model.id, handle: completed.handle, raw: parsed };
+  return { url, results: [{ url }], model: model.id, handle: completed.handle, raw: parsed, usage: completed.usage };
 }
 function parseTextResult(completed, model) {
   if (completed.status === "FAILED") {
@@ -8731,7 +8761,7 @@ function parseTextResult(completed, model) {
   if (text == null) {
     throw new Error(`${model.name}: unexpected response \u2014 no text`);
   }
-  return { text, model: model.id, handle: completed.handle, raw: completed.raw ?? completed.result };
+  return { text, model: model.id, handle: completed.handle, raw: completed.raw ?? completed.result, usage: completed.usage };
 }
 
 // src/core/limits.ts
@@ -9807,10 +9837,11 @@ function createClient(config) {
       return toCompletedStatus(
         syncResponse.handle,
         extractSyncResult(syncResponse.raw),
-        syncResponse.raw
+        syncResponse.raw,
+        syncResponse.usage
       );
     }
-    return client.run({ workflow, payload, signal });
+    return client.run({ workflow, payload, signal }, model.pollOptions);
   }
   function buildDrivePayloadOptions(model, params2, options) {
     const explicit = options?.drive;
@@ -9911,7 +9942,7 @@ function createClient(config) {
     async result(handle, model, options) {
       const resolved = resolveModel(model);
       const contract = getModelContract(resolved.id);
-      const completed = await client.result(handle, options);
+      const completed = await client.result(handle, { ...resolved.pollOptions, ...options });
       return parseResult(completed, resolved, contract);
     },
     /**
@@ -10603,6 +10634,7 @@ var Wan27R2v = "wan-2.7-r2v";
 var Wan27T2v = "wan-2.7-t2v";
 var Wan27VideoEdit = "wan-2.7-video-edit";
 var Wan30Video = "wan-3.0-video";
+var Wan30VideoPrime = "wan-3.0-video-prime";
 var Models = {
   AsyncFlashV1,
   BytedanceOmnihumanV15,
@@ -10809,6 +10841,7 @@ var Models = {
   Wan27T2v,
   Wan27VideoEdit,
   Wan30Video,
+  Wan30VideoPrime,
   /** @deprecated Use the `catalog` accessor (`catalog.all()` / `catalog.find({ output, provider })`) instead. */
   list(filter) {
     if (!filter) return [...ALL_MODELS];

package/package.json

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