@sogni-ai/sogni-client 5.56.3 → 5.58.0

package/dist/Projects/index.d.ts

@@ -7,6 +7,7 @@ import { AvailableLorasParams, LoraCatalog, LoraCatalogEntry, LoraConstraints }
 import PersonalLoras from './PersonalLoras.js';
 import { ProjectApiEvents, type ProjectSyncReason, type ProjectSyncResult } from './types/events.js';
 import { RawProject } from './types/RawProject.js';
+import type { WaitingReason } from './types/WaitingReason.js';
 import { SupernetType } from '../ApiClient/WebSocketClient/types.js';
 import { type ResultMediaEvidence, type ResultMediaKind } from './utils/index.js';
 import { TokenType } from '../types/token.js';
@@ -62,6 +63,86 @@ export type ProjectStatusSnapshot = Partial<Omit<RawProject, 'status' | 'workerJ
     workerJobs: RawProject['workerJobs'];
     completedWorkerJobs: RawProject['completedWorkerJobs'];
 };
+/**
+ * One render of a project returned by {@link ProjectsApi.getResult}.
+ */
+export interface ProjectResultJob {
+    /** The render's result id (the `imgID` of its events). */
+    id: string;
+    /**
+     * `completed`, `failed` or `canceled` once it has finished; otherwise the
+     * worker job's in-flight status (`queued`, `assigned`, `jobStarted`, ...).
+     */
+    status: string;
+    /** Why a failed or cancelled render ended, e.g. `genfailure` or `artistCanceled`. */
+    reason?: string;
+    /** What the result is, when it is known. */
+    kind?: ResultMediaKind;
+    /** Signed download URL for a completed render's media. It expires; fetch a new one when it does. */
+    url?: string;
+    /**
+     * Why a completed render has no `url`: `sensitiveContent` when the Sensitive
+     * Content Filter withheld it, `unknownMediaKind` when neither the model nor
+     * the result says what media it is, `downloadUrlFailed` when the API refused
+     * or failed to sign one (retry later).
+     */
+    urlUnavailable?: 'sensitiveContent' | 'unknownMediaKind' | 'downloadUrlFailed';
+    /** Seed the render used, when recorded. */
+    seed?: number;
+}
+/**
+ * One of this account's projects as {@link ProjectsApi.getResult} sees it:
+ * its current state, why it is still waiting if it is, and every render with
+ * a download URL for the ones that completed.
+ */
+export interface ProjectResult {
+    id: string;
+    status: ProjectLookupStatus;
+    /** `true` for `completed`, `failed` and `canceled`. */
+    finished: boolean;
+    modelId?: string;
+    /**
+     * While it is still queued: the server's explanation, e.g. the account's own
+     * plan concurrency limit (`concurrency_limit`, `model_concurrency_limit`)
+     * rather than a shortage of workers (`no_workers`). Absent when the server
+     * did not report one.
+     */
+    waitingReason?: WaitingReason | null;
+    jobs: ProjectResultJob[];
+}
+/** A render of a project returned by {@link ProjectsApi.listRecent}. */
+export interface RecentProjectJob {
+    /** The render's result id; pass the project id to {@link ProjectsApi.getResult} for its URL. */
+    id: string;
+    status: string;
+    /** The Sensitive Content Filter withheld this render's media. */
+    sensitiveContentWithheld: boolean;
+    /** Milliseconds since the epoch. */
+    finishedAt?: number;
+}
+/** A project returned by {@link ProjectsApi.listRecent}. */
+export interface RecentProject {
+    id: string;
+    modelId?: string;
+    modelName?: string;
+    /** The app that submitted it, when recorded (e.g. `sogni-creative-agent-skill`). */
+    appSource?: string;
+    /** When its latest render finished, in milliseconds since the epoch. */
+    finishedAt?: number;
+    jobs: RecentProjectJob[];
+}
+export interface ListRecentProjectsOptions {
+    /**
+     * Oldest finish time to include, as a `Date` or milliseconds since the epoch.
+     * Defaults to 24 hours ago. The history keeps 7 days, so anything older is
+     * read as 7 days ago.
+     */
+    since?: Date | number;
+    /** Renders to read, 1-100 (default 50). Projects are grouped from these. */
+    limit?: number;
+    /** Only projects submitted by this app source. */
+    appSource?: string;
+}
 declare class ProjectsApi extends ApiGroup<ProjectApiEvents> {
     private _personalLoras?;
     /** Import, inspect, discover, and remove the signed-in account's personal LoRAs. */
@@ -418,6 +499,62 @@ declare class ProjectsApi extends ApiGroup<ProjectApiEvents> {
      * @param projectId
      */
     getStatus(projectId: string): Promise<ProjectStatusSnapshot>;
+    /**
+     * State and results of one of this account's projects by id, whenever it is
+     * asked: while it is queued or rendering, and after it finished, including
+     * one that finished while this client was offline, or after it stopped
+     * waiting, or long after the socket stopped holding it for a reconnect.
+     *
+     * Completed renders come back with signed download URLs, minted the same way
+     * a live result's are. A queued project carries the server's `waitingReason`,
+     * which says whether it is held by the account's own plan concurrency or is
+     * waiting for a worker. Needs an authenticated client; another account's or
+     * an unknown project rejects with a 404 `ApiError`.
+     *
+     * @example
+     * ```ts
+     * const result = await sogni.projects.getResult(projectId);
+     * if (result.finished) {
+     *   for (const job of result.jobs) if (job.url) console.log(job.url);
+     * } else {
+     *   console.log(result.status, result.waitingReason?.message);
+     * }
+     * ```
+     * @param projectId
+     * @param options.kind - What the project produces, when the caller knows it
+     *   (`image`, `video`, `audio`, `model`). Used only when neither the model
+     *   catalog nor the stored result says, so a URL is never minted from the
+     *   wrong endpoint.
+     */
+    getResult(projectId: string, options?: {
+        kind?: ResultMediaKind;
+    }): Promise<ProjectResult>;
+    /**
+     * This account's recently completed projects that produced media, newest
+     * first, read from the durable history rather than the socket. It includes
+     * projects that finished while no client was connected, and ones the socket
+     * has stopped holding for a reconnect (it keeps a finished project for one
+     * hour). Pass a project's id to {@link getResult} for its download URLs.
+     *
+     * Reaches back at most 7 days. Needs a signed-in account.
+     *
+     * @example
+     * ```ts
+     * const recent = await sogni.projects.listRecent({ since: Date.now() - 6 * 3600_000 });
+     * for (const project of recent) {
+     *   const result = await sogni.projects.getResult(project.id);
+     * }
+     * ```
+     */
+    listRecent(options?: ListRecentProjectsOptions): Promise<RecentProject[]>;
+    private _accountAddress?;
+    /**
+     * How {@link listRecent} learns the signed-in account's address. Set by
+     * `SogniClient`, which owns the account.
+     * @internal
+     */
+    _setAccountAddressResolver(resolve: () => Promise<string | undefined>): void;
+    private _resolveAccountAddress;
     /**
      * Ids of this account's projects that are currently live on the socket,
      * including ones still queued with no worker assigned.
@@ -452,6 +589,12 @@ declare class ProjectsApi extends ApiGroup<ProjectApiEvents> {
     private uploadGuideImage;
     private uploadCNImage;
     private uploadContextImage;
+    /**
+     * Upload one MiniMax H3 intermediate keyframe image to its `keyframeImage<slot>`
+     * slot.
+     * @internal
+     */
+    private uploadKeyframeImage;
     /**
      * Upload reference image for WAN video workflows
      * @internal
@@ -509,6 +652,8 @@ declare class ProjectsApi extends ApiGroup<ProjectApiEvents> {
      *   - referenceImageCount: Number of image references submitted by the estimated job.
      *   - referenceVideoCount: Number of video references submitted by a MiniMax H3 r2v job.
      *   - 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.
      * @return {Promise<Object>} Returns an object containing the estimated costs for the video in different units:
      *   - token: Cost in tokens.
      *   - usd: Cost in USD.
@@ -551,7 +696,8 @@ declare class ProjectsApi extends ApiGroup<ProjectApiEvents> {
      *     specific request.
      *   - type: Asset role. Supported values include `'referenceImage'`,
      *     `'referenceImageEnd'`, `'startingImage'`, `'cnImage'`,
-     *     `'contextImage1'`..`'contextImage16'`, `'preview'`, `'complete'`.
+     *     `'contextImage1'`..`'contextImage16'`, `'keyframeImage1'`..`'keyframeImage8'`
+     *     (MiniMax H3 intermediate keyframes), `'preview'`, `'complete'`.
      *   - contentType: Optional MIME type the caller will `PUT` (e.g.
      *     `"image/png"`). Forwarded so the storage layer can pin the
      *     Content-Type on the presigned URL.
@@ -652,6 +798,9 @@ declare class ProjectsApi extends ApiGroup<ProjectApiEvents> {
      * This table describes the first upload slot only. MiniMax H3 r2v also uses
      * `contextImages`, `referenceVideos`, and `referenceAudios`; callers should
      * read those fields on `VideoProjectParams` for the multi-reference limits.
+     * Every MiniMax H3 id except text-to-video also accepts optional intermediate
+     * `keyframes`, which the table does not list: `isMinimaxH3KeyframeModel()`
+     * tells which ids take them, and `VideoProjectParams.keyframes` gives the rules.
      *
      * @param {string} modelId - The identifier of the video model to retrieve the configuration for.
      * @return {Object} The video asset configuration object where key is asset field and value is

package/dist/Projects/index.js

@@ -313,6 +313,18 @@ const RESUBMIT_RECONNECT_TIMEOUT_MS = 60000;
 const MISSING_PROJECT_ATTEMPTS = 4;
 const MISSING_PROJECT_RETRY_MS = 2500;
 const IN_FLIGHT_LOOKUP_STATUSES = new Set(['pending', 'queued', 'processing']);
+const RECENT_PROJECTS_DEFAULT_WINDOW_MS = 24 * 60 * 60 * 1000;
+// The history API refuses a media-only lookup reaching back more than 7 days;
+// stay a minute inside it so a slow clock cannot turn a 7-day request into a 400.
+const RECENT_PROJECTS_MAX_WINDOW_MS = 7 * 24 * 60 * 60 * 1000 - 60 * 1000;
+/** A worker job's status in the names {@link ProjectResultJob} uses. */
+function resultJobStatus(job) {
+    if (job.status === 'jobCompleted')
+        return 'completed';
+    if (job.status === 'jobError')
+        return job.reason === 'artistCanceled' ? 'canceled' : 'failed';
+    return job.status || 'unknown';
+}
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 class ProjectsApi extends ApiGroup_js_1.default {
     /** Import, inspect, discover, and remove the signed-in account's personal LoRAs. */
@@ -2034,6 +2046,13 @@ class ProjectsApi extends ApiGroup_js_1.default {
             yield Promise.all((0, index_js_2.getVideoContextImageSlots)(data).map(({ slot, media }) => typeof media === 'boolean'
                 ? undefined
                 : this.uploadContextImage(project.id, (slot - 1), media)));
+            // MiniMax H3 intermediate keyframes, uploaded to their own keyframeImage1..N
+            // slots in caller order, apart from the contextImage slots r2v references
+            // use. createJobRequestMessage has already checked the model, the entries
+            // and the frame indices.
+            yield Promise.all((0, index_js_2.getMinimaxH3KeyframeSlots)(data).map(({ slot, media }) => typeof media === 'boolean'
+                ? undefined
+                : this.uploadKeyframeImage(project.id, slot, media)));
             if ((data === null || data === void 0 ? void 0 : data.referenceImageEnd) && data.referenceImageEnd !== true) {
                 yield this.uploadReferenceImageEnd(project.id, data.referenceImageEnd);
             }
@@ -2132,6 +2151,164 @@ class ProjectsApi extends ApiGroup_js_1.default {
             return data.project;
         });
     }
+    /**
+     * State and results of one of this account's projects by id, whenever it is
+     * asked: while it is queued or rendering, and after it finished, including
+     * one that finished while this client was offline, or after it stopped
+     * waiting, or long after the socket stopped holding it for a reconnect.
+     *
+     * Completed renders come back with signed download URLs, minted the same way
+     * a live result's are. A queued project carries the server's `waitingReason`,
+     * which says whether it is held by the account's own plan concurrency or is
+     * waiting for a worker. Needs an authenticated client; another account's or
+     * an unknown project rejects with a 404 `ApiError`.
+     *
+     * @example
+     * ```ts
+     * const result = await sogni.projects.getResult(projectId);
+     * if (result.finished) {
+     *   for (const job of result.jobs) if (job.url) console.log(job.url);
+     * } else {
+     *   console.log(result.status, result.waitingReason?.message);
+     * }
+     * ```
+     * @param projectId
+     * @param options.kind - What the project produces, when the caller knows it
+     *   (`image`, `video`, `audio`, `model`). Used only when neither the model
+     *   catalog nor the stored result says, so a URL is never minted from the
+     *   wrong endpoint.
+     */
+    getResult(projectId_1) {
+        return __awaiter(this, arguments, void 0, function* (projectId, options = {}) {
+            var _a, _b, _c, _d, _e;
+            const assertSession = (0, requestSession_js_1.captureRequestSession)(this.client.auth);
+            const snapshot = yield this.getStatus(projectId);
+            assertSession();
+            const modelId = (_a = snapshot.model) === null || _a === void 0 ? void 0 : _a.id;
+            // The stored record's model carries its media type even though ProjectModel does not declare it.
+            const recordType = (_b = snapshot.model) === null || _b === void 0 ? void 0 : _b.type;
+            const projectType = typeof recordType === 'string' ? recordType : undefined;
+            const jobs = [];
+            const seen = new Set();
+            for (const job of [...(snapshot.completedWorkerJobs || []), ...(snapshot.workerJobs || [])]) {
+                const id = job.imgID || job.id;
+                if (!id || seen.has(id))
+                    continue;
+                seen.add(id);
+                const status = resultJobStatus(job);
+                const entry = { id, status };
+                if (status !== 'completed' && job.reason)
+                    entry.reason = job.reason;
+                if (typeof job.seedUsed === 'number' && job.seedUsed >= 0)
+                    entry.seed = job.seedUsed;
+                if (status === 'completed') {
+                    // Same rule as a live result: withheld only when the filter fired and
+                    // no advisory label says the media was delivered anyway.
+                    if (job.triggeredNSFWFilter === true && job.nsfwDetected !== true) {
+                        entry.urlUnavailable = 'sensitiveContent';
+                    }
+                    else if (typeof job.resultUrl === 'string' && job.resultUrl) {
+                        entry.url = job.resultUrl;
+                    }
+                    else {
+                        const result = (0, index_js_2.resultMediaEvidence)(Object.assign(Object.assign({}, (job.result || {})), { outputFormat: (_c = job.outputFormat) !== null && _c !== void 0 ? _c : (_d = job.result) === null || _d === void 0 ? void 0 : _d.outputFormat }));
+                        const kind = (_e = this._resultMediaKind({ modelId, projectType, result })) !== null && _e !== void 0 ? _e : options.kind;
+                        if (!kind) {
+                            entry.urlUnavailable = 'unknownMediaKind';
+                        }
+                        else {
+                            entry.kind = kind;
+                            try {
+                                entry.url = yield this._mintResultUrl({
+                                    projectId: snapshot.id,
+                                    jobId: id,
+                                    kind,
+                                    audioContentType: result === null || result === void 0 ? void 0 : result.contentType
+                                });
+                            }
+                            catch (error) {
+                                this.client.logger.error(`Failed to sign a download URL for ${snapshot.id}/${id}`);
+                                this.client.logger.error(error);
+                                entry.urlUnavailable = 'downloadUrlFailed';
+                            }
+                            assertSession();
+                        }
+                    }
+                }
+                jobs.push(entry);
+            }
+            return Object.assign(Object.assign(Object.assign({ id: snapshot.id, status: snapshot.status, finished: snapshot.finished }, (modelId ? { modelId } : {})), (snapshot.waitingReason !== undefined ? { waitingReason: snapshot.waitingReason } : {})), { jobs });
+        });
+    }
+    /**
+     * This account's recently completed projects that produced media, newest
+     * first, read from the durable history rather than the socket. It includes
+     * projects that finished while no client was connected, and ones the socket
+     * has stopped holding for a reconnect (it keeps a finished project for one
+     * hour). Pass a project's id to {@link getResult} for its download URLs.
+     *
+     * Reaches back at most 7 days. Needs a signed-in account.
+     *
+     * @example
+     * ```ts
+     * const recent = await sogni.projects.listRecent({ since: Date.now() - 6 * 3600_000 });
+     * for (const project of recent) {
+     *   const result = await sogni.projects.getResult(project.id);
+     * }
+     * ```
+     */
+    listRecent() {
+        return __awaiter(this, arguments, void 0, function* (options = {}) {
+            var _a, _b, _c, _d, _e, _f, _g;
+            const assertSession = (0, requestSession_js_1.captureRequestSession)(this.client.auth);
+            const address = yield this._resolveAccountAddress();
+            assertSession();
+            if (!address) {
+                throw new Error('listRecent needs a signed-in account');
+            }
+            const now = Date.now();
+            const requestedSince = options.since instanceof Date
+                ? options.since.getTime()
+                : typeof options.since === 'number'
+                    ? options.since
+                    : now - RECENT_PROJECTS_DEFAULT_WINDOW_MS;
+            const since = Math.max(requestedSince, now - RECENT_PROJECTS_MAX_WINDOW_MS);
+            const limit = Math.min(100, Math.max(1, Math.floor((_a = options.limit) !== null && _a !== void 0 ? _a : 50)));
+            const { data } = yield this.client.rest.get('/v1/jobs/list', Object.assign({ role: 'artist', address, state: 'completed', mediaOnly: true, since,
+                limit }, (options.appSource ? { appSource: options.appSource } : {})));
+            assertSession();
+            const projects = new Map();
+            for (const job of (data === null || data === void 0 ? void 0 : data.jobs) || []) {
+                const projectId = (_b = job.parentRequest) === null || _b === void 0 ? void 0 : _b.id;
+                if (!projectId)
+                    continue;
+                let project = projects.get(projectId);
+                if (!project) {
+                    project = Object.assign(Object.assign(Object.assign(Object.assign({ id: projectId }, (((_d = (_c = job.parentRequest) === null || _c === void 0 ? void 0 : _c.model) === null || _d === void 0 ? void 0 : _d.id) ? { modelId: job.parentRequest.model.id } : {})), (((_f = (_e = job.parentRequest) === null || _e === void 0 ? void 0 : _e.model) === null || _f === void 0 ? void 0 : _f.name) ? { modelName: job.parentRequest.model.name } : {})), (((_g = job.parentRequest) === null || _g === void 0 ? void 0 : _g.appSource) ? { appSource: job.parentRequest.appSource } : {})), { jobs: [] });
+                    projects.set(projectId, project);
+                }
+                const finishedAt = typeof job.endTime === 'number' && job.endTime > 0 ? job.endTime : undefined;
+                project.jobs.push(Object.assign({ id: job.imgID || job.id, status: resultJobStatus(job), sensitiveContentWithheld: job.triggeredNSFWFilter === true && job.nsfwDetected !== true }, (finishedAt ? { finishedAt } : {})));
+                if (finishedAt && (!project.finishedAt || finishedAt > project.finishedAt)) {
+                    project.finishedAt = finishedAt;
+                }
+            }
+            return [...projects.values()].sort((a, b) => { var _a, _b; return ((_a = b.finishedAt) !== null && _a !== void 0 ? _a : 0) - ((_b = a.finishedAt) !== null && _b !== void 0 ? _b : 0); });
+        });
+    }
+    /**
+     * How {@link listRecent} learns the signed-in account's address. Set by
+     * `SogniClient`, which owns the account.
+     * @internal
+     */
+    _setAccountAddressResolver(resolve) {
+        this._accountAddress = resolve;
+    }
+    _resolveAccountAddress() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this._accountAddress ? this._accountAddress() : undefined;
+        });
+    }
     /**
      * Ids of this account's projects that are currently live on the socket,
      * including ones still queued with no worker assigned.
@@ -2372,6 +2549,43 @@ class ProjectsApi extends ApiGroup_js_1.default {
             return imageId;
         });
     }
+    /**
+     * Upload one MiniMax H3 intermediate keyframe image to its `keyframeImage<slot>`
+     * slot.
+     * @internal
+     */
+    uploadKeyframeImage(projectId, slot, file) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const imageId = (0, getUUID_js_1.default)();
+            const type = `keyframeImage${slot}`;
+            const assertSession = (_a = this._preparingSessions.get(projectId)) !== null && _a !== void 0 ? _a : (0, requestSession_js_1.captureRequestSession)(this.client.auth);
+            assertSession();
+            const contentType = getFileContentType(file);
+            if (yield this.assets.tryBindFile(file, contentType, { projectId, type }))
+                return imageId;
+            assertSession();
+            const presignedUrl = yield this.uploadUrl({ imageId, jobId: projectId, type, contentType });
+            const headers = {};
+            if (contentType)
+                headers['Content-Type'] = contentType;
+            assertSession();
+            const res = yield fetch(presignedUrl, {
+                method: 'PUT',
+                body: toFetchBody(file),
+                headers
+            });
+            assertSession();
+            if (!res.ok) {
+                throw new index_js_1.ApiError(res.status, {
+                    status: 'error',
+                    errorCode: 0,
+                    message: `Failed to upload keyframe image ${slot}`
+                });
+            }
+            return imageId;
+        });
+    }
     // ============================================
     // VIDEO WORKFLOW UPLOADS (WAN 2.2)
     // ============================================
@@ -2665,6 +2879,8 @@ class ProjectsApi extends ApiGroup_js_1.default {
      *   - referenceImageCount: Number of image references submitted by the estimated job.
      *   - referenceVideoCount: Number of video references submitted by a MiniMax H3 r2v job.
      *   - 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.
      * @return {Promise<Object>} Returns an object containing the estimated costs for the video in different units:
      *   - token: Cost in tokens.
      *   - usd: Cost in USD.
@@ -2673,7 +2889,7 @@ class ProjectsApi extends ApiGroup_js_1.default {
      */
     estimateVideoCost(params) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c, _d, _e;
+            var _a, _b, _c, _d, _e, _f;
             (0, createJobRequestMessage_js_1.rejectRetiredOutputScale)(params);
             const frames = params.frames
                 ? params.frames
@@ -2719,8 +2935,12 @@ class ProjectsApi extends ApiGroup_js_1.default {
                 params.referenceVideoDurationSeconds >= 0) {
                 query.set('referenceVideoDurationSeconds', String(params.referenceVideoDurationSeconds));
             }
+            const keyframeCount = (_b = params.keyframeCount) !== null && _b !== void 0 ? _b : (Array.isArray(params.keyframes) ? params.keyframes.length : undefined);
+            if (Number.isFinite(keyframeCount) && keyframeCount > 0) {
+                query.set('keyframeCount', String(Math.floor(keyframeCount)));
+            }
             // Unpinned, the job renders on the connection's network, so quote that one.
-            const network = (_b = params.network) !== null && _b !== void 0 ? _b : this._currentNetworkType;
+            const network = (_c = params.network) !== null && _c !== void 0 ? _c : this._currentNetworkType;
             if (network)
                 query.set('network', network);
             if (params.billingMode)
@@ -2732,9 +2952,9 @@ class ProjectsApi extends ApiGroup_js_1.default {
                 usd: r.quote.project.costInUSD,
                 spark: r.quote.project.costInSpark,
                 sogni: r.quote.project.costInSogni,
-                estimatedRenderSeconds: (_c = r.benchmark) === null || _c === void 0 ? void 0 : _c.estimatedRenderTimeSec,
-                estimatedTotalSeconds: (_d = r.benchmark) === null || _d === void 0 ? void 0 : _d.estimatedTotalTimeSec,
-                dailyFairUsePct: (_e = r.dailyFairUse) === null || _e === void 0 ? void 0 : _e.pct
+                estimatedRenderSeconds: (_d = r.benchmark) === null || _d === void 0 ? void 0 : _d.estimatedRenderTimeSec,
+                estimatedTotalSeconds: (_e = r.benchmark) === null || _e === void 0 ? void 0 : _e.estimatedTotalTimeSec,
+                dailyFairUsePct: (_f = r.dailyFairUse) === null || _f === void 0 ? void 0 : _f.pct
             };
         });
     }
@@ -2798,7 +3018,8 @@ class ProjectsApi extends ApiGroup_js_1.default {
      *     specific request.
      *   - type: Asset role. Supported values include `'referenceImage'`,
      *     `'referenceImageEnd'`, `'startingImage'`, `'cnImage'`,
-     *     `'contextImage1'`..`'contextImage16'`, `'preview'`, `'complete'`.
+     *     `'contextImage1'`..`'contextImage16'`, `'keyframeImage1'`..`'keyframeImage8'`
+     *     (MiniMax H3 intermediate keyframes), `'preview'`, `'complete'`.
      *   - contentType: Optional MIME type the caller will `PUT` (e.g.
      *     `"image/png"`). Forwarded so the storage layer can pin the
      *     Content-Type on the presigned URL.
@@ -2965,6 +3186,9 @@ class ProjectsApi extends ApiGroup_js_1.default {
      * This table describes the first upload slot only. MiniMax H3 r2v also uses
      * `contextImages`, `referenceVideos`, and `referenceAudios`; callers should
      * read those fields on `VideoProjectParams` for the multi-reference limits.
+     * Every MiniMax H3 id except text-to-video also accepts optional intermediate
+     * `keyframes`, which the table does not list: `isMinimaxH3KeyframeModel()`
+     * tells which ids take them, and `VideoProjectParams.keyframes` gives the rules.
      *
      * @param {string} modelId - The identifier of the video model to retrieve the configuration for.
      * @return {Object} The video asset configuration object where key is asset field and value is