@amaster.ai/pi-video-gen 0.1.2-beta.48

package/dist/providers/kling.js

@@ -0,0 +1,245 @@
+import { readFile } from 'node:fs/promises';
+import { extname } from 'node:path';
+import { AmbiguousSubmitError, httpStatusError, missingKeyError, networkError, RemoteTaskNotFoundError, safeBasename, VideoGenError, } from '../errors.js';
+import { requestFingerprint } from './request.js';
+import { CancelledError, downloadFile } from './task.js';
+/**
+ * Kling (Kuaishou) video generation — official Kling API 2.0.
+ *
+ *   POST {baseUrl}/text-to-video/{model}          { prompt, settings, options }
+ *   POST {baseUrl}/image-to-video/{model}         { contents, settings, options }
+ *   GET  {baseUrl}/tasks?task_ids={id}            → data[0].status / outputs[].url
+ *
+ * Verified against the official docs (kling.ai/document-api, 2026-07):
+ * - Auth: `Authorization: Bearer {apiKey}` — the older JWT ak/sk scheme is legacy.
+ * - The model lives in the PATH (`kling-3.0-turbo`, `kling-3.0`), not the body.
+ * - t2v takes a plain `prompt` string; i2v takes a `contents` array
+ *   (prompt + first_frame [+ last_frame]). i2v follows the frame's ratio, so
+ *   aspect_ratio is t2v-only.
+ * - `options.external_task_id` is a client-provided, account-unique id that is
+ *   QUERYABLE (GET /tasks?external_task_ids=…) — we set it to our request
+ *   fingerprint, so an ambiguous submit failure can be resolved by lookup
+ *   instead of blindly resubmitting a paid task. See recoverByExternalId().
+ * - Kling 3.0 (Omni) adds last_frame, audio: "native"|"off", and 4k; the 3.0
+ *   Turbo is first-frame-only and silent.
+ * - Default base is api-singapore.klingai.com (the documented current domain);
+ *   China-region accounts can point baseUrl at their regional endpoint.
+ */
+export const KLING_DEFAULT_BASE_URL = 'https://api-singapore.klingai.com';
+const MIME_BY_EXT = {
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+};
+async function imageFileToDataUri(path) {
+    const mime = MIME_BY_EXT[extname(path).toLowerCase()];
+    if (!mime) {
+        throw new VideoGenError(`Reference image must be png/jpg (Kling accepts no webp): ${safeBasename(path)}`, 'kling: unsupported image extension');
+    }
+    let bytes;
+    try {
+        bytes = await readFile(path);
+    }
+    catch {
+        throw new VideoGenError(`Reference image is not readable: ${safeBasename(path)}`, 'kling: image unreadable');
+    }
+    return `data:${mime};base64,${bytes.toString('base64')}`;
+}
+/**
+ * Shared ambiguous-outcome resolver with THREE honest results:
+ * - found: the task exists — adopt its handle (no double billing);
+ * - not-found: lookup CONFIRMED nothing was created — safe to retry;
+ * - unknown: lookup itself failed/timed out — a paid task MAY exist;
+ *   the message must warn, not reassure. On user-cancel the same
+ *   distinction applies instead of a bare CancelledError.
+ */
+async function resolveAmbiguous(provider, fp, taskType, fetchImpl, signal) {
+    const r = await tryRecoverByExternalId(provider, fp, taskType, fetchImpl);
+    if (r.outcome === 'found')
+        return r.handle;
+    if (signal?.aborted) {
+        if (r.outcome === 'not-found')
+            throw new CancelledError();
+        throw new AmbiguousSubmitError('Cancelled before we could verify whether the task was created. A paid task MAY exist — check the Kling console for this external id before retrying, or you may be billed twice.', 'kling submit: aborted, recovery unknown');
+    }
+    if (r.outcome === 'not-found') {
+        throw new VideoGenError('Task creation failed, but a lookup by external id confirmed NO task was created — nothing was billed. Safe to retry once.', 'kling submit: failed, verified not created');
+    }
+    throw new AmbiguousSubmitError('Task creation failed with an ambiguous result and the idempotency lookup could not complete. A paid task MAY exist — check the Kling console before retrying to avoid double billing.', 'kling submit: ambiguous, recovery unknown');
+}
+function checkEnvelope(envelope, action) {
+    if (envelope.code !== 0) {
+        throw new VideoGenError(`Kling ${action} rejected the request (code ${envelope.code ?? 'unknown'}). Check the model name and parameters.`, `kling ${action}: code ${envelope.code ?? 'unknown'}`);
+    }
+    return envelope.data;
+}
+function mapTask(task, handle) {
+    switch (task.status) {
+        case 'submitted':
+            return { phase: 'pending' };
+        case 'processing':
+            return { phase: 'running' };
+        case 'succeeded': {
+            const videoUrl = task.outputs?.find((o) => o.type === 'video')?.url;
+            if (!videoUrl) {
+                throw new VideoGenError('The task succeeded but returned no video URL. Report this with the task id.', 'kling inspect: succeeded without url');
+            }
+            return { phase: 'succeeded', videoUrl };
+        }
+        case 'failed':
+            return { phase: 'failed', message: task.message ?? 'unknown provider error' };
+        default:
+            throw new VideoGenError(`The provider returned an unknown task status. Task id kept for support: ${handle.taskId}.`, 'kling inspect: unknown status');
+    }
+}
+export const klingAdapter = {
+    async submit(provider, remoteModelId, params, fetchImpl, signal) {
+        if (!provider.apiKey)
+            throw missingKeyError('kling', 'KLING_API_KEY', provider.apiKeyPath);
+        const taskType = params.firstFramePath ? 'image-to-video' : 'text-to-video';
+        const fp = requestFingerprint(remoteModelId, params);
+        const settings = {};
+        if (params.resolution)
+            settings.resolution = params.resolution;
+        if (params.durationSec != null)
+            settings.duration = params.durationSec;
+        if (params.generateAudio === true)
+            settings.audio = 'native';
+        const body = {
+            settings,
+            options: { external_task_id: fp, watermark_info: { enabled: false } },
+        };
+        if (taskType === 'text-to-video') {
+            body.prompt = params.prompt;
+            if (params.aspectRatio)
+                settings.aspect_ratio = params.aspectRatio;
+        }
+        else {
+            const contents = [{ type: 'prompt', text: params.prompt }];
+            contents.push({ type: 'first_frame', url: await imageFileToDataUri(params.firstFramePath) });
+            if (params.lastFramePath) {
+                contents.push({ type: 'last_frame', url: await imageFileToDataUri(params.lastFramePath) });
+            }
+            body.contents = contents;
+        }
+        let res;
+        try {
+            res = await fetchImpl(`${provider.baseUrl}/${taskType}/${remoteModelId}`, {
+                method: 'POST',
+                headers: {
+                    authorization: `Bearer ${provider.apiKey}`,
+                    'content-type': 'application/json',
+                },
+                body: JSON.stringify(body),
+                signal: signal ?? null,
+            });
+        }
+        catch {
+            // Network failure = ambiguous. Recover via external-id lookup (fresh
+            // timeout, never the caller's possibly-aborted signal).
+            return resolveAmbiguous(provider, fp, taskType, fetchImpl, signal);
+        }
+        if (!res.ok) {
+            if (res.status >= 500) {
+                return resolveAmbiguous(provider, fp, taskType, fetchImpl, signal);
+            }
+            throw httpStatusError('kling', 'submit', res.status);
+        }
+        // Body read/parse failures are JUST as ambiguous as a dead connection —
+        // the task may already exist. Recover the same way.
+        let taskId;
+        try {
+            const json = (await res.json());
+            taskId = checkEnvelope(json, 'submit').id;
+        }
+        catch (error) {
+            if (error instanceof VideoGenError && error.logSummary.startsWith('kling submit: code'))
+                throw error;
+            return resolveAmbiguous(provider, fp, taskType, fetchImpl, signal);
+        }
+        if (!taskId) {
+            // 2xx but no id: the task MAY exist server-side — this is ambiguous,
+            // not a clean failure, and must park the shot rather than re-submit.
+            throw new AmbiguousSubmitError('The provider accepted the request but returned no task id. Not retrying automatically; check the Kling console.', 'kling submit: no task id');
+        }
+        return {
+            taskId,
+            submittedAt: new Date().toISOString(),
+            requestFingerprint: fp,
+            meta: { taskType },
+        };
+    },
+    async inspect(provider, handle, fetchImpl, signal) {
+        if (!provider.apiKey)
+            throw missingKeyError('kling', 'KLING_API_KEY', provider.apiKeyPath);
+        let res;
+        try {
+            res = await fetchImpl(`${provider.baseUrl}/tasks?task_ids=${encodeURIComponent(handle.taskId)}`, {
+                headers: { authorization: `Bearer ${provider.apiKey}` },
+                signal: signal ?? null,
+            });
+        }
+        catch {
+            throw networkError('kling', 'inspect');
+        }
+        if (!res.ok)
+            throw httpStatusError('kling', 'inspect', res.status);
+        const json = (await res.json());
+        const tasks = checkEnvelope(json, 'inspect');
+        const task = Array.isArray(tasks) ? tasks.find((t) => t.id === handle.taskId) : undefined;
+        if (!task) {
+            throw new RemoteTaskNotFoundError(`Task ${handle.taskId} not found on the provider (results are cleared after 30 days). Start a fresh generation.`, 'kling inspect: task not found');
+        }
+        return mapTask(task, handle);
+    },
+    async downloadTo(_provider, _handle, videoUrl, destPath, fetchImpl, signal) {
+        return downloadFile({ url: videoUrl, destPath, fetchImpl, signal });
+    },
+    // cancel: no documented task-cancellation endpoint on Kling API 2.0.
+};
+/**
+ * Best-effort idempotency lookup with its OWN short timeout — the caller's
+ * signal may already be aborted (that's why we're here), and the lookup must
+ * still run to tell whether a paid task exists. Returns null on any failure;
+ * callers decide between CancelledError (user aborted) and ambiguous error.
+ */
+/** Exported for tests: the lookup deadline is injectable (default 10s). */
+export async function tryRecoverByExternalId(provider, fp, taskType, fetchImpl, timeoutMs = 10_000) {
+    try {
+        const res = await fetchImpl(`${provider.baseUrl}/tasks?external_task_ids=${fp}`, {
+            headers: { authorization: `Bearer ${provider.apiKey}` },
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        if (!res.ok)
+            return { outcome: 'unknown' };
+        let json;
+        try {
+            json = (await res.json());
+        }
+        catch {
+            return { outcome: 'unknown' };
+        }
+        // STRICT shape: a provider-side error envelope ({code: 50001, message:
+        // "busy"}) or a data payload that is not a task list tells us NOTHING
+        // about task existence — it must read as 'unknown', never as the
+        // confident 'not-found' (which green-lights a retry).
+        if (json.code !== 0 || !Array.isArray(json.data))
+            return { outcome: 'unknown' };
+        const existing = json.data.find((t) => t.id);
+        if (!existing?.id)
+            return { outcome: 'not-found' };
+        return {
+            outcome: 'found',
+            handle: {
+                taskId: existing.id,
+                submittedAt: new Date().toISOString(),
+                requestFingerprint: fp,
+                meta: { taskType },
+            },
+        };
+    }
+    catch {
+        return { outcome: 'unknown' };
+    }
+}
+//# sourceMappingURL=kling.js.map

package/dist/providers/kling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kling.js","sourceRoot":"","sources":["../../src/providers/kling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,uBAAuB,EACvB,YAAY,EACZ,aAAa,GACd,MAAM,cAAc,CAAC;AAOtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,mCAAmC,CAAC;AAE1E,MAAM,WAAW,GAA2B;IAC1C,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;CACtB,CAAC;AAEF,KAAK,UAAU,kBAAkB,CAAC,IAAY;IAC5C,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACtD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,aAAa,CACrB,4DAA4D,YAAY,CAAC,IAAI,CAAC,EAAE,EAChF,oCAAoC,CACrC,CAAC;IACJ,CAAC;IACD,IAAI,KAAa,CAAC;IAClB,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,aAAa,CACrB,oCAAoC,YAAY,CAAC,IAAI,CAAC,EAAE,EACxD,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,IAAI,WAAW,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;AAC3D,CAAC;AAOD;;;;;;;GAOG;AACH,KAAK,UAAU,gBAAgB,CAC7B,QAA0D,EAC1D,EAAU,EACV,QAAgB,EAChB,SAAuB,EACvB,MAAoB;IAEpB,MAAM,CAAC,GAAG,MAAM,sBAAsB,CAAC,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC1E,IAAI,CAAC,CAAC,OAAO,KAAK,OAAO;QAAE,OAAO,CAAC,CAAC,MAAM,CAAC;IAC3C,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;QACpB,IAAI,CAAC,CAAC,OAAO,KAAK,WAAW;YAAE,MAAM,IAAI,cAAc,EAAE,CAAC;QAC1D,MAAM,IAAI,oBAAoB,CAC5B,kLAAkL,EAClL,yCAAyC,CAC1C,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;QAC9B,MAAM,IAAI,aAAa,CACrB,2HAA2H,EAC3H,4CAA4C,CAC7C,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,oBAAoB,CAC5B,uLAAuL,EACvL,2CAA2C,CAC5C,CAAC;AACJ,CAAC;AAID,SAAS,aAAa,CAAI,QAA0B,EAAE,MAAc;IAClE,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,aAAa,CACrB,SAAS,MAAM,+BAA+B,QAAQ,CAAC,IAAI,IAAI,SAAS,yCAAyC,EACjH,SAAS,MAAM,UAAU,QAAQ,CAAC,IAAI,IAAI,SAAS,EAAE,CACtD,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC,IAAS,CAAC;AAC5B,CAAC;AASD,SAAS,OAAO,CAAC,IAAe,EAAE,MAAwB;IACxD,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,WAAW;YACd,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAC9B,KAAK,YAAY;YACf,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAC9B,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,EAAE,GAAG,CAAC;YACpE,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,aAAa,CACrB,6EAA6E,EAC7E,sCAAsC,CACvC,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;QAC1C,CAAC;QACD,KAAK,QAAQ;YACX,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,wBAAwB,EAAE,CAAC;QAChF;YACE,MAAM,IAAI,aAAa,CACrB,2EAA2E,MAAM,CAAC,MAAM,GAAG,EAC3F,+BAA+B,CAChC,CAAC;IACN,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAyB;IAChD,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;QAC7D,IAAI,CAAC,QAAQ,CAAC,MAAM;YAAE,MAAM,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;QAE3F,MAAM,QAAQ,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,eAAe,CAAC;QAC5E,MAAM,EAAE,GAAG,kBAAkB,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAErD,MAAM,QAAQ,GAA4B,EAAE,CAAC;QAC7C,IAAI,MAAM,CAAC,UAAU;YAAE,QAAQ,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QAC/D,IAAI,MAAM,CAAC,WAAW,IAAI,IAAI;YAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC;QACvE,IAAI,MAAM,CAAC,aAAa,KAAK,IAAI;YAAE,QAAQ,CAAC,KAAK,GAAG,QAAQ,CAAC;QAE7D,MAAM,IAAI,GAA4B;YACpC,QAAQ;YACR,OAAO,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;SACtE,CAAC;QACF,IAAI,QAAQ,KAAK,eAAe,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAC5B,IAAI,MAAM,CAAC,WAAW;gBAAE,QAAQ,CAAC,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC;QACrE,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAA8B,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YACtF,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC,MAAM,CAAC,cAAe,CAAC,EAAE,CAAC,CAAC;YAC9F,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;gBACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;YAC7F,CAAC;YACD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC3B,CAAC;QAED,IAAI,GAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,QAAQ,CAAC,OAAO,IAAI,QAAQ,IAAI,aAAa,EAAE,EAAE;gBACxE,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,aAAa,EAAE,UAAU,QAAQ,CAAC,MAAM,EAAE;oBAC1C,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;gBAC1B,MAAM,EAAE,MAAM,IAAI,IAAI;aACvB,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,qEAAqE;YACrE,wDAAwD;YACxD,OAAO,gBAAgB,CAAC,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;gBACtB,OAAO,gBAAgB,CAAC,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;YACrE,CAAC;YACD,MAAM,eAAe,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACvD,CAAC;QAED,wEAAwE;QACxE,oDAAoD;QACpD,IAAI,MAA0B,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAmC,CAAC;YAClE,MAAM,GAAG,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,aAAa,IAAI,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC,oBAAoB,CAAC;gBACrF,MAAM,KAAK,CAAC;YACd,OAAO,gBAAgB,CAAC,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,qEAAqE;YACrE,qEAAqE;YACrE,MAAM,IAAI,oBAAoB,CAC5B,iHAAiH,EACjH,0BAA0B,CAC3B,CAAC;QACJ,CAAC;QACD,OAAO;YACL,MAAM;YACN,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACrC,kBAAkB,EAAE,EAAE;YACtB,IAAI,EAAE,EAAE,QAAQ,EAAE;SACnB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;QAC/C,IAAI,CAAC,QAAQ,CAAC,MAAM;YAAE,MAAM,eAAe,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;QAE3F,IAAI,GAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,SAAS,CACnB,GAAG,QAAQ,CAAC,OAAO,mBAAmB,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EACzE;gBACE,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,QAAQ,CAAC,MAAM,EAAE,EAAE;gBACvD,MAAM,EAAE,MAAM,IAAI,IAAI;aACvB,CACF,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,YAAY,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACzC,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,eAAe,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAEnE,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA+B,CAAC;QAC9D,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1F,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,uBAAuB,CAC/B,QAAQ,MAAM,CAAC,MAAM,2FAA2F,EAChH,+BAA+B,CAChC,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,UAAU,CACd,SAAS,EACT,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM;QAEN,OAAO,YAAY,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,qEAAqE;CACtE,CAAC;AAEF;;;;;GAKG;AACH,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,QAA0D,EAC1D,EAAU,EACV,QAAgB,EAChB,SAAuB,EACvB,SAAS,GAAG,MAAM;IAElB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,QAAQ,CAAC,OAAO,4BAA4B,EAAE,EAAE,EAAE;YAC/E,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,QAAQ,CAAC,MAAO,EAAE,EAAE;YACxD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;SACvC,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;QAC3C,IAAI,IAAgC,CAAC;QACrC,IAAI,CAAC;YACH,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA+B,CAAC;QAC1D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;QAChC,CAAC;QACD,uEAAuE;QACvE,sEAAsE;QACtE,iEAAiE;QACjE,sDAAsD;QACtD,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;QAChF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,QAAQ,EAAE,EAAE;YAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;QACnD,OAAO;YACL,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE;gBACN,MAAM,EAAE,QAAQ,CAAC,EAAE;gBACnB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACrC,kBAAkB,EAAE,EAAE;gBACtB,IAAI,EAAE,EAAE,QAAQ,EAAE;aACnB;SACF,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAChC,CAAC;AACH,CAAC"}

package/dist/providers/models.d.ts

@@ -0,0 +1,16 @@
+import type { BuiltInVideoModel } from '../types.js';
+/**
+ * Built-in video model registry. Only models with a published request contract
+ * belong here — no placeholders for announced-but-undocumented models
+ * (Seedance 2.5 stays on the roadmap until its API ID and parameter contract
+ * are officially published).
+ *
+ * Capability values reflect provider documentation as of 2026-07 and are
+ * PENDING live verification (run /video-gen doctor + a small paid clip):
+ * - Seedance 2.0: https://www.volcengine.com/docs/82379/1520757
+ * - HappyHorse: https://help.aliyun.com/zh/model-studio/happyhorse-text-to-video-api-reference
+ */
+export declare const BUILT_IN_VIDEO_MODELS: BuiltInVideoModel[];
+/** Resolve a model id or alias against the built-in registry. */
+export declare function findBuiltInModel(idOrAlias: string): BuiltInVideoModel | undefined;
+//# sourceMappingURL=models.d.ts.map

package/dist/providers/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../../src/providers/models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,EAAE,iBAAiB,EAsIpD,CAAC;AAEF,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAKjF"}

package/dist/providers/models.js

@@ -0,0 +1,152 @@
+/**
+ * Built-in video model registry. Only models with a published request contract
+ * belong here — no placeholders for announced-but-undocumented models
+ * (Seedance 2.5 stays on the roadmap until its API ID and parameter contract
+ * are officially published).
+ *
+ * Capability values reflect provider documentation as of 2026-07 and are
+ * PENDING live verification (run /video-gen doctor + a small paid clip):
+ * - Seedance 2.0: https://www.volcengine.com/docs/82379/1520757
+ * - HappyHorse: https://help.aliyun.com/zh/model-studio/happyhorse-text-to-video-api-reference
+ */
+export const BUILT_IN_VIDEO_MODELS = [
+    {
+        id: 'doubao-seedance-2-0-260128',
+        aliases: ['seedance', 'seedance-2.0', 'seedance-std'],
+        provider: 'ark',
+        capabilities: {
+            maxReferenceImages: 9,
+            durations: [4, 15],
+            resolutions: ['480p', '720p', '1080p'],
+            aspectRatios: ['16:9', '4:3', '1:1', '3:4', '9:16', '21:9', 'adaptive'],
+            nativeAudio: true,
+            supportsFirstLastFrame: true,
+        },
+        defaultResolution: '1080p',
+        defaultAspectRatio: '16:9',
+        defaultDurationSec: 5,
+    },
+    {
+        id: 'doubao-seedance-2-0-fast-260128',
+        aliases: ['seedance-fast'],
+        provider: 'ark',
+        capabilities: {
+            maxReferenceImages: 9,
+            durations: [4, 15],
+            resolutions: ['480p', '720p'],
+            aspectRatios: ['16:9', '4:3', '1:1', '3:4', '9:16', '21:9', 'adaptive'],
+            nativeAudio: true,
+            supportsFirstLastFrame: true,
+        },
+        defaultResolution: '720p',
+        defaultAspectRatio: '16:9',
+        defaultDurationSec: 5,
+    },
+    {
+        id: 'happyhorse-1.1',
+        aliases: ['happyhorse', 'happyhorse-1.1'],
+        provider: 'dashscope',
+        capabilities: {
+            maxReferenceImages: 9,
+            durations: [3, 15],
+            resolutions: ['720P', '1080P'],
+            aspectRatios: ['16:9', '9:16', '1:1', '4:3', '3:4', '4:5', '5:4', '9:21', '21:9'],
+            nativeAudio: false,
+            supportsFirstLastFrame: false,
+        },
+        defaultResolution: '1080P',
+        defaultAspectRatio: '16:9',
+        defaultDurationSec: 5,
+    },
+    {
+        id: 'happyhorse-1.0',
+        aliases: ['happyhorse-1.0'],
+        provider: 'dashscope',
+        capabilities: {
+            maxReferenceImages: 9,
+            durations: [3, 15],
+            resolutions: ['720P', '1080P'],
+            aspectRatios: ['16:9', '9:16', '1:1', '4:3', '3:4', '4:5', '5:4', '9:21', '21:9'],
+            nativeAudio: false,
+            supportsFirstLastFrame: false,
+        },
+        defaultResolution: '1080P',
+        defaultAspectRatio: '16:9',
+        defaultDurationSec: 5,
+    },
+    {
+        // Verified against kling.ai/document-api (2026-07): model id is the URL
+        // path segment. Turbo: first-frame only, silent, 720p/1080p.
+        id: 'kling-3.0-turbo',
+        aliases: ['kling', 'kling-turbo', 'kling-v3-turbo'],
+        provider: 'kling',
+        capabilities: {
+            maxReferenceImages: 1,
+            durations: [3, 15],
+            resolutions: ['720p', '1080p'],
+            aspectRatios: ['16:9', '9:16', '1:1'],
+            nativeAudio: false,
+            supportsFirstLastFrame: false,
+        },
+        defaultResolution: '1080p',
+        defaultAspectRatio: '16:9',
+        defaultDurationSec: 5,
+    },
+    {
+        // Kling 3.0 "Omni": last_frame, native audio, 4k.
+        id: 'kling-3.0',
+        aliases: ['kling-omni', 'kling-v3-omni', 'kling-3.0-omni'],
+        provider: 'kling',
+        capabilities: {
+            maxReferenceImages: 2,
+            durations: [3, 15],
+            resolutions: ['720p', '1080p', '4k'],
+            aspectRatios: ['16:9', '9:16', '1:1'],
+            nativeAudio: true,
+            supportsFirstLastFrame: true,
+        },
+        defaultResolution: '1080p',
+        defaultAspectRatio: '16:9',
+        defaultDurationSec: 5,
+    },
+    {
+        // Per OpenRouter docs example (2026-07): 5s/8s, 720p, 16:9, audio, flf.
+        // Live list: GET https://openrouter.ai/api/v1/videos/models
+        id: 'google/veo-3.1',
+        aliases: ['veo', 'veo-3.1'],
+        provider: 'openrouter',
+        capabilities: {
+            maxReferenceImages: 2,
+            durations: [5, 8],
+            resolutions: ['720p'],
+            aspectRatios: ['16:9'],
+            nativeAudio: true,
+            supportsFirstLastFrame: true,
+        },
+        defaultResolution: '720p',
+        defaultAspectRatio: '16:9',
+        defaultDurationSec: 8,
+    },
+    {
+        id: 'doubao-seedance-2-0-mini-260615',
+        aliases: ['seedance-mini'],
+        provider: 'ark',
+        capabilities: {
+            maxReferenceImages: 9,
+            durations: [4, 15],
+            resolutions: ['480p', '720p'],
+            aspectRatios: ['16:9', '4:3', '1:1', '3:4', '9:16', '21:9', 'adaptive'],
+            nativeAudio: true,
+            supportsFirstLastFrame: true,
+        },
+        defaultResolution: '720p',
+        defaultAspectRatio: '16:9',
+        defaultDurationSec: 5,
+    },
+];
+/** Resolve a model id or alias against the built-in registry. */
+export function findBuiltInModel(idOrAlias) {
+    const needle = idOrAlias.trim().toLowerCase();
+    return BUILT_IN_VIDEO_MODELS.find((m) => m.id.toLowerCase() === needle || m.aliases.some((a) => a.toLowerCase() === needle));
+}
+//# sourceMappingURL=models.js.map

package/dist/providers/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../src/providers/models.ts"],"names":[],"mappings":"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"}

package/dist/providers/newapi.d.ts

@@ -0,0 +1,3 @@
+import type { VideoProviderAdapter } from '../types.js';
+export declare const newapiAdapter: VideoProviderAdapter;
+//# sourceMappingURL=newapi.d.ts.map

package/dist/providers/newapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"newapi.d.ts","sourceRoot":"","sources":["../../src/providers/newapi.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAIV,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAsGrB,eAAO,MAAM,aAAa,EAAE,oBA2I3B,CAAC"}

package/dist/providers/newapi.js

@@ -0,0 +1,203 @@
+import { readFile } from 'node:fs/promises';
+import { extname } from 'node:path';
+import { AmbiguousSubmitError, httpStatusError, missingKeyError, networkError, safeBasename, VideoGenError, } from '../errors.js';
+import { requestFingerprint } from './request.js';
+import { downloadFile } from './task.js';
+/**
+ * NewAPI video generation format (self-hosted OpenAI-compatible relay:
+ * Kling / Jimeng / Gemini / Vidu channels behind one shape).
+ *
+ *   POST {baseUrl}/v1/video/generations           → 201 { id, task_id, status }
+ *   GET  {baseUrl}/v1/video/generations/{task_id} → { status, url, error }
+ *
+ * Verified against the official docs (newapi.ai/zh/docs/api/ai-model/videos,
+ * 2026-07 — createvideogeneration + getvideogeneration):
+ * - NewAPI is self-hosted, so this wire format has NO default endpoint —
+ *   baseUrl is mandatory and the config layer rejects resolution without it.
+ *   Both the server root ("https://host") and the OpenAI-style
+ *   "https://host/v1" forms are accepted (a trailing /v1 is normalized away).
+ * - Top-level params per the docs: model/prompt (required), duration, fps,
+ *   width/height, image (URL or Base64), metadata, n, response_format, seed,
+ *   user. Everything channel-specific rides in `metadata` — following the
+ *   doc examples we send aspect_ratio + resolution (Jimeng/Vidu style),
+ *   image_tail (Kling style) and image_urls (Jimeng style) there.
+ * - Submit returns BOTH `id` and `task_id`; the query endpoint keys on
+ *   `task_id`, so we prefer it and fall back to `id`.
+ * - Query status enum: queued | processing | in_progress | succeeded |
+ *   failed; the mp4 URL arrives in `url` on success.
+ * - No audio toggle and no client idempotency key are documented: a
+ *   capability-driven generateAudio is NOT forwarded, and ambiguous submit
+ *   failures get the "check the console before retrying" treatment (same as
+ *   Ark/OpenRouter).
+ *
+ * TWO response shapes exist in the wild (verified against a live NewAPI
+ * relay, 2026-07): channels proxied in the documented OpenAI-compatible way
+ * answer FLAT ({status: "succeeded", url, error}), while channels routed
+ * through NewAPI's task framework (Kling/Jimeng/Seedance-as-task) answer
+ * with the framework ENVELOPE:
+ *
+ *   {code: "success", message,
+ *    data: {task_id, status: "IN_PROGRESS"|"SUCCESS"|"FAILURE"|…, progress,
+ *           fail_reason, result_url, data: {<raw upstream response>}}}
+ *
+ * i.e. uppercase framework statuses, the mp4 in `result_url` (or nested in
+ * the upstream payload at `data.data.content.video_url` for Ark upstreams),
+ * and the failure text in `fail_reason`. unwrapTaskRecord() peels the
+ * envelope once and the status mapping is case-insensitive, so both shapes
+ * parse identically.
+ */
+const MIME_BY_EXT = {
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.webp': 'image/webp',
+};
+async function imageFileToDataUri(path) {
+    const mime = MIME_BY_EXT[extname(path).toLowerCase()];
+    if (!mime) {
+        throw new VideoGenError(`Reference image must be png/jpg/webp: ${safeBasename(path)}`, 'newapi: unsupported image extension');
+    }
+    let bytes;
+    try {
+        bytes = await readFile(path);
+    }
+    catch {
+        throw new VideoGenError(`Reference image is not readable: ${safeBasename(path)}`, 'newapi: image unreadable');
+    }
+    return `data:${mime};base64,${bytes.toString('base64')}`;
+}
+/** Server root for the API paths: trims trailing slashes and one trailing /v1. */
+function serverRoot(baseUrl) {
+    return baseUrl.replace(/\/+$/, '').replace(/\/v1$/i, '');
+}
+/**
+ * Peel the NewAPI task-framework envelope `{code, message, data}` ONE layer
+ * when present, returning the bare task record. Flat documented responses
+ * (and the nested upstream payload at `record.data`, which must NOT be
+ * peeled) pass through untouched: only a root `code` alongside an object
+ * `data` marks the envelope.
+ */
+function unwrapTaskRecord(json) {
+    const data = json.data;
+    if (json.code !== undefined && data != null && typeof data === 'object' && !Array.isArray(data)) {
+        return data;
+    }
+    return json;
+}
+function ambiguousSubmitError() {
+    return new AmbiguousSubmitError('Task creation failed with an ambiguous result (network error or server 5xx). The provider MAY have created a paid task — check the NewAPI logs/console before retrying to avoid double billing.', 'newapi submit: ambiguous outcome');
+}
+export const newapiAdapter = {
+    async submit(provider, remoteModelId, params, fetchImpl, signal) {
+        if (!provider.apiKey)
+            throw missingKeyError('newapi', 'NEWAPI_API_KEY', provider.apiKeyPath);
+        const body = { model: remoteModelId, prompt: params.prompt };
+        if (params.durationSec != null)
+            body.duration = params.durationSec;
+        if (params.firstFramePath) {
+            body.image = await imageFileToDataUri(params.firstFramePath);
+        }
+        const metadata = {};
+        if (params.aspectRatio)
+            metadata.aspect_ratio = params.aspectRatio;
+        if (params.resolution)
+            metadata.resolution = params.resolution;
+        if (params.lastFramePath) {
+            metadata.image_tail = await imageFileToDataUri(params.lastFramePath);
+        }
+        if (params.referenceImagePaths?.length) {
+            metadata.image_urls = await Promise.all(params.referenceImagePaths.map((path) => imageFileToDataUri(path)));
+        }
+        if (Object.keys(metadata).length > 0)
+            body.metadata = metadata;
+        let res;
+        try {
+            res = await fetchImpl(`${serverRoot(provider.baseUrl)}/v1/video/generations`, {
+                method: 'POST',
+                headers: {
+                    authorization: `Bearer ${provider.apiKey}`,
+                    'content-type': 'application/json',
+                },
+                body: JSON.stringify(body),
+                signal: signal ?? null,
+            });
+        }
+        catch {
+            throw ambiguousSubmitError();
+        }
+        if (!res.ok) {
+            if (res.status >= 500)
+                throw ambiguousSubmitError();
+            throw httpStatusError('newapi', 'submit', res.status);
+        }
+        let taskId;
+        try {
+            const rec = unwrapTaskRecord((await res.json()));
+            taskId = (rec.task_id ?? rec.id);
+        }
+        catch {
+            throw ambiguousSubmitError();
+        }
+        if (!taskId) {
+            // 2xx but no id: the task MAY exist server-side — this is ambiguous,
+            // not a clean failure, and must park the shot rather than re-submit.
+            throw new AmbiguousSubmitError('The provider accepted the request but returned no task id. Not retrying automatically; check the NewAPI logs/console.', 'newapi submit: no task id');
+        }
+        return {
+            taskId,
+            submittedAt: new Date().toISOString(),
+            requestFingerprint: requestFingerprint(remoteModelId, params),
+        };
+    },
+    async inspect(provider, handle, fetchImpl, signal) {
+        if (!provider.apiKey)
+            throw missingKeyError('newapi', 'NEWAPI_API_KEY', provider.apiKeyPath);
+        let res;
+        try {
+            res = await fetchImpl(`${serverRoot(provider.baseUrl)}/v1/video/generations/${encodeURIComponent(handle.taskId)}`, {
+                headers: { authorization: `Bearer ${provider.apiKey}` },
+                signal: signal ?? null,
+            });
+        }
+        catch {
+            throw networkError('newapi', 'inspect');
+        }
+        if (!res.ok)
+            throw httpStatusError('newapi', 'inspect', res.status);
+        const rec = unwrapTaskRecord((await res.json()));
+        // Case-insensitive: flat form uses lowercase, the task framework UPPERCASE.
+        switch (rec.status?.toUpperCase()) {
+            case 'QUEUED':
+            case 'SUBMITTED':
+                return { phase: 'pending' };
+            case 'PROCESSING':
+            case 'IN_PROGRESS':
+                return { phase: 'running' };
+            case 'SUCCEEDED':
+            case 'SUCCESS':
+            case 'COMPLETED': {
+                const videoUrl = rec.result_url ?? rec.url ?? rec.data?.content?.video_url;
+                if (!videoUrl) {
+                    throw new VideoGenError('The task succeeded but returned no video URL. Report this with the task id.', 'newapi inspect: succeeded without url');
+                }
+                return { phase: 'succeeded', videoUrl };
+            }
+            case 'FAILED':
+            case 'FAILURE':
+            case 'CANCELLED':
+            case 'EXPIRED': {
+                const message = rec.fail_reason ||
+                    (typeof rec.error === 'string' ? rec.error : rec.error?.message) ||
+                    'unknown provider error';
+                return { phase: 'failed', message };
+            }
+            default:
+                throw new VideoGenError(`The provider returned an unknown task status. Task id kept for support: ${handle.taskId}.`, 'newapi inspect: unknown status');
+        }
+    },
+    async downloadTo(_provider, _handle, videoUrl, destPath, fetchImpl, signal) {
+        return downloadFile({ url: videoUrl, destPath, fetchImpl, signal });
+    },
+    // cancel: no documented task-cancellation endpoint in the NewAPI video format.
+};
+//# sourceMappingURL=newapi.js.map