@sogni-ai/sogni-client 5.75.2 → 5.77.0

package/src/Projects/index.ts

@@ -92,7 +92,12 @@ import {
 import { getFileContentType } from './utils/fileContentType.js';
 import { TokenType } from '../types/token.js';
 import type { JobProvenance } from './types/JobProvenance.js';
-import { getMaxContextImages, validateSampler, isGptImageModel, resolveGptImageGifSize } from '../lib/validation.js';
+import {
+  getMaxContextImages,
+  validateSampler,
+  isGptImageModel,
+  resolveGptImageGifSize
+} from '../lib/validation.js';
 import ModelTiersRaw, {
   isAudioTier,
   isComfyImageTier,
@@ -1083,6 +1088,7 @@ class ProjectsApi extends ApiGroup<ProjectApiEvents> {
       lastFrameUrl: data.lastFrameUrl,
       outputFormat: data.outputFormat,
       ...seedanceDraftFields,
+      ...(data.lastFrameKey ? { lastFrameKey: data.lastFrameKey } : {}),
       isNSFW: Boolean(data.triggeredNSFWFilter),
       nsfwDetected: data.nsfwDetected === true,
       nsfwSources: Array.isArray(data.nsfwSources) ? [...data.nsfwSources] : [],
@@ -3348,7 +3354,8 @@ class ProjectsApi extends ApiGroup<ProjectApiEvents> {
     gptImageComplexity,
     outputFormat,
     billingMode,
-    priorityMode
+    priorityMode,
+    includeMonthlyFairUse
   }: EstimateRequest): Promise<CostEstimation> {
     let apiVersion = 2;
     const modelOptions = await this.getModelOptions(model);
@@ -3388,12 +3395,15 @@ class ProjectsApi extends ApiGroup<ProjectApiEvents> {
     }
     const queryParams = new URLSearchParams();
     if (gptImageQuality) queryParams.set('gptImageQuality', gptImageQuality);
-    if (gptImageFrameCount !== undefined) queryParams.set('gptImageFrameCount', String(gptImageFrameCount));
-    if (gptImageFrameDurationMs !== undefined) queryParams.set('gptImageFrameDurationMs', String(gptImageFrameDurationMs));
+    if (gptImageFrameCount !== undefined)
+      queryParams.set('gptImageFrameCount', String(gptImageFrameCount));
+    if (gptImageFrameDurationMs !== undefined)
+      queryParams.set('gptImageFrameDurationMs', String(gptImageFrameDurationMs));
     if (gptImageComplexity !== undefined) queryParams.set('gptImageComplexity', gptImageComplexity);
     if (outputFormat) queryParams.set('outputFormat', outputFormat);
     if (billingMode) queryParams.set('billingMode', billingMode);
     if (priorityMode !== undefined) queryParams.set('priorityMode', String(priorityMode));
+    if (includeMonthlyFairUse === true) queryParams.set('includeMonthlyFairUse', 'true');
     const query = queryParams.toString();
     const r = await this.client.socket.get<EstimationResponse>(
       `/api/v${apiVersion}/job/estimate/${pathParams.join('/')}${query ? `?${query}` : ''}`
@@ -3405,7 +3415,8 @@ class ProjectsApi extends ApiGroup<ProjectApiEvents> {
       sogni: r.quote.project.costInSogni,
       estimatedRenderSeconds: r.benchmark?.estimatedRenderTimeSec,
       estimatedTotalSeconds: r.benchmark?.estimatedTotalTimeSec,
-      dailyFairUsePct: r.dailyFairUse?.pct
+      dailyFairUsePct: r.dailyFairUse?.pct,
+      ...(r.monthlyFairUse ? { monthlyFairUsePct: r.monthlyFairUse.pct } : {})
     };
   }
 
@@ -3527,6 +3538,7 @@ class ProjectsApi extends ApiGroup<ProjectApiEvents> {
     if (network) query.set('network', network);
     if (params.billingMode) query.set('billingMode', params.billingMode);
     if (params.priorityMode !== undefined) query.set('priorityMode', String(params.priorityMode));
+    if (params.includeMonthlyFairUse === true) query.set('includeMonthlyFairUse', 'true');
     if (params.seedanceDraft === true) query.set('seedanceDraft', '1');
     if (params.seedanceDraftJobId !== undefined) {
       query.set('seedanceDraftJobId', params.seedanceDraftJobId);
@@ -3542,7 +3554,8 @@ class ProjectsApi extends ApiGroup<ProjectApiEvents> {
       sogni: r.quote.project.costInSogni,
       estimatedRenderSeconds: r.benchmark?.estimatedRenderTimeSec,
       estimatedTotalSeconds: r.benchmark?.estimatedTotalTimeSec,
-      dailyFairUsePct: r.dailyFairUse?.pct
+      dailyFairUsePct: r.dailyFairUse?.pct,
+      ...(r.monthlyFairUse ? { monthlyFairUsePct: r.monthlyFairUse.pct } : {})
     };
   }
 
@@ -3572,6 +3585,7 @@ class ProjectsApi extends ApiGroup<ProjectApiEvents> {
     if (network) query.set('network', network);
     if (params.billingMode) query.set('billingMode', params.billingMode);
     if (params.priorityMode !== undefined) query.set('priorityMode', String(params.priorityMode));
+    if (params.includeMonthlyFairUse === true) query.set('includeMonthlyFairUse', 'true');
     const queryString = query.toString();
     const r = await this.client.socket.get<EstimationResponse>(
       `/api/v1/job-audio/estimate/${path}${queryString ? `?${queryString}` : ''}`
@@ -3583,7 +3597,8 @@ class ProjectsApi extends ApiGroup<ProjectApiEvents> {
       sogni: r.quote.project.costInSogni,
       estimatedRenderSeconds: r.benchmark?.estimatedRenderTimeSec,
       estimatedTotalSeconds: r.benchmark?.estimatedTotalTimeSec,
-      dailyFairUsePct: r.dailyFairUse?.pct
+      dailyFairUsePct: r.dailyFairUse?.pct,
+      ...(r.monthlyFairUse ? { monthlyFairUsePct: r.monthlyFairUse.pct } : {})
     };
   }
 

package/src/Projects/types/EstimationResponse.ts

@@ -9,6 +9,8 @@ export interface EstimationResponse {
    * only to a signed-in subscriber whose plan covers the project on Fast.
    */
   dailyFairUse?: { pct: number };
+  /** Optional monthly capacity share requested by the caller. */
+  monthlyFairUse?: { pct: number };
 }
 
 export interface Benchmark {

package/src/Projects/types/events.ts

@@ -107,6 +107,7 @@ export interface JobCompleted extends JobEventBase {
    */
   resultUrl: string | null;
   lastFrameUrl?: string;
+  lastFrameKey?: string;
   outputFormat?: string;
   /** Seedance 2.5: this job is a draft that can be finalized at 1080p. */
   seedanceDraft?: boolean;

package/src/Projects/types/index.ts

@@ -829,7 +829,7 @@ export interface VideoProjectParams extends BaseProjectParams {
    * Output video format. Defaults to 'mp4'; 'mov' is supported by Seedance 2.5.
    */
   outputFormat?: VideoOutputFormat;
-  /** Seedance 2.5: export a separate final-frame image, available as job.lastFrameUrl. */
+  /** Seedance 2.5 / MiniMax H3: export a final-frame image; refresh with job.getLastFrameUrl(). */
   returnLastFrame?: boolean;
   /**
    * SAM2 click coordinates for subject detection in animate-replace workflows.
@@ -1270,6 +1270,8 @@ export type MediaUrlParams = {
 };
 
 export interface EstimateRequest {
+  /** Request the optional monthly capacity share alongside the daily estimate. */
+  includeMonthlyFairUse?: boolean;
   /** Include Priority mode's 1.5× usage in the daily-capacity estimate. */
   priorityMode?: boolean;
   /**
@@ -1354,6 +1356,8 @@ export interface EstimateRequest {
 }
 
 export interface VideoEstimateRequest {
+  /** Request the optional monthly capacity share alongside the daily estimate. */
+  includeMonthlyFairUse?: boolean;
   /** Include Priority mode's 1.5× usage in the daily-capacity estimate. */
   priorityMode?: boolean;
   /** FlashVSR source geometry for an estimate. The server verifies the uploaded file at admission. */
@@ -1430,6 +1434,8 @@ export interface VideoEstimateRequest {
 }
 
 export interface AudioEstimateRequest {
+  /** Request the optional monthly capacity share alongside the daily estimate. */
+  includeMonthlyFairUse?: boolean;
   /** Include Priority mode's 1.5× usage in the daily-capacity estimate. */
   priorityMode?: boolean;
   tokenType: TokenType;
@@ -1484,6 +1490,8 @@ export interface CostEstimation {
    * for guests, premium-vendor models, token billing, trials and Relaxed.
    */
   dailyFairUsePct?: number;
+  /** Estimated share of monthly Fast capacity, when requested and supplied by the server. */
+  monthlyFairUsePct?: number;
 }
 
 export type EnhancementStrength = 'light' | 'medium' | 'heavy';

package/src/version.ts

@@ -1,3 +1,3 @@
 // AUTO-GENERATED by scripts/generate-version.mjs — do not edit.
 // Source of truth: package.json version.
-export const LIB_VERSION = '5.75.2';
+export const LIB_VERSION = '5.77.0';