@sogni-ai/sogni-client 5.72.1 → 5.74.0

package/llms-full.txt

@@ -963,6 +963,49 @@ const project = await sogni.projects.create({
 });
 ```
 
+SEEDANCE 2.5 DRAFT -> 1080P FINAL:
+
+Draft mode is chosen at submission; a normal job cannot be finalized. A draft
+(`seedanceDraft: true`) takes every normal Seedance 2.5 input at a 480p size and
+costs the same as that 480p job. The completed job reports `job.seedanceDraft`
+and `job.seedanceDraftExpiresAt` (ISO 8601). Finalize it with
+`seedanceDraftJobId: draftJob.id` on the same model and account before it
+expires: the final reuses the draft's prompt, media, duration, aspect ratio,
+seed and audio setting, so send none of them (no references, frames, audio,
+`duration`, `frames`, `ratio`, `seed`, `generateAudio` or `seedanceTaskType`),
+use `numberOfMedia: 1` and an empty `positivePrompt`. `outputFormat` and
+`returnLastFrame` may be set. The output is the draft's aspect ratio at 1080p,
+priced at 1080p for the draft's duration (video-input rate when the draft had
+one); each finalize bills again. The final reports `job.seedanceDraftJobId`.
+`estimateVideoCost` accepts both fields; for a finalize the server prices from
+the draft, so width, height, duration and fps do not change the quote.
+
+```javascript
+const draft = await sogni.projects.create({
+  type: 'video',
+  network: 'fast',
+  modelId: 'seedance-2-5',
+  positivePrompt: 'A lighthouse keeper climbs a spiral stair as a storm rolls in',
+  numberOfMedia: 1,
+  duration: 8,
+  width: 864,
+  height: 496,
+  seedanceDraft: true
+});
+await draft.waitForCompletion();
+const [draftJob] = draft.jobs; // draftJob.seedanceDraft === true
+
+const final = await sogni.projects.create({
+  type: 'video',
+  network: 'fast',
+  modelId: 'seedance-2-5',
+  positivePrompt: '',
+  numberOfMedia: 1,
+  seedanceDraftJobId: draftJob.id
+});
+await final.waitForCompletion(); // final.jobs[0].seedanceDraftJobId === draftJob.id
+```
+
 SEEDANCE IMAGE-TO-VIDEO:
 
 ```javascript
@@ -2274,6 +2317,8 @@ VIDEO-SPECIFIC PARAMETERS:
   referenceVideoUrls?: string[];  // Seedance only
   referenceAudioUrls?: string[];  // Seedance only
   seedanceTaskType?: 'reference' | 'edit' | 'extend';  // Seedance 2.5 loose-reference operation
+  seedanceDraft?: boolean;   // Seedance 2.5: 480p draft that can be finalized at 1080p
+  seedanceDraftJobId?: string;  // Seedance 2.5: finalize that draft (its job id) at 1080p; inherits its inputs
   audioStart?: number;       // Seconds into audio
   audioDuration?: number;    // Seconds of audio
   videoStart?: number;       // Seconds into video
@@ -2828,3 +2873,6 @@ For additional resources:
 - Examples: https://github.com/Sogni-AI/sogni-client/tree/main/examples
 - API Docs: https://sdk-docs.sogni.ai
 - Support: https://www.sogni.ai/support
+
+OPTIONAL PRIORITY MODE
+Paid Unlimited members may set priorityMode: true on projects.create() with network: fast, tokenType: spark and billingMode: subscription. Earlier Fast queue placement costs 1.5x daily and monthly usage credits, behind Premium Spark. Plan caps and concurrency are unchanged; rendering speed, quality and GPU assignment are not guaranteed to change. Omit the option for standard behavior. Trials, Relaxed, token-paid generations and third-party vendor models cannot use it. Image, video and audio estimate helpers also accept priorityMode and include the weighted daily share in dailyFairUsePct. This setting applies to media generations, not chat or prompt-writing calls.

package/llms.txt

@@ -482,6 +482,8 @@ Use `referenceImageUrls`, `referenceVideoUrls`, and `referenceAudioUrls` for See
 
 For Seedance 2.5 loose-reference video operations, set `seedanceTaskType` to `reference`, `edit`, or `extend`. Edit/extend require a reference video. The server applies adaptive source aspect ratio to first/last-frame, edit, and extend requests and provider-selected duration to edit requests. Loose-reference requests require an explicit task type.
 
+Seedance 2.5 draft mode: send `seedanceDraft: true` with a 480p size for a draft priced like the same 480p job (choose it at submission; a normal job cannot be finalized). The completed job reports `job.seedanceDraft` and `job.seedanceDraftExpiresAt` (ISO 8601). Finalize it at 1080p with `seedanceDraftJobId: draftJob.id` on the same model, `numberOfMedia: 1` and an empty `positivePrompt`: the final reuses the draft's prompt, media, duration, aspect ratio, seed and audio setting, so omit references, frames, audio, `duration`, `frames`, `ratio`, `seed`, `generateAudio` and `seedanceTaskType`. The final reports `job.seedanceDraftJobId`. `estimateVideoCost` accepts both fields; the server prices a finalize from the draft. The two fields are mutually exclusive.
+
 Aliases used by chat tools and examples: `seedance2`, `seedance2-mini`, `seedance2-5`, `seedance2-5-uncensored`, and `seedance2-mini-uncensored`. V2V uses `seedance2` or `seedance2-mini` as the model selector and `seedance-v2v` as the control mode. Seedance Mini is the preferred lower-cost 720p tier. See `examples/workflow_partner_seedance_video.mjs` for focused endpoint coverage across Seedance T2V/I2V/IA2V/V2V and multimodal context prompt expansion.
 
 ### Happy Horse 1.1 (external API)

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "5.72.1",
+  "version": "5.74.0",
   "engines": {
     "node": ">=22"
   },
@@ -70,6 +70,7 @@
     "test:model-options": "npm run build && node scripts/check-video-model-options.cjs",
     "test:video-estimates": "npm run build && node scripts/check-video-estimates.cjs",
     "test:seedance-task-type": "npm run build && node scripts/check-seedance-task-type.cjs && node scripts/check-seedance-r2v-example.cjs",
+    "test:seedance-draft": "npm run build && node scripts/check-seedance-draft.cjs",
     "test:model-consent-error": "npm run build && node scripts/check-model-consent-error.cjs",
     "test:wan3-video": "npm run build && node scripts/check-wan3-video.cjs",
     "test:sam3-image-segment": "npm run build && node scripts/check-sam3-image-segment.cjs",
@@ -81,6 +82,7 @@
     "test:capability-exports": "npm run build && node scripts/check-capability-exports.cjs",
     "test:generation-receipt-transport": "npm run build && node scripts/check-generation-receipt-transport.cjs",
     "test:prompt-expansion": "npm run build && node scripts/check-prompt-expansion-transport.cjs",
+    "test:priority-mode": "npm run build && node scripts/check-priority-mode.cjs && node scripts/check-priority-capability.cjs",
     "test:reference-content-types": "npm run build && node scripts/check-reference-content-types.cjs",
     "test:minimax-h3-audio-policy": "node scripts/check-minimax-h3-source-audio-policy.cjs",
     "test:minimax-h3-balanced": "npm run build && node scripts/check-minimax-h3-balanced.cjs",

package/src/Account/index.ts

@@ -102,6 +102,11 @@ class AccountApi extends ApiGroup {
    */
   private appliedSubscriptionSocketWrites = 0;
   private accountSessionVersion?: number;
+  /** Priority availability belongs to the current authenticated connection. */
+  private socketPriorityAvailability: {
+    sessionVersion: number;
+    available: boolean;
+  } | null = null;
 
   constructor(config: ApiConfig) {
     super(config);
@@ -133,6 +138,7 @@ class AccountApi extends ApiGroup {
   }
 
   private handleServerConnected({ network }: { network: SupernetType }) {
+    this.clearSocketPriorityAvailability();
     this.currentAccount._update({
       networkStatus: 'connected',
       network
@@ -140,6 +146,7 @@ class AccountApi extends ApiGroup {
   }
 
   private handleServerConnecting({ network }: { network: SupernetType }) {
+    this.clearSocketPriorityAvailability();
     this.currentAccount._update({
       networkStatus: 'connecting',
       network
@@ -147,12 +154,41 @@ class AccountApi extends ApiGroup {
   }
 
   private handleServerDisconnected() {
+    this.clearSocketPriorityAvailability();
     this.currentAccount._update({
       networkStatus: 'disconnected',
       network: null
     });
   }
 
+  private clearSocketPriorityAvailability() {
+    this.socketPriorityAvailability = null;
+    const subscription = this.currentAccount.subscription;
+    if (!subscription?.capabilities?.priorityMode) return;
+    const capabilities = { ...subscription.capabilities };
+    delete capabilities.priorityMode;
+    this.currentAccount._update({ subscription: { ...subscription, capabilities } });
+  }
+
+  /** Plan refreshes retain the current connection's coarse Priority availability. */
+  private withSocketPriorityAvailability(
+    subscription: SubscriptionEntitlementSnapshot
+  ): SubscriptionEntitlementSnapshot {
+    const available = Boolean(
+      this.socketPriorityAvailability?.available &&
+      this.socketPriorityAvailability.sessionVersion === this.client.auth.sessionVersion &&
+      this.client.socket.isConnected &&
+      subscription.active &&
+      subscription.status !== 'trialing' &&
+      (subscription.tier === 'unlimited' || subscription.tier === 'unlimited_pro')
+    );
+    if (available === (subscription.capabilities?.priorityMode === true)) return subscription;
+    const capabilities = { ...subscription.capabilities };
+    if (available) capabilities.priorityMode = true;
+    else delete capabilities.priorityMode;
+    return { ...subscription, capabilities };
+  }
+
   private mapSocketSubscriptionEntitlement(
     data: SocketSubscriptionEntitlementData | undefined
   ): SubscriptionEntitlementSnapshot | undefined {
@@ -289,12 +325,17 @@ class AccountApi extends ApiGroup {
     }
     if (source === 'socket') {
       this.appliedSubscriptionSocketWrites += 1;
+      this.socketPriorityAvailability = {
+        sessionVersion: this.client.auth.sessionVersion,
+        available: subscription.capabilities?.priorityMode === true
+      };
     }
+    const normalizedSubscription = this.withSocketPriorityAvailability(subscription);
     const current = this.currentAccount.subscription;
-    if (current && JSON.stringify(current) === JSON.stringify(subscription)) {
+    if (current && JSON.stringify(current) === JSON.stringify(normalizedSubscription)) {
       return true;
     }
-    this.currentAccount._update({ subscription });
+    this.currentAccount._update({ subscription: normalizedSubscription });
     return true;
   }
 
@@ -355,6 +396,7 @@ class AccountApi extends ApiGroup {
     this.accountSessionVersion = this.client.auth.sessionVersion;
     this.lastAppliedSubscriptionVersion = null;
     this.appliedSubscriptionSocketWrites = 0;
+    this.socketPriorityAvailability = null;
     this.currentAccount._clear();
   }
 
@@ -364,6 +406,7 @@ class AccountApi extends ApiGroup {
       // the next login starts from a clean slate.
       this.lastAppliedSubscriptionVersion = null;
       this.appliedSubscriptionSocketWrites = 0;
+      this.socketPriorityAvailability = null;
       this.currentAccount._clear();
     } else {
       this.clearChangedAccountSession();
@@ -699,6 +742,7 @@ class AccountApi extends ApiGroup {
     if (params.provider) {
       query.provider = params.provider;
     }
+    if (params.includePriorityAccounting === true) query.includePriorityAccounting = 'true';
     const res = await this.client.rest.get<ApiResponse<TxHistoryData>>(
       '/v1/transactions/list',
       query
@@ -723,7 +767,10 @@ class AccountApi extends ApiGroup {
           paymentModel: tx.paymentModel,
           subscriptionTier: tx.subscriptionTier,
           subscriptionTrialing: tx.subscriptionTrialing,
-          subscriptionThrottled: tx.subscriptionThrottled
+          subscriptionThrottled: tx.subscriptionThrottled,
+          ...(params.includePriorityAccounting === true && tx.priorityUsage
+            ? { priorityUsage: tx.priorityUsage }
+            : {})
         })
       ),
       next: {
@@ -965,7 +1012,7 @@ class AccountApi extends ApiGroup {
       // currentAccount.subscription.
       return this.currentAccount.subscription;
     }
-    return subscription;
+    return this.currentAccount.subscription ?? subscription;
   }
 
   /**

package/src/Account/subscription.types.ts

@@ -46,6 +46,8 @@ export type SubscriptionTerm = 'monthly' | 'annual';
 /** Actionable monthly fair-use state returned only while Fast limits are active. */
 export interface SubscriptionFairUseState {
   limited: true;
+  /** Temporary accounting confirmation, rather than confirmed exhausted capacity. */
+  accountingStatus?: 'pending';
   /** Subscription-funded Spark used in the current monthly fair-use window. */
   usageSpark: number;
   /** Retail-equivalent USD value of the subscription-funded usage. */

package/src/Account/types.ts

@@ -97,6 +97,14 @@ export interface TxHistoryParams {
   limit: number;
   provider?: string;
   offset?: number;
+  /** Include saved Priority labels on plan usage entries. */
+  includePriorityAccounting?: boolean;
+}
+
+export interface PriorityUsageSummary {
+  outputCount: number;
+  rate: 1.5;
+  coverage: 'complete' | 'partial';
 }
 
 export interface TxHistoryData {
@@ -105,6 +113,7 @@ export interface TxHistoryData {
 }
 
 export interface TxRaw {
+  priorityUsage?: PriorityUsageSummary;
   _id: string;
   id: string;
   SID: number;
@@ -130,6 +139,7 @@ export interface TxRaw {
 }
 
 export interface TxHistoryEntry {
+  priorityUsage?: PriorityUsageSummary;
   id: string;
   address: string;
   createTime: Date;

package/src/ApiClient/WebSocketClient/events.ts

@@ -292,6 +292,12 @@ export type JobResultData = {
   lastFrameUrl?: string;
   lastFrameKey?: string;
   outputFormat?: string;
+  /** Seedance 2.5: this job is a draft that can be finalized at 1080p. */
+  seedanceDraft?: boolean;
+  /** Seedance 2.5 draft: ISO 8601 time after which it can no longer be finalized. */
+  seedanceDraftExpiresAt?: string;
+  /** Seedance 2.5 final: the Sogni job id of the draft it finalized. */
+  seedanceDraftJobId?: string;
   /**
    * Files the worker uploaded for this result, as the worker reported them.
    * The SDK reads `contentType` to pick the download endpoint for a result

package/src/Projects/Job.ts

@@ -117,6 +117,41 @@ function directResultUrlFromRawJob(rawJob: RawJob): string | null {
   );
 }
 
+type SeedanceDraftResultFields = Pick<
+  JobData,
+  'seedanceDraft' | 'seedanceDraftExpiresAt' | 'seedanceDraftJobId'
+>;
+
+function pickSeedanceDraftFields(source: unknown): SeedanceDraftResultFields {
+  if (!source || typeof source !== 'object') return {};
+  const { seedanceDraft, seedanceDraftExpiresAt, seedanceDraftJobId } = source as Record<
+    string,
+    unknown
+  >;
+  return {
+    ...(seedanceDraft === true ? { seedanceDraft } : {}),
+    ...(typeof seedanceDraftExpiresAt === 'string' && seedanceDraftExpiresAt
+      ? { seedanceDraftExpiresAt }
+      : {}),
+    ...(typeof seedanceDraftJobId === 'string' && seedanceDraftJobId ? { seedanceDraftJobId } : {})
+  };
+}
+
+/**
+ * Seedance 2.5 draft result fields from a socket result or a REST job record,
+ * read from the record itself or its allowlisted `result` receipt (the record
+ * wins). Only well-formed fields are returned, so a record without them never
+ * clears values a job already holds.
+ * @internal
+ */
+export function seedanceDraftResultFields(record: unknown): SeedanceDraftResultFields {
+  if (!record || typeof record !== 'object') return {};
+  return {
+    ...pickSeedanceDraftFields((record as { result?: unknown }).result),
+    ...pickSeedanceDraftFields(record)
+  };
+}
+
 function etaProgressPercent(
   startedAt: Date | undefined,
   eta: Date | undefined
@@ -156,6 +191,12 @@ export interface JobData {
   lastFrameUrl?: string;
   lastFrameKey?: string;
   outputFormat?: string;
+  /** Seedance 2.5: this job is a draft that can be finalized at 1080p. */
+  seedanceDraft?: boolean;
+  /** Seedance 2.5 draft: ISO 8601 time after which it can no longer be finalized. */
+  seedanceDraftExpiresAt?: string;
+  /** Seedance 2.5 final: the Sogni job id of the draft it finalized. */
+  seedanceDraftJobId?: string;
   provenance?: JobProvenance;
   error?: ErrorData;
   positivePrompt?: string;
@@ -220,6 +261,7 @@ class Job extends DataEntity<JobData, JobEventMap> {
         lastFrameUrl: rawJob.lastFrameUrl ?? (rawJob.result?.lastFrameUrl as string | undefined),
         lastFrameKey: rawJob.lastFrameKey ?? (rawJob.result?.lastFrameKey as string | undefined),
         outputFormat: rawJob.outputFormat ?? (rawJob.result?.outputFormat as string | undefined),
+        ...seedanceDraftResultFields(rawJob),
         provenance: rawJob.result
       },
       options
@@ -317,6 +359,24 @@ class Job extends DataEntity<JobData, JobEventMap> {
     return this.data.lastFrameUrl;
   }
 
+  /**
+   * Seedance 2.5: `true` on a completed draft, which can be finalized at 1080p by
+   * passing this job's `id` as `seedanceDraftJobId`. Reported to the owner only.
+   */
+  get seedanceDraft() {
+    return this.data.seedanceDraft;
+  }
+
+  /** Seedance 2.5 draft: ISO 8601 time after which it can no longer be finalized. */
+  get seedanceDraftExpiresAt() {
+    return this.data.seedanceDraftExpiresAt;
+  }
+
+  /** Seedance 2.5 final: the Sogni job id of the draft it finalized. */
+  get seedanceDraftJobId() {
+    return this.data.seedanceDraftJobId;
+  }
+
   /** Refresh the signed URL for an exported final frame. */
   async getLastFrameUrl(): Promise<string> {
     const url = await this._api.mediaDownloadUrl({
@@ -552,7 +612,8 @@ class Job extends DataEntity<JobData, JobEventMap> {
       ...(data.result ? { provenance: data.result } : {}),
       lastFrameUrl: data.lastFrameUrl ?? (data.result?.lastFrameUrl as string | undefined),
       lastFrameKey: data.lastFrameKey ?? (data.result?.lastFrameKey as string | undefined),
-      outputFormat: data.outputFormat ?? (data.result?.outputFormat as string | undefined)
+      outputFormat: data.outputFormat ?? (data.result?.outputFormat as string | undefined),
+      ...seedanceDraftResultFields(data)
     };
     if (JOB_STATUS_MAP[data.status]) {
       delta.status = JOB_STATUS_MAP[data.status];

package/src/Projects/createJobRequestMessage.ts

@@ -166,6 +166,8 @@ function validateVideoWorkflowAssets(params: VideoProjectParams): void {
   if (exportError) {
     throw new ApiError(400, { status: 'error', errorCode: 0, message: exportError });
   }
+  validateSeedanceDraftFields(params);
+  validateSeedanceDraftFinalize(params);
   validateVideoContextImages(params);
   validateVideoKeyframes(params);
   validateVideoReferenceArrays(params);
@@ -250,6 +252,80 @@ function validateVideoWorkflowAssets(params: VideoProjectParams): void {
   }
 }
 
+/** Prompt a finalize request carries; the final always uses its draft's prompt. */
+const SEEDANCE_DRAFT_FINALIZE_PROMPT = 'Finalize the Seedance 2.5 draft at 1080p.';
+
+function seedanceDraftError(message: string): never {
+  throw new ApiError(400, { status: 'error', errorCode: 0, message });
+}
+
+/**
+ * Seedance 2.5 draft mode fields, shared by projects and video estimates:
+ * `seedanceDraft` creates a 480p draft and `seedanceDraftJobId` finalizes one
+ * at 1080p. The server checks ownership, expiry, model and size; this only
+ * catches requests no server would accept.
+ */
+export function validateSeedanceDraftFields(params: {
+  modelId?: string;
+  model?: string;
+  seedanceDraft?: unknown;
+  seedanceDraftJobId?: unknown;
+}): void {
+  const { seedanceDraft, seedanceDraftJobId } = params;
+  if (seedanceDraft !== undefined && typeof seedanceDraft !== 'boolean') {
+    seedanceDraftError('seedanceDraft must be a boolean.');
+  }
+  if (
+    seedanceDraftJobId !== undefined &&
+    (typeof seedanceDraftJobId !== 'string' || !seedanceDraftJobId.trim())
+  ) {
+    seedanceDraftError('seedanceDraftJobId must be the Sogni job id of a Seedance 2.5 draft.');
+  }
+  if (seedanceDraft !== true && seedanceDraftJobId === undefined) return;
+  if (!isSeedance25Model(String(params.modelId ?? params.model ?? ''))) {
+    seedanceDraftError('Seedance draft mode is supported only by Seedance 2.5.');
+  }
+  if (seedanceDraft === true && seedanceDraftJobId !== undefined) {
+    seedanceDraftError(
+      'seedanceDraft and seedanceDraftJobId are mutually exclusive: create a draft, or finalize one.'
+    );
+  }
+}
+
+/**
+ * A finalize renders an existing draft at 1080p and inherits every
+ * generation-defining input from it; the vendor refuses any of them sent again,
+ * even with identical values.
+ */
+function validateSeedanceDraftFinalize(params: VideoProjectParams): void {
+  if (params.seedanceDraftJobId === undefined) return;
+  const inherited: Array<[keyof VideoProjectParams, boolean]> = [
+    ['referenceImage', Boolean(params.referenceImage)],
+    ['referenceImageEnd', Boolean(params.referenceImageEnd)],
+    ['referenceImageUrls', asReferenceUrlArray(params.referenceImageUrls).length > 0],
+    ['referenceVideo', Boolean(params.referenceVideo)],
+    ['referenceVideoUrls', asReferenceUrlArray(params.referenceVideoUrls).length > 0],
+    ['referenceAudio', Boolean(params.referenceAudio)],
+    ['referenceAudioUrls', asReferenceUrlArray(params.referenceAudioUrls).length > 0],
+    ['referenceAudioIdentity', Boolean(params.referenceAudioIdentity)],
+    ['duration', params.duration !== undefined],
+    ['frames', params.frames !== undefined],
+    ['ratio', params.ratio !== undefined],
+    ['seed', params.seed !== undefined],
+    ['generateAudio', params.generateAudio !== undefined],
+    ['seedanceTaskType', params.seedanceTaskType !== undefined]
+  ];
+  const sent = inherited.filter(([, present]) => present).map(([name]) => name);
+  if (sent.length) {
+    seedanceDraftError(
+      `A Seedance 2.5 finalize reuses its draft's inputs and settings; remove ${sent.join(', ')}.`
+    );
+  }
+  if ((params.numberOfMedia ?? 1) !== 1) {
+    seedanceDraftError('A Seedance 2.5 finalize renders its draft once; numberOfMedia must be 1.');
+  }
+}
+
 function validateSeedanceTaskType(params: VideoProjectParams): void {
   const taskType = params.seedanceTaskType;
   const isSeedance25 = isSeedance25Model(params.modelId);
@@ -1754,6 +1830,15 @@ function applyVideoParams(
   if (params.seedanceTaskType !== undefined) {
     keyFrame.seedanceTaskType = params.seedanceTaskType;
   }
+  if (params.seedanceDraft === true) {
+    keyFrame.seedanceDraft = true;
+  }
+  if (params.seedanceDraftJobId !== undefined) {
+    keyFrame.seedanceDraftJobId = params.seedanceDraftJobId;
+    // The final inherits the draft's prompt. The request still carries a
+    // non-empty prompt, which the server ignores for a finalize.
+    keyFrame.positivePrompt = SEEDANCE_DRAFT_FINALIZE_PROMPT;
+  }
   if (params.audioIdentityStrength !== undefined) {
     keyFrame.identityGuidanceScale = params.audioIdentityStrength;
   }
@@ -2059,6 +2144,11 @@ function createJobRequestMessage(id: string, params: ProjectParams, options: Mod
   if (params.network) {
     jobRequest.network = params.network;
   }
+  if (params.priorityMode !== undefined) {
+    if (typeof params.priorityMode !== 'boolean')
+      throw new Error('Priority mode must be true or false.');
+    jobRequest.priorityMode = params.priorityMode;
+  }
   if (isImageParams(params) && params.embedPromptMetadata !== undefined) {
     if (typeof params.embedPromptMetadata !== 'boolean') {
       throw new Error('embedPromptMetadata must be a boolean');

package/src/Projects/index.ts

@@ -41,7 +41,8 @@ import {
 } from './recovery.js';
 import createJobRequestMessage, {
   type JobRequestRaw,
-  rejectRetiredOutputScale
+  rejectRetiredOutputScale,
+  validateSeedanceDraftFields
 } from './createJobRequestMessage.js';
 import { ApiError, ApiResponse } from '../ApiClient/index.js';
 import { EstimationResponse } from './types/EstimationResponse.js';
@@ -66,7 +67,7 @@ import type { WaitingReason } from './types/WaitingReason.js';
 import ErrorData from '../types/ErrorData.js';
 import { SupernetType } from '../ApiClient/WebSocketClient/types.js';
 import Cache from '../lib/Cache.js';
-import Job, { enhancementDefaults } from './Job.js';
+import Job, { enhancementDefaults, seedanceDraftResultFields } from './Job.js';
 import {
   calculateVideoFrames,
   getEnhacementStrength,
@@ -1035,6 +1036,7 @@ class ProjectsApi extends ApiGroup<ProjectApiEvents> {
     let performedStepCount = data.performedStepCount;
     let seed = data.lastSeed !== undefined ? Number(data.lastSeed) : undefined;
     const provenance = jobProvenanceFromResult(data);
+    const seedanceDraftFields = seedanceDraftResultFields(data);
     if (project) {
       const job = project.job(data.imgID);
       if (job) {
@@ -1053,6 +1055,8 @@ class ProjectsApi extends ApiGroup<ProjectApiEvents> {
           lastFrameUrl: data.lastFrameUrl,
           lastFrameKey: data.lastFrameKey,
           outputFormat: data.outputFormat,
+          // Set with the status, so a `completed` listener can already read them.
+          ...seedanceDraftFields,
           // Unchanged meaning: the server withheld the media. The label for
           // media that WAS delivered is `nsfwDetected`, deliberately kept out of
           // this flag so upgrading the SDK changes no existing app's behaviour.
@@ -1078,6 +1082,7 @@ class ProjectsApi extends ApiGroup<ProjectApiEvents> {
       resultUrl: downloadUrl,
       lastFrameUrl: data.lastFrameUrl,
       outputFormat: data.outputFormat,
+      ...seedanceDraftFields,
       isNSFW: Boolean(data.triggeredNSFWFilter),
       nsfwDetected: data.nsfwDetected === true,
       nsfwSources: Array.isArray(data.nsfwSources) ? [...data.nsfwSources] : [],
@@ -1467,7 +1472,9 @@ class ProjectsApi extends ApiGroup<ProjectApiEvents> {
           delta.seed = event.seed;
         }
         job._update({
-          ...delta
+          ...delta,
+          // A job first seen in its own completion still learns it is a draft.
+          ...seedanceDraftResultFields(event)
         });
         break;
       }
@@ -2121,6 +2128,7 @@ class ProjectsApi extends ApiGroup<ProjectApiEvents> {
             : (job.result as Record<string, unknown> | undefined)?.outputFormat) as
             | string
             | undefined,
+          ...seedanceDraftResultFields(job),
           ...(typeof job.resultUrl === 'string' && job.resultUrl
             ? { resultUrl: job.resultUrl }
             : {}),
@@ -3336,7 +3344,8 @@ class ProjectsApi extends ApiGroup<ProjectApiEvents> {
     contextImages,
     gptImageQuality,
     outputFormat,
-    billingMode
+    billingMode,
+    priorityMode
   }: EstimateRequest): Promise<CostEstimation> {
     let apiVersion = 2;
     const modelOptions = await this.getModelOptions(model);
@@ -3372,6 +3381,7 @@ class ProjectsApi extends ApiGroup<ProjectApiEvents> {
     if (gptImageQuality) queryParams.set('gptImageQuality', gptImageQuality);
     if (outputFormat) queryParams.set('outputFormat', outputFormat);
     if (billingMode) queryParams.set('billingMode', billingMode);
+    if (priorityMode !== undefined) queryParams.set('priorityMode', String(priorityMode));
     const query = queryParams.toString();
     const r = await this.client.socket.get<EstimationResponse>(
       `/api/v${apiVersion}/job/estimate/${pathParams.join('/')}${query ? `?${query}` : ''}`
@@ -3429,6 +3439,9 @@ class ProjectsApi extends ApiGroup<ProjectApiEvents> {
    *   - referenceVideoDurationSeconds: Combined duration of MiniMax H3 r2v video input.
    *   - keyframeCount / keyframes: MiniMax H3 intermediate keyframes (0-8). The first two are
    *     included; each extra keyframe adds 0.75 s of output time on FastH3 and 0.3 s on other tiers.
+   *   - seedanceDraft: Seedance 2.5 480p draft, priced like the same 480p job.
+   *   - seedanceDraftJobId: Seedance 2.5 finalize of that draft at 1080p, priced by the server from
+   *     the draft (duration, aspect ratio, input video); width, height, duration and fps do not change it.
    * @return {Promise<Object>} Returns an object containing the estimated costs for the video in different units:
    *   - token: Cost in tokens.
    *   - usd: Cost in USD.
@@ -3437,6 +3450,7 @@ class ProjectsApi extends ApiGroup<ProjectApiEvents> {
    */
   async estimateVideoCost(params: VideoEstimateRequest) {
     rejectRetiredOutputScale(params);
+    validateSeedanceDraftFields(params);
     const frames = params.frames
       ? params.frames
       : calculateVideoFrames(params.model, params.duration, params.fps);
@@ -3500,6 +3514,11 @@ class ProjectsApi extends ApiGroup<ProjectApiEvents> {
     const network = params.network ?? this._currentNetworkType;
     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.seedanceDraft === true) query.set('seedanceDraft', '1');
+    if (params.seedanceDraftJobId !== undefined) {
+      query.set('seedanceDraftJobId', params.seedanceDraftJobId);
+    }
     const queryString = query.toString();
     const r = await this.client.socket.get<EstimationResponse>(
       `/api/v1/job-video/estimate/${path}${queryString ? `?${queryString}` : ''}`
@@ -3540,6 +3559,7 @@ class ProjectsApi extends ApiGroup<ProjectApiEvents> {
     const network = params.network ?? this._currentNetworkType;
     if (network) query.set('network', network);
     if (params.billingMode) query.set('billingMode', params.billingMode);
+    if (params.priorityMode !== undefined) query.set('priorityMode', String(params.priorityMode));
     const queryString = query.toString();
     const r = await this.client.socket.get<EstimationResponse>(
       `/api/v1/job-audio/estimate/${path}${queryString ? `?${queryString}` : ''}`

package/src/Projects/recovery.ts

@@ -121,6 +121,7 @@ export function projectParamsFromRecoveredProject(project: RecoveredProject): Pr
   if (tokenType) base.tokenType = tokenType;
   const billingMode = project.billingMode || request.billingMode;
   if (billingMode) base.billingMode = billingMode;
+  if (project.priorityMode !== undefined) base.priorityMode = project.priorityMode;
   if (request.disableSafety === true) base.disableNSFWFilter = true;
   if (typeof request.outputFormat === 'string' && request.outputFormat) {
     base.outputFormat = request.outputFormat;

package/src/Projects/types/RawProject.ts

@@ -5,6 +5,7 @@ import type { WaitingReason, JobWaitingReason } from './WaitingReason.js';
 export interface RawProject {
   /** Missing on older projects or clients that do not report prompt preparation. */
   promptExpanded?: boolean;
+  priorityMode?: boolean;
   waitingReason?: WaitingReason | null;
   jobWaitingReasons?: JobWaitingReason[];
   id: string;
@@ -96,6 +97,12 @@ export interface RawJob {
   lastFrameUrl?: string;
   lastFrameKey?: string;
   outputFormat?: string;
+  /** Seedance 2.5: this job is a draft that can be finalized at 1080p. */
+  seedanceDraft?: boolean;
+  /** Seedance 2.5 draft: ISO 8601 time after which it can no longer be finalized. */
+  seedanceDraftExpiresAt?: string;
+  /** Seedance 2.5 final: the Sogni job id of the draft it finalized. */
+  seedanceDraftJobId?: string;
   result?: JobProvenance & Record<string, unknown>;
 }
 

package/src/Projects/types/events.ts

@@ -108,6 +108,12 @@ export interface JobCompleted extends JobEventBase {
   resultUrl: string | null;
   lastFrameUrl?: string;
   outputFormat?: string;
+  /** Seedance 2.5: this job is a draft that can be finalized at 1080p. */
+  seedanceDraft?: boolean;
+  /** Seedance 2.5 draft: ISO 8601 time after which it can no longer be finalized. */
+  seedanceDraftExpiresAt?: string;
+  /** Seedance 2.5 final: the Sogni job id of the draft it finalized. */
+  seedanceDraftJobId?: string;
   /**
    * A safety signal fired. Either the media was withheld (filter on, no
    * `resultUrl`) or it was delivered and merely labelled - see `nsfwDetected`.