pricetoken 0.12.0 → 0.13.1

package/dist/index.d.mts

@@ -264,6 +264,47 @@ interface SttProviderSummary {
     modelCount: number;
     cheapestCostPerMinute: number;
 }
+interface MusicModelPricing {
+    modelId: string;
+    provider: string;
+    displayName: string;
+    costPerMinute: number;
+    maxDuration: number | null;
+    outputFormat: string | null;
+    vocals: boolean | null;
+    official: boolean;
+    pricingNote: string | null;
+    source: 'fetched' | 'seed' | 'admin' | 'verified' | 'carried';
+    status: ModelStatus | null;
+    confidence: DataConfidence;
+    confidenceScore: number;
+    confidenceLevel: ConfidenceLevel;
+    freshness: FreshnessInfo;
+    lastUpdated: string | null;
+    launchDate: string | null;
+}
+interface MusicCostEstimate {
+    modelId: string;
+    durationSeconds: number;
+    costPerMinute: number;
+    totalCost: number;
+}
+interface MusicPriceHistoryPoint {
+    date: string;
+    costPerMinute: number;
+}
+interface MusicModelHistory {
+    modelId: string;
+    provider: string;
+    displayName: string;
+    history: MusicPriceHistoryPoint[];
+}
+interface MusicProviderSummary {
+    id: string;
+    displayName: string;
+    modelCount: number;
+    cheapestCostPerMinute: number;
+}
 
 interface ClientOptions {
     baseUrl?: string;
@@ -422,6 +463,30 @@ declare class PriceTokenClient {
         after?: string;
         before?: string;
     }): Promise<SttModelPricing>;
+    getMusicPricing(opts?: {
+        provider?: string;
+        currency?: string;
+        after?: string;
+        before?: string;
+    }): Promise<MusicModelPricing[]>;
+    getMusicModel(modelId: string, opts?: {
+        currency?: string;
+    }): Promise<MusicModelPricing>;
+    getMusicHistory(opts?: {
+        days?: number;
+        modelId?: string;
+        provider?: string;
+    }): Promise<MusicModelHistory[]>;
+    getMusicProviders(): Promise<MusicProviderSummary[]>;
+    compareMusicModels(modelIds: string[], opts?: {
+        currency?: string;
+    }): Promise<MusicModelPricing[]>;
+    getCheapestMusicModel(opts?: {
+        provider?: string;
+        currency?: string;
+        after?: string;
+        before?: string;
+    }): Promise<MusicModelPricing>;
 }
 
 declare function calculateCost(modelId: string, inputPerMTok: number, outputPerMTok: number, inputTokens: number, outputTokens: number): CostEstimate;
@@ -442,6 +507,9 @@ declare function calculateTtsModelCost(modelId: string, characters: number, pric
 declare function calculateSttCost(modelId: string, costPerMinute: number, durationSeconds: number): SttCostEstimate;
 declare function calculateSttModelCost(modelId: string, durationSeconds: number, pricing?: SttModelPricing[]): SttCostEstimate;
 
+declare function calculateMusicCost(modelId: string, costPerMinute: number, durationSeconds: number): MusicCostEstimate;
+declare function calculateMusicModelCost(modelId: string, durationSeconds: number, pricing?: MusicModelPricing[]): MusicCostEstimate;
+
 declare const STATIC_PRICING: ModelPricing[];
 
 declare const STATIC_IMAGE_PRICING: ImageModelPricing[];
@@ -454,4 +522,6 @@ declare const STATIC_TTS_PRICING: TtsModelPricing[];
 
 declare const STATIC_STT_PRICING: SttModelPricing[];
 
-export { type AvatarCostEstimate, type AvatarModelHistory, type AvatarModelPricing, type AvatarPriceHistoryPoint, type AvatarProviderSummary, type ClientOptions, type ConfidenceLevel, type CostEstimate, type DataConfidence, type FreshnessInfo, type ImageCostEstimate, type ImageModelHistory, type ImageModelPricing, type ImagePriceHistoryPoint, type ImageProviderSummary, type ImageQualityTier, type ModelHistory, type ModelPricing, type ModelStatus, type PriceHistoryPoint, PriceTokenClient, type PriceTokenError, type PriceTokenResponse, type ProviderSummary, STATIC_AVATAR_PRICING, STATIC_IMAGE_PRICING, STATIC_PRICING, STATIC_STT_PRICING, STATIC_TTS_PRICING, STATIC_VIDEO_PRICING, type SttCostEstimate, type SttModelHistory, type SttModelPricing, type SttPriceHistoryPoint, type SttProviderSummary, type TtsCostEstimate, type TtsModelHistory, type TtsModelPricing, type TtsPriceHistoryPoint, type TtsProviderSummary, type VideoCostEstimate, type VideoInputType, type VideoModelHistory, type VideoModelPricing, type VideoPriceHistoryPoint, type VideoProviderSummary, calculateAvatarCost, calculateAvatarModelCost, calculateCost, calculateImageCost, calculateImageModelCost, calculateModelCost, calculateSttCost, calculateSttModelCost, calculateTtsCost, calculateTtsModelCost, calculateVideoCost, calculateVideoModelCost };
+declare const STATIC_MUSIC_PRICING: MusicModelPricing[];
+
+export { type AvatarCostEstimate, type AvatarModelHistory, type AvatarModelPricing, type AvatarPriceHistoryPoint, type AvatarProviderSummary, type ClientOptions, type ConfidenceLevel, type CostEstimate, type DataConfidence, type FreshnessInfo, type ImageCostEstimate, type ImageModelHistory, type ImageModelPricing, type ImagePriceHistoryPoint, type ImageProviderSummary, type ImageQualityTier, type ModelHistory, type ModelPricing, type ModelStatus, type MusicCostEstimate, type MusicModelHistory, type MusicModelPricing, type MusicPriceHistoryPoint, type MusicProviderSummary, type PriceHistoryPoint, PriceTokenClient, type PriceTokenError, type PriceTokenResponse, type ProviderSummary, STATIC_AVATAR_PRICING, STATIC_IMAGE_PRICING, STATIC_MUSIC_PRICING, STATIC_PRICING, STATIC_STT_PRICING, STATIC_TTS_PRICING, STATIC_VIDEO_PRICING, type SttCostEstimate, type SttModelHistory, type SttModelPricing, type SttPriceHistoryPoint, type SttProviderSummary, type TtsCostEstimate, type TtsModelHistory, type TtsModelPricing, type TtsPriceHistoryPoint, type TtsProviderSummary, type VideoCostEstimate, type VideoInputType, type VideoModelHistory, type VideoModelPricing, type VideoPriceHistoryPoint, type VideoProviderSummary, calculateAvatarCost, calculateAvatarModelCost, calculateCost, calculateImageCost, calculateImageModelCost, calculateModelCost, calculateMusicCost, calculateMusicModelCost, calculateSttCost, calculateSttModelCost, calculateTtsCost, calculateTtsModelCost, calculateVideoCost, calculateVideoModelCost };

package/dist/index.d.ts

@@ -264,6 +264,47 @@ interface SttProviderSummary {
     modelCount: number;
     cheapestCostPerMinute: number;
 }
+interface MusicModelPricing {
+    modelId: string;
+    provider: string;
+    displayName: string;
+    costPerMinute: number;
+    maxDuration: number | null;
+    outputFormat: string | null;
+    vocals: boolean | null;
+    official: boolean;
+    pricingNote: string | null;
+    source: 'fetched' | 'seed' | 'admin' | 'verified' | 'carried';
+    status: ModelStatus | null;
+    confidence: DataConfidence;
+    confidenceScore: number;
+    confidenceLevel: ConfidenceLevel;
+    freshness: FreshnessInfo;
+    lastUpdated: string | null;
+    launchDate: string | null;
+}
+interface MusicCostEstimate {
+    modelId: string;
+    durationSeconds: number;
+    costPerMinute: number;
+    totalCost: number;
+}
+interface MusicPriceHistoryPoint {
+    date: string;
+    costPerMinute: number;
+}
+interface MusicModelHistory {
+    modelId: string;
+    provider: string;
+    displayName: string;
+    history: MusicPriceHistoryPoint[];
+}
+interface MusicProviderSummary {
+    id: string;
+    displayName: string;
+    modelCount: number;
+    cheapestCostPerMinute: number;
+}
 
 interface ClientOptions {
     baseUrl?: string;
@@ -422,6 +463,30 @@ declare class PriceTokenClient {
         after?: string;
         before?: string;
     }): Promise<SttModelPricing>;
+    getMusicPricing(opts?: {
+        provider?: string;
+        currency?: string;
+        after?: string;
+        before?: string;
+    }): Promise<MusicModelPricing[]>;
+    getMusicModel(modelId: string, opts?: {
+        currency?: string;
+    }): Promise<MusicModelPricing>;
+    getMusicHistory(opts?: {
+        days?: number;
+        modelId?: string;
+        provider?: string;
+    }): Promise<MusicModelHistory[]>;
+    getMusicProviders(): Promise<MusicProviderSummary[]>;
+    compareMusicModels(modelIds: string[], opts?: {
+        currency?: string;
+    }): Promise<MusicModelPricing[]>;
+    getCheapestMusicModel(opts?: {
+        provider?: string;
+        currency?: string;
+        after?: string;
+        before?: string;
+    }): Promise<MusicModelPricing>;
 }
 
 declare function calculateCost(modelId: string, inputPerMTok: number, outputPerMTok: number, inputTokens: number, outputTokens: number): CostEstimate;
@@ -442,6 +507,9 @@ declare function calculateTtsModelCost(modelId: string, characters: number, pric
 declare function calculateSttCost(modelId: string, costPerMinute: number, durationSeconds: number): SttCostEstimate;
 declare function calculateSttModelCost(modelId: string, durationSeconds: number, pricing?: SttModelPricing[]): SttCostEstimate;
 
+declare function calculateMusicCost(modelId: string, costPerMinute: number, durationSeconds: number): MusicCostEstimate;
+declare function calculateMusicModelCost(modelId: string, durationSeconds: number, pricing?: MusicModelPricing[]): MusicCostEstimate;
+
 declare const STATIC_PRICING: ModelPricing[];
 
 declare const STATIC_IMAGE_PRICING: ImageModelPricing[];
@@ -454,4 +522,6 @@ declare const STATIC_TTS_PRICING: TtsModelPricing[];
 
 declare const STATIC_STT_PRICING: SttModelPricing[];
 
-export { type AvatarCostEstimate, type AvatarModelHistory, type AvatarModelPricing, type AvatarPriceHistoryPoint, type AvatarProviderSummary, type ClientOptions, type ConfidenceLevel, type CostEstimate, type DataConfidence, type FreshnessInfo, type ImageCostEstimate, type ImageModelHistory, type ImageModelPricing, type ImagePriceHistoryPoint, type ImageProviderSummary, type ImageQualityTier, type ModelHistory, type ModelPricing, type ModelStatus, type PriceHistoryPoint, PriceTokenClient, type PriceTokenError, type PriceTokenResponse, type ProviderSummary, STATIC_AVATAR_PRICING, STATIC_IMAGE_PRICING, STATIC_PRICING, STATIC_STT_PRICING, STATIC_TTS_PRICING, STATIC_VIDEO_PRICING, type SttCostEstimate, type SttModelHistory, type SttModelPricing, type SttPriceHistoryPoint, type SttProviderSummary, type TtsCostEstimate, type TtsModelHistory, type TtsModelPricing, type TtsPriceHistoryPoint, type TtsProviderSummary, type VideoCostEstimate, type VideoInputType, type VideoModelHistory, type VideoModelPricing, type VideoPriceHistoryPoint, type VideoProviderSummary, calculateAvatarCost, calculateAvatarModelCost, calculateCost, calculateImageCost, calculateImageModelCost, calculateModelCost, calculateSttCost, calculateSttModelCost, calculateTtsCost, calculateTtsModelCost, calculateVideoCost, calculateVideoModelCost };
+declare const STATIC_MUSIC_PRICING: MusicModelPricing[];
+
+export { type AvatarCostEstimate, type AvatarModelHistory, type AvatarModelPricing, type AvatarPriceHistoryPoint, type AvatarProviderSummary, type ClientOptions, type ConfidenceLevel, type CostEstimate, type DataConfidence, type FreshnessInfo, type ImageCostEstimate, type ImageModelHistory, type ImageModelPricing, type ImagePriceHistoryPoint, type ImageProviderSummary, type ImageQualityTier, type ModelHistory, type ModelPricing, type ModelStatus, type MusicCostEstimate, type MusicModelHistory, type MusicModelPricing, type MusicPriceHistoryPoint, type MusicProviderSummary, type PriceHistoryPoint, PriceTokenClient, type PriceTokenError, type PriceTokenResponse, type ProviderSummary, STATIC_AVATAR_PRICING, STATIC_IMAGE_PRICING, STATIC_MUSIC_PRICING, STATIC_PRICING, STATIC_STT_PRICING, STATIC_TTS_PRICING, STATIC_VIDEO_PRICING, type SttCostEstimate, type SttModelHistory, type SttModelPricing, type SttPriceHistoryPoint, type SttProviderSummary, type TtsCostEstimate, type TtsModelHistory, type TtsModelPricing, type TtsPriceHistoryPoint, type TtsProviderSummary, type VideoCostEstimate, type VideoInputType, type VideoModelHistory, type VideoModelPricing, type VideoPriceHistoryPoint, type VideoProviderSummary, calculateAvatarCost, calculateAvatarModelCost, calculateCost, calculateImageCost, calculateImageModelCost, calculateModelCost, calculateMusicCost, calculateMusicModelCost, calculateSttCost, calculateSttModelCost, calculateTtsCost, calculateTtsModelCost, calculateVideoCost, calculateVideoModelCost };

package/dist/index.js

@@ -23,6 +23,7 @@ __export(index_exports, {
   PriceTokenClient: () => PriceTokenClient,
   STATIC_AVATAR_PRICING: () => STATIC_AVATAR_PRICING,
   STATIC_IMAGE_PRICING: () => STATIC_IMAGE_PRICING,
+  STATIC_MUSIC_PRICING: () => STATIC_MUSIC_PRICING,
   STATIC_PRICING: () => STATIC_PRICING,
   STATIC_STT_PRICING: () => STATIC_STT_PRICING,
   STATIC_TTS_PRICING: () => STATIC_TTS_PRICING,
@@ -33,6 +34,8 @@ __export(index_exports, {
   calculateImageCost: () => calculateImageCost,
   calculateImageModelCost: () => calculateImageModelCost,
   calculateModelCost: () => calculateModelCost,
+  calculateMusicCost: () => calculateMusicCost,
+  calculateMusicModelCost: () => calculateMusicModelCost,
   calculateSttCost: () => calculateSttCost,
   calculateSttModelCost: () => calculateSttModelCost,
   calculateTtsCost: () => calculateTtsCost,
@@ -328,6 +331,47 @@ var PriceTokenClient = class {
     const qs = params.toString();
     return this.request(`/api/v1/stt/cheapest${qs ? `?${qs}` : ""}`);
   }
+  // Music pricing methods
+  async getMusicPricing(opts) {
+    const params = new URLSearchParams();
+    if (opts?.provider) params.set("provider", opts.provider);
+    if (opts?.currency) params.set("currency", opts.currency);
+    if (opts?.after) params.set("after", opts.after);
+    if (opts?.before) params.set("before", opts.before);
+    const qs = params.toString();
+    return this.request(`/api/v1/music${qs ? `?${qs}` : ""}`);
+  }
+  async getMusicModel(modelId, opts) {
+    const params = new URLSearchParams();
+    if (opts?.currency) params.set("currency", opts.currency);
+    const qs = params.toString();
+    return this.request(`/api/v1/music/${encodeURIComponent(modelId)}${qs ? `?${qs}` : ""}`);
+  }
+  async getMusicHistory(opts) {
+    const params = new URLSearchParams();
+    if (opts?.days) params.set("days", String(opts.days));
+    if (opts?.modelId) params.set("modelId", opts.modelId);
+    if (opts?.provider) params.set("provider", opts.provider);
+    const qs = params.toString();
+    return this.request(`/api/v1/music/history${qs ? `?${qs}` : ""}`);
+  }
+  async getMusicProviders() {
+    return this.request("/api/v1/music/providers");
+  }
+  async compareMusicModels(modelIds, opts) {
+    const params = new URLSearchParams({ models: modelIds.join(",") });
+    if (opts?.currency) params.set("currency", opts.currency);
+    return this.request(`/api/v1/music/compare?${params}`);
+  }
+  async getCheapestMusicModel(opts) {
+    const params = new URLSearchParams();
+    if (opts?.provider) params.set("provider", opts.provider);
+    if (opts?.currency) params.set("currency", opts.currency);
+    if (opts?.after) params.set("after", opts.after);
+    if (opts?.before) params.set("before", opts.before);
+    const qs = params.toString();
+    return this.request(`/api/v1/music/cheapest${qs ? `?${qs}` : ""}`);
+  }
 };
 
 // src/static.ts
@@ -5397,11 +5441,168 @@ function calculateSttModelCost(modelId, durationSeconds, pricing) {
   }
   return calculateSttCost(modelId, model.costPerMinute, durationSeconds);
 }
+
+// src/music-static.ts
+var STATIC_MUSIC_PRICING = [
+  {
+    modelId: "elevenlabs-eleven-music",
+    provider: "elevenlabs",
+    displayName: "ElevenLabs Eleven Music",
+    costPerMinute: 0.5,
+    maxDuration: null,
+    outputFormat: "mp3",
+    vocals: true,
+    official: true,
+    pricingNote: null,
+    source: "seed",
+    status: "active",
+    confidence: "high",
+    confidenceScore: 99,
+    confidenceLevel: "high",
+    freshness: { lastVerified: "", ageHours: 0, stale: false },
+    lastUpdated: null,
+    launchDate: "2025-06-01"
+  },
+  {
+    modelId: "soundverse-music",
+    provider: "soundverse",
+    displayName: "Soundverse Music Generation",
+    costPerMinute: 0.0125,
+    maxDuration: 240,
+    outputFormat: "mp3",
+    vocals: true,
+    official: true,
+    pricingNote: "Approximated from ~$0.05/song at ~4 min avg",
+    source: "seed",
+    status: "active",
+    confidence: "high",
+    confidenceScore: 99,
+    confidenceLevel: "high",
+    freshness: { lastVerified: "", ageHours: 0, stale: false },
+    lastUpdated: null,
+    launchDate: "2025-01-01"
+  },
+  {
+    modelId: "sunoapi-suno-v4",
+    provider: "sunoapi",
+    displayName: "Suno v4 via SunoAPI.org",
+    costPerMinute: 75e-4,
+    maxDuration: 240,
+    outputFormat: "mp3",
+    vocals: true,
+    official: false,
+    pricingNote: "Unofficial. 12 cr/call, 2 songs/call = $0.03/song at 4 min max",
+    source: "seed",
+    status: "active",
+    confidence: "high",
+    confidenceScore: 99,
+    confidenceLevel: "high",
+    freshness: { lastVerified: "", ageHours: 0, stale: false },
+    lastUpdated: null,
+    launchDate: "2024-05-01"
+  },
+  {
+    modelId: "sunoapi-suno-v4.5",
+    provider: "sunoapi",
+    displayName: "Suno v4.5 via SunoAPI.org",
+    costPerMinute: 375e-5,
+    maxDuration: 480,
+    outputFormat: "mp3",
+    vocals: true,
+    official: false,
+    pricingNote: "Unofficial. 12 cr/call, 2 songs/call = $0.03/song at 8 min max",
+    source: "seed",
+    status: "active",
+    confidence: "high",
+    confidenceScore: 99,
+    confidenceLevel: "high",
+    freshness: { lastVerified: "", ageHours: 0, stale: false },
+    lastUpdated: null,
+    launchDate: "2025-09-01"
+  },
+  {
+    modelId: "sunoapi-suno-v4.5-all",
+    provider: "sunoapi",
+    displayName: "Suno v4.5 All via SunoAPI.org",
+    costPerMinute: 375e-5,
+    maxDuration: 480,
+    outputFormat: "mp3",
+    vocals: true,
+    official: false,
+    pricingNote: "Unofficial. 12 cr/call, 2 songs/call = $0.03/song at 8 min max",
+    source: "seed",
+    status: "active",
+    confidence: "high",
+    confidenceScore: 99,
+    confidenceLevel: "high",
+    freshness: { lastVerified: "", ageHours: 0, stale: false },
+    lastUpdated: null,
+    launchDate: "2025-09-01"
+  },
+  {
+    modelId: "sunoapi-suno-v4.5-plus",
+    provider: "sunoapi",
+    displayName: "Suno v4.5 Plus via SunoAPI.org",
+    costPerMinute: 375e-5,
+    maxDuration: 480,
+    outputFormat: "mp3",
+    vocals: true,
+    official: false,
+    pricingNote: "Unofficial. 12 cr/call, 2 songs/call = $0.03/song at 8 min max",
+    source: "seed",
+    status: "active",
+    confidence: "high",
+    confidenceScore: 99,
+    confidenceLevel: "high",
+    freshness: { lastVerified: "", ageHours: 0, stale: false },
+    lastUpdated: null,
+    launchDate: "2025-09-01"
+  },
+  {
+    modelId: "sunoapi-suno-v5",
+    provider: "sunoapi",
+    displayName: "Suno v5 via SunoAPI.org",
+    costPerMinute: 375e-5,
+    maxDuration: 480,
+    outputFormat: "mp3",
+    vocals: true,
+    official: false,
+    pricingNote: "Unofficial. 12 cr/call, 2 songs/call = $0.03/song at 8 min max",
+    source: "seed",
+    status: "active",
+    confidence: "high",
+    confidenceScore: 99,
+    confidenceLevel: "high",
+    freshness: { lastVerified: "", ageHours: 0, stale: false },
+    lastUpdated: null,
+    launchDate: "2026-01-01"
+  }
+];
+
+// src/music-cost.ts
+function calculateMusicCost(modelId, costPerMinute, durationSeconds) {
+  const totalCost = durationSeconds / 60 * costPerMinute;
+  return {
+    modelId,
+    durationSeconds,
+    costPerMinute,
+    totalCost
+  };
+}
+function calculateMusicModelCost(modelId, durationSeconds, pricing) {
+  const data = pricing ?? STATIC_MUSIC_PRICING;
+  const model = data.find((m) => m.modelId === modelId);
+  if (!model) {
+    throw new Error(`Unknown music model: ${modelId}. Provide pricing data or use calculateMusicCost().`);
+  }
+  return calculateMusicCost(modelId, model.costPerMinute, durationSeconds);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   PriceTokenClient,
   STATIC_AVATAR_PRICING,
   STATIC_IMAGE_PRICING,
+  STATIC_MUSIC_PRICING,
   STATIC_PRICING,
   STATIC_STT_PRICING,
   STATIC_TTS_PRICING,
@@ -5412,6 +5613,8 @@ function calculateSttModelCost(modelId, durationSeconds, pricing) {
   calculateImageCost,
   calculateImageModelCost,
   calculateModelCost,
+  calculateMusicCost,
+  calculateMusicModelCost,
   calculateSttCost,
   calculateSttModelCost,
   calculateTtsCost,

package/dist/index.mjs

@@ -284,6 +284,47 @@ var PriceTokenClient = class {
     const qs = params.toString();
     return this.request(`/api/v1/stt/cheapest${qs ? `?${qs}` : ""}`);
   }
+  // Music pricing methods
+  async getMusicPricing(opts) {
+    const params = new URLSearchParams();
+    if (opts?.provider) params.set("provider", opts.provider);
+    if (opts?.currency) params.set("currency", opts.currency);
+    if (opts?.after) params.set("after", opts.after);
+    if (opts?.before) params.set("before", opts.before);
+    const qs = params.toString();
+    return this.request(`/api/v1/music${qs ? `?${qs}` : ""}`);
+  }
+  async getMusicModel(modelId, opts) {
+    const params = new URLSearchParams();
+    if (opts?.currency) params.set("currency", opts.currency);
+    const qs = params.toString();
+    return this.request(`/api/v1/music/${encodeURIComponent(modelId)}${qs ? `?${qs}` : ""}`);
+  }
+  async getMusicHistory(opts) {
+    const params = new URLSearchParams();
+    if (opts?.days) params.set("days", String(opts.days));
+    if (opts?.modelId) params.set("modelId", opts.modelId);
+    if (opts?.provider) params.set("provider", opts.provider);
+    const qs = params.toString();
+    return this.request(`/api/v1/music/history${qs ? `?${qs}` : ""}`);
+  }
+  async getMusicProviders() {
+    return this.request("/api/v1/music/providers");
+  }
+  async compareMusicModels(modelIds, opts) {
+    const params = new URLSearchParams({ models: modelIds.join(",") });
+    if (opts?.currency) params.set("currency", opts.currency);
+    return this.request(`/api/v1/music/compare?${params}`);
+  }
+  async getCheapestMusicModel(opts) {
+    const params = new URLSearchParams();
+    if (opts?.provider) params.set("provider", opts.provider);
+    if (opts?.currency) params.set("currency", opts.currency);
+    if (opts?.after) params.set("after", opts.after);
+    if (opts?.before) params.set("before", opts.before);
+    const qs = params.toString();
+    return this.request(`/api/v1/music/cheapest${qs ? `?${qs}` : ""}`);
+  }
 };
 
 // src/static.ts
@@ -5353,10 +5394,167 @@ function calculateSttModelCost(modelId, durationSeconds, pricing) {
   }
   return calculateSttCost(modelId, model.costPerMinute, durationSeconds);
 }
+
+// src/music-static.ts
+var STATIC_MUSIC_PRICING = [
+  {
+    modelId: "elevenlabs-eleven-music",
+    provider: "elevenlabs",
+    displayName: "ElevenLabs Eleven Music",
+    costPerMinute: 0.5,
+    maxDuration: null,
+    outputFormat: "mp3",
+    vocals: true,
+    official: true,
+    pricingNote: null,
+    source: "seed",
+    status: "active",
+    confidence: "high",
+    confidenceScore: 99,
+    confidenceLevel: "high",
+    freshness: { lastVerified: "", ageHours: 0, stale: false },
+    lastUpdated: null,
+    launchDate: "2025-06-01"
+  },
+  {
+    modelId: "soundverse-music",
+    provider: "soundverse",
+    displayName: "Soundverse Music Generation",
+    costPerMinute: 0.0125,
+    maxDuration: 240,
+    outputFormat: "mp3",
+    vocals: true,
+    official: true,
+    pricingNote: "Approximated from ~$0.05/song at ~4 min avg",
+    source: "seed",
+    status: "active",
+    confidence: "high",
+    confidenceScore: 99,
+    confidenceLevel: "high",
+    freshness: { lastVerified: "", ageHours: 0, stale: false },
+    lastUpdated: null,
+    launchDate: "2025-01-01"
+  },
+  {
+    modelId: "sunoapi-suno-v4",
+    provider: "sunoapi",
+    displayName: "Suno v4 via SunoAPI.org",
+    costPerMinute: 75e-4,
+    maxDuration: 240,
+    outputFormat: "mp3",
+    vocals: true,
+    official: false,
+    pricingNote: "Unofficial. 12 cr/call, 2 songs/call = $0.03/song at 4 min max",
+    source: "seed",
+    status: "active",
+    confidence: "high",
+    confidenceScore: 99,
+    confidenceLevel: "high",
+    freshness: { lastVerified: "", ageHours: 0, stale: false },
+    lastUpdated: null,
+    launchDate: "2024-05-01"
+  },
+  {
+    modelId: "sunoapi-suno-v4.5",
+    provider: "sunoapi",
+    displayName: "Suno v4.5 via SunoAPI.org",
+    costPerMinute: 375e-5,
+    maxDuration: 480,
+    outputFormat: "mp3",
+    vocals: true,
+    official: false,
+    pricingNote: "Unofficial. 12 cr/call, 2 songs/call = $0.03/song at 8 min max",
+    source: "seed",
+    status: "active",
+    confidence: "high",
+    confidenceScore: 99,
+    confidenceLevel: "high",
+    freshness: { lastVerified: "", ageHours: 0, stale: false },
+    lastUpdated: null,
+    launchDate: "2025-09-01"
+  },
+  {
+    modelId: "sunoapi-suno-v4.5-all",
+    provider: "sunoapi",
+    displayName: "Suno v4.5 All via SunoAPI.org",
+    costPerMinute: 375e-5,
+    maxDuration: 480,
+    outputFormat: "mp3",
+    vocals: true,
+    official: false,
+    pricingNote: "Unofficial. 12 cr/call, 2 songs/call = $0.03/song at 8 min max",
+    source: "seed",
+    status: "active",
+    confidence: "high",
+    confidenceScore: 99,
+    confidenceLevel: "high",
+    freshness: { lastVerified: "", ageHours: 0, stale: false },
+    lastUpdated: null,
+    launchDate: "2025-09-01"
+  },
+  {
+    modelId: "sunoapi-suno-v4.5-plus",
+    provider: "sunoapi",
+    displayName: "Suno v4.5 Plus via SunoAPI.org",
+    costPerMinute: 375e-5,
+    maxDuration: 480,
+    outputFormat: "mp3",
+    vocals: true,
+    official: false,
+    pricingNote: "Unofficial. 12 cr/call, 2 songs/call = $0.03/song at 8 min max",
+    source: "seed",
+    status: "active",
+    confidence: "high",
+    confidenceScore: 99,
+    confidenceLevel: "high",
+    freshness: { lastVerified: "", ageHours: 0, stale: false },
+    lastUpdated: null,
+    launchDate: "2025-09-01"
+  },
+  {
+    modelId: "sunoapi-suno-v5",
+    provider: "sunoapi",
+    displayName: "Suno v5 via SunoAPI.org",
+    costPerMinute: 375e-5,
+    maxDuration: 480,
+    outputFormat: "mp3",
+    vocals: true,
+    official: false,
+    pricingNote: "Unofficial. 12 cr/call, 2 songs/call = $0.03/song at 8 min max",
+    source: "seed",
+    status: "active",
+    confidence: "high",
+    confidenceScore: 99,
+    confidenceLevel: "high",
+    freshness: { lastVerified: "", ageHours: 0, stale: false },
+    lastUpdated: null,
+    launchDate: "2026-01-01"
+  }
+];
+
+// src/music-cost.ts
+function calculateMusicCost(modelId, costPerMinute, durationSeconds) {
+  const totalCost = durationSeconds / 60 * costPerMinute;
+  return {
+    modelId,
+    durationSeconds,
+    costPerMinute,
+    totalCost
+  };
+}
+function calculateMusicModelCost(modelId, durationSeconds, pricing) {
+  const data = pricing ?? STATIC_MUSIC_PRICING;
+  const model = data.find((m) => m.modelId === modelId);
+  if (!model) {
+    throw new Error(`Unknown music model: ${modelId}. Provide pricing data or use calculateMusicCost().`);
+  }
+  return calculateMusicCost(modelId, model.costPerMinute, durationSeconds);
+}
 export {
   PriceTokenClient,
   STATIC_AVATAR_PRICING,
   STATIC_IMAGE_PRICING,
+  STATIC_MUSIC_PRICING,
   STATIC_PRICING,
   STATIC_STT_PRICING,
   STATIC_TTS_PRICING,
@@ -5367,6 +5565,8 @@ export {
   calculateImageCost,
   calculateImageModelCost,
   calculateModelCost,
+  calculateMusicCost,
+  calculateMusicModelCost,
   calculateSttCost,
   calculateSttModelCost,
   calculateTtsCost,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pricetoken",
-  "version": "0.12.0",
+  "version": "0.13.1",
   "description": "Real-time LLM pricing data — typed client, cost calculator, and static pricing",
   "keywords": [
     "llm",