@picsart/ai-sdk 4.0.0 → 4.1.1

package/index.d.ts

@@ -1787,6 +1787,8 @@ interface ModelMeta {
     readonly features: ModelFeature[];
     readonly badges: BadgeType[];
     readonly provider: ProviderInfo;
+    /** ISO YYYY-MM-DD date the model was added to the catalog, or null if unknown. */
+    readonly addedAt: string | null;
     /** Release / availability tier. Absent on the definition ⇒ `'production'`. */
     readonly release: ReleaseTag;
 }
@@ -1824,12 +1826,29 @@ interface CreditRange {
     max: number;
     /** Pricing unit (e.g. 'generation', 'second', 'megapixel'). Set when all matched entries share a unit. */
     unit?: string;
+    /** Per-tier breakdown behind the range — one entry per pricing row (quality /
+     *  audio / token-type variant). Reflects the entries the range summarizes
+     *  (all tiers, or the ctx-filtered subset). */
+    tiers: CreditTier[];
 }
 /** Optional context to narrow the credit range by resolution / audio. */
 interface CreditRangeContext {
     resolution?: string;
     generateAudio?: boolean;
 }
+/** A single pricing tier for a model — one row of its rate table. */
+interface CreditTier {
+    /** Credits charged per `unit`. */
+    credits: number;
+    /** Billing unit (e.g. 'generation', 'second', 'megapixel', 'output_text_tokens'). */
+    unit: string;
+    /** Quality/resolution variant this rate applies to, when priced by quality. */
+    quality?: string;
+    /** Whether this rate is for audio-enabled generation. */
+    audio?: boolean;
+    /** Use case this rate applies to (e.g. 'text-to-video'). */
+    useCase?: string;
+}
 /** Top-level model accessor with grouped sub-accessors. */
 /** Result of validating generation input against a model's params. */
 interface ValidationResult$1 {
@@ -1846,10 +1865,11 @@ interface ModelDescriptor {
     /** Validate generation input against this model's params. Returns
      *  `{ valid: true }` or `{ valid: false, errors }` — never throws. */
     validate(input: unknown): ValidationResult$1;
-    /** Get the credit range for this model. Pass context to narrow by
-     *  resolution/audio. Returns the per-unit range — callers with time-based
-     *  parameters should scale by the value themselves (e.g. multiply by
-     *  duration when range.unit === 'second'). Returns null if pricing is not loaded. */
+    /** Get the credit range for this model, plus the per-tier breakdown in
+     *  `.tiers`. Pass context to narrow by resolution/audio. Returns the per-unit
+     *  range — callers with time-based parameters should scale by the value
+     *  themselves (e.g. multiply by duration when range.unit === 'second').
+     *  Returns null if pricing is not loaded or the model has no entry. */
     getCreditsInfo(ctx?: CreditRangeContext): CreditRange | null;
     /** Workflow identifiers for this model. */
     readonly api: {
@@ -2682,4 +2702,4 @@ declare const findModel: (ref: string) => ModelDefinition | undefined;
 /** Effect scenes that require two input images (e.g. hugs, kisses, swaps). */
 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, 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, 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 };

package/index.js

@@ -3436,7 +3436,6 @@ var { MODELS: MODELS10 } = defineModels("wan", [
     // start/end frames. buildPayload registered in wan.payloads.ts.
     workflow: "wan/v3/video",
     estimatedTime: 120,
-    release: "preview",
     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.",
@@ -3947,7 +3946,7 @@ var buildSeedance20PayloadFor = (modelAlias) => (ctx) => {
     ratio: ctx.aspectRatio ?? "16:9",
     duration: ctx.duration ?? 10,
     resolution: ctx.resolution ?? "720p",
-    generate_audio: ctx.generateAudio ?? false,
+    generate_audio: ctx.generateAudio ?? true,
     ...ctx.returnLastFrame ? { return_last_frame: true } : {}
   };
 };
@@ -3965,7 +3964,7 @@ var buildSeedance20VideoEditPayloadFor = (modelAlias) => (ctx) => ({
   ratio: ctx.aspectRatio ?? "16:9",
   duration: ctx.duration ?? 5,
   resolution: ctx.resolution ?? "720p",
-  generate_audio: ctx.generateAudio ?? false,
+  generate_audio: ctx.generateAudio ?? true,
   ...ctx.returnLastFrame ? { return_last_frame: true } : {}
 });
 var buildSeedance20VideoExtendPayloadFor = (modelAlias) => (ctx) => ({
@@ -3981,7 +3980,7 @@ var buildSeedance20VideoExtendPayloadFor = (modelAlias) => (ctx) => ({
   ratio: ctx.aspectRatio ?? "adaptive",
   duration: ctx.duration ?? 15,
   resolution: ctx.resolution ?? "720p",
-  generate_audio: ctx.generateAudio ?? false
+  generate_audio: ctx.generateAudio ?? true
 });
 var SEEDANCE_25_FRAME_ADAPTIVE_REASON = "First/Last Frame mode requires an adaptive aspect ratio \u2014 the vendor rejects any fixed ratio.";
 var seedance25Constraints = [
@@ -4036,7 +4035,7 @@ var buildSeedance25Payload = (ctx) => {
     ratio: usesFrame ? "adaptive" : ctx.aspectRatio ?? "16:9",
     duration: ctx.duration ?? 5,
     resolution: ctx.resolution ?? "720p",
-    generate_audio: ctx.generateAudio ?? false,
+    generate_audio: ctx.generateAudio ?? true,
     output_format: ctx.outputFormat ?? "mp4",
     ...ctx.returnLastFrame ? { return_last_frame: true } : {}
   };
@@ -4055,7 +4054,7 @@ var buildSeedance25VideoEditPayload = (ctx) => ({
   ratio: "adaptive",
   duration: -1,
   resolution: ctx.resolution ?? "720p",
-  generate_audio: ctx.generateAudio ?? false,
+  generate_audio: ctx.generateAudio ?? true,
   output_format: ctx.outputFormat ?? "mp4",
   ...ctx.returnLastFrame ? { return_last_frame: true } : {}
 });
@@ -4072,7 +4071,7 @@ var buildSeedance25VideoExtendPayload = (ctx) => ({
   ratio: "adaptive",
   duration: ctx.duration ?? 15,
   resolution: ctx.resolution ?? "720p",
-  generate_audio: ctx.generateAudio ?? false,
+  generate_audio: ctx.generateAudio ?? true,
   output_format: ctx.outputFormat ?? "mp4"
 });
 var SEEDANCE_AR = ["16:9", "9:16", "1:1", "4:3", "3:4", "21:9", "adaptive"];
@@ -4098,7 +4097,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.aspectRatio(SEEDANCE_AR),
       ...params.resolution(["480p", "720p"], "720p"),
       ...params.duration(SEEDANCE_25_DURATIONS, 5),
-      ...params.generateAudio(false),
+      ...params.generateAudio(),
       ...params.returnLastFrame(),
       ...p.enum("outputFormat", ["mp4", "mov"], "mp4", { label: "Format" }),
       // 2.5 lifts the reference caps to 30 images / 10 videos / 10 audios.
@@ -4128,7 +4127,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       // source-driven ('-1'), so neither is user-selectable (vendor rule).
       ...params.aspectRatio(["adaptive"]),
       ...params.resolution(["480p", "720p"], "720p"),
-      ...params.generateAudio(false),
+      ...params.generateAudio(),
       ...params.returnLastFrame(),
       ...p.enum("outputFormat", ["mp4", "mov"], "mp4", { label: "Format" }),
       ...params.videoInput("Source Video"),
@@ -4155,7 +4154,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.aspectRatio(["adaptive"]),
       ...params.resolution(["480p", "720p"], "720p"),
       ...params.duration(SEEDANCE_25_DURATIONS, 15),
-      ...params.generateAudio(false),
+      ...params.generateAudio(),
       ...p.enum("outputFormat", ["mp4", "mov"], "mp4", { label: "Format" }),
       ...params.videoInputs(10, "Source Videos", true)
     }
@@ -4179,7 +4178,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.aspectRatio(SEEDANCE_AR),
       ...params.resolution(["480p", "720p", "1080p", "4k"], "720p"),
       ...params.duration(SEEDANCE_V2_DURATIONS, 10),
-      ...params.generateAudio(false),
+      ...params.generateAudio(),
       ...params.returnLastFrame(),
       // Reference roles map directly to backend `reference_*` content entries.
       // start/end frame stay on their own named slots.
@@ -4209,7 +4208,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.aspectRatio(SEEDANCE_AR),
       ...params.resolution(["480p", "720p"], "720p"),
       ...params.duration(SEEDANCE_V2_DURATIONS, 10),
-      ...params.generateAudio(false),
+      ...params.generateAudio(),
       ...params.returnLastFrame(),
       // Reference roles map directly to backend `reference_*` content entries.
       // start/end frame stay on their own named slots.
@@ -4239,7 +4238,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.aspectRatio(SEEDANCE_AR),
       ...params.resolution(["480p", "720p"], "720p"),
       ...params.duration(SEEDANCE_V2_DURATIONS, 10),
-      ...params.generateAudio(false),
+      ...params.generateAudio(),
       ...params.returnLastFrame(),
       // Reference roles map directly to backend `reference_*` content entries.
       // start/end frame stay on their own named slots.
@@ -4268,7 +4267,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.aspectRatio(SEEDANCE_AR),
       ...params.resolution(["480p", "720p", "1080p", "4k"], "720p"),
       ...params.duration(SEEDANCE_V2_DURATIONS, 5),
-      ...params.generateAudio(false),
+      ...params.generateAudio(),
       ...params.returnLastFrame(),
       ...params.videoInput("Source Video"),
       ...params.imageInput(9, "Reference Images")
@@ -4292,7 +4291,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.aspectRatio(SEEDANCE_AR),
       ...params.resolution(["480p", "720p"], "720p"),
       ...params.duration(SEEDANCE_V2_DURATIONS, 5),
-      ...params.generateAudio(false),
+      ...params.generateAudio(),
       ...params.returnLastFrame(),
       ...params.videoInput("Source Video"),
       ...params.imageInput(9, "Reference Images")
@@ -4316,7 +4315,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.aspectRatio(SEEDANCE_AR),
       ...params.resolution(["480p", "720p"], "720p"),
       ...params.duration(SEEDANCE_V2_DURATIONS, 5),
-      ...params.generateAudio(false),
+      ...params.generateAudio(),
       ...params.returnLastFrame(),
       ...params.videoInput("Source Video"),
       ...params.imageInput(9, "Reference Images")
@@ -4340,7 +4339,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.aspectRatio(SEEDANCE_AR),
       ...params.resolution(["480p", "720p", "1080p", "4k"], "720p"),
       ...params.duration(SEEDANCE_V2_DURATIONS, 15),
-      ...params.generateAudio(false),
+      ...params.generateAudio(),
       ...params.videoInputs(3, "Source Videos", true)
     }
   },
@@ -4362,7 +4361,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.aspectRatio(SEEDANCE_AR),
       ...params.resolution(["480p", "720p"], "720p"),
       ...params.duration(SEEDANCE_V2_DURATIONS, 15),
-      ...params.generateAudio(false),
+      ...params.generateAudio(),
       ...params.videoInputs(3, "Source Videos", true)
     }
   },
@@ -4384,7 +4383,7 @@ var { MODELS: MODELS12 } = defineModels("seedance", [
       ...params.aspectRatio(SEEDANCE_AR),
       ...params.resolution(["480p", "720p"], "720p"),
       ...params.duration(SEEDANCE_V2_DURATIONS, 15),
-      ...params.generateAudio(false),
+      ...params.generateAudio(),
       ...params.videoInputs(3, "Source Videos", true)
     }
   },
@@ -10148,7 +10147,14 @@ function getCreditsForModel(modelId, ctx) {
     if (e.credits > max) max = e.credits;
     if (e.unit !== unit) unit = void 0;
   }
-  return unit ? { min, max, unit } : { min, max };
+  const tiers = entries.map((e) => ({
+    credits: e.credits,
+    unit: e.unit,
+    quality: e.metadata.quality || void 0,
+    audio: e.metadata.audio,
+    useCase: e.metadata.useCase
+  }));
+  return unit ? { min, max, unit, tiers } : { min, max, tiers };
 }
 
 // src/core/descriptors/model-accessor.ts
@@ -10379,6 +10385,7 @@ var ModelMetaImpl = class {
   features;
   badges;
   provider;
+  addedAt;
   release;
   constructor(def) {
     this.mode = def.mode;
@@ -10393,6 +10400,7 @@ var ModelMetaImpl = class {
       color: def.providerColor,
       label: def.providerLabel
     };
+    this.addedAt = def.addedAt ?? null;
   }
 };
 var ModelDescriptorImpl = class {

package/package.json

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