vidspotai-shared 1.0.124 → 1.0.126

package/lib/services/aiGen/providers/kling/kling.service.d.ts

@@ -1,5 +1,6 @@
 import { BaseAiGenProviderService } from "../baseAiGenProvider.service";
 import { CreditUsageParams, VideoGenerationParams, VideoGenerationResult, VideoStatusParams, VideoStatusResult } from "../types";
+import { KlingCreateElementRequest, KlingElementInfo, KlingElementTask } from "./types";
 /**
  * Kling runs TWO auth schemes. Verified against the live API 2026-07-22,
  * re-verified 2026-09-16.
@@ -50,6 +51,13 @@ export declare class KlingService extends BaseAiGenProviderService {
      * Polling likewise goes to checkTurboVideoStatus, never the v1 prober.
      */
     private generateTurboVideo;
+    /**
+     * kling-3.0-omni submit on API 2.0. Single endpoint for every input mix
+     * (t2v / first-last frame / reference images / feature video / base-video
+     * edit) — buildOmni2VideoBody decides the contents[]. Shares Turbo's
+     * envelope, auth and poller.
+     */
+    private generateOmni2Video;
     /**
      * Extend a previously-generated Kling video by ~4-5s. Takes the Kling task id
      * of the source video (must have been generated by this Kling account).
@@ -62,9 +70,17 @@ export declare class KlingService extends BaseAiGenProviderService {
     private generateAvatarVideo;
     private requestWithTimeoutRetry;
     checkVideoStatus(params: VideoStatusParams): Promise<VideoStatusResult>;
+    /** Submit an element-creation task. Returns Kling's task id. */
+    createElement(body: KlingCreateElementRequest): Promise<string>;
+    /** Poll one element-creation task. */
+    getElementTask(taskId: string): Promise<KlingElementTask>;
+    /** Kling's official preset elements (one page; ≤500 per page). */
+    listPresetElements(pageNum?: number, pageSize?: number): Promise<KlingElementInfo[]>;
+    /** Delete a custom element (presets can't be deleted). */
+    deleteElement(elementId: string): Promise<void>;
     /**
      * Pick the credential for the surface being called. The API 2.0 key is
-     * optional in env — only kling-v3.0-turbo needs it — so its absence must not
+     * optional in env — only the API 2.0 models (turbo, 3.0-omni) need it — so its absence must not
      * break the JWT models that make up the rest of the catalog. Failing here
      * (rather than letting Kling return an opaque 401) means the scene fails at
      * SUBMIT with no task id, which our refund policy treats as never-billed →

package/lib/services/aiGen/providers/kling/kling.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kling.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/kling/kling.service.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAyBlB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE7C;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,wBAAwB;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAW;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IASxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkD;IAC9E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmD;;YAWlE,OAAO;IAiCf,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IA+EjC;;;;;;;;OAQG;YACW,kBAAkB;IAgChC;;;;OAIG;YACW,WAAW;YA6BX,iBAAiB;YA6BjB,qBAAqB;YAgCrB,eAAe;YAkDf,mBAAmB;YAgCnB,uBAAuB;IAsI/B,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAiB7E;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAiBxB,cAAc,IAAI,MAAM;IAexB,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM;CAGjD"}
+{"version":3,"file":"kling.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/kling/kling.service.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAChB,gBAAgB,EAMjB,MAAM,SAAS,CAAC;AAoBjB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE7C;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,wBAAwB;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;IAC/D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAW;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;IASxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkD;IAC9E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmD;;YAWlE,OAAO;IAiCf,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAmFjC;;;;;;;;OAQG;YACW,kBAAkB;IAgChC;;;;;OAKG;YACW,kBAAkB;IA4BhC;;;;OAIG;YACW,WAAW;YA6BX,iBAAiB;YA6BjB,qBAAqB;YAgCrB,eAAe;YAkDf,mBAAmB;YAgCnB,uBAAuB;IAsI/B,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAsB7E,gEAAgE;IAC1D,aAAa,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC,MAAM,CAAC;IASrE,sCAAsC;IAChC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQ/D,kEAAkE;IAC5D,kBAAkB,CAAC,OAAO,SAAI,EAAE,QAAQ,SAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAUlF,0DAA0D;IACpD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASrD;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAiBxB,cAAc,IAAI,MAAM;IAexB,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM;CAGjD"}

package/lib/services/aiGen/providers/kling/kling.service.js

@@ -102,6 +102,9 @@ class KlingService extends baseAiGenProvider_service_1.BaseAiGenProviderService
         if (params.modelKey === "kling-v3.0-turbo") {
             return this.generateTurboVideo(params);
         }
+        if (params.modelKey === "kling-v3.0-omni") {
+            return this.generateOmni2Video(params);
+        }
         const modelId = aiModels_1.aiModelConfigs[params.modelKey]?.modelId;
         if (!modelId)
             throw new Error(`Unknown modelKey: ${params.modelKey}`);
@@ -146,6 +149,28 @@ class KlingService extends baseAiGenProvider_service_1.BaseAiGenProviderService
         });
         return { task: task.data.id, status: types_1.EVideoSceneStatus.TRIGGERED };
     }
+    /**
+     * kling-3.0-omni submit on API 2.0. Single endpoint for every input mix
+     * (t2v / first-last frame / reference images / feature video / base-video
+     * edit) — buildOmni2VideoBody decides the contents[]. Shares Turbo's
+     * envelope, auth and poller.
+     */
+    async generateOmni2Video(params) {
+        const modelId = aiModels_1.aiModelConfigs[params.modelKey]?.modelId;
+        if (!modelId)
+            throw new Error(`Unknown modelKey: ${params.modelKey}`);
+        const body = (0, klingRequests_1.buildOmni2VideoBody)(params);
+        const starttime = Date.now();
+        const task = await this.requestWithTimeoutRetry(`/omni-video/${modelId}`, "POST", body, 4, this.generateTimeout, "apiKey");
+        logger_1.logger.info("Kling generateOmni2Video submitted", {
+            modelKey: params.modelKey,
+            modelId,
+            contentTypes: body.contents.map((c) => c.type),
+            taskId: task.data.id,
+            durationMs: Date.now() - starttime,
+        });
+        return { task: task.data.id, status: types_1.EVideoSceneStatus.TRIGGERED };
+    }
     /**
      * Extend a previously-generated Kling video by ~4-5s. Takes the Kling task id
      * of the source video (must have been generated by this Kling account).
@@ -368,14 +393,38 @@ class KlingService extends baseAiGenProvider_service_1.BaseAiGenProviderService
         // API 2.0 task — different endpoint, array response, and "succeeded" vs
         // v1's "succeed". The v1 prober would 404 down its whole endpoint list and
         // report the task missing.
-        if (params.modelKey === "kling-v3.0-turbo") {
+        if (params.modelKey === "kling-v3.0-turbo" || params.modelKey === "kling-v3.0-omni") {
             return (0, klingStatus_1.checkTurboVideoStatus)(deps, params);
         }
         return (0, klingStatus_1.checkRegularVideoStatus)(deps, params);
     }
+    // ─── Element Library ──────────────────────────────────────────────────
+    // Same API key (and therefore the same Kling account) as kling-v3.0-omni,
+    // so element ids created here resolve in Omni generations. Ownership per
+    // end user is enforced one level up (KlingElementLibrary).
+    /** Submit an element-creation task. Returns Kling's task id. */
+    async createElement(body) {
+        const res = await this.request("/v1/general/advanced-custom-elements", "POST", body);
+        return unwrapKlingEnvelope(res, "create element").task_id;
+    }
+    /** Poll one element-creation task. */
+    async getElementTask(taskId) {
+        const res = await this.requestWithTimeoutRetry(`/v1/general/advanced-custom-elements/${encodeURIComponent(taskId)}`, "GET");
+        return unwrapKlingEnvelope(res, "query element");
+    }
+    /** Kling's official preset elements (one page; ≤500 per page). */
+    async listPresetElements(pageNum = 1, pageSize = 500) {
+        const res = await this.requestWithTimeoutRetry(`/v1/general/advanced-presets-elements?pageNum=${pageNum}&pageSize=${pageSize}`, "GET");
+        return unwrapKlingEnvelope(res, "list preset elements").flatMap((t) => t.task_result?.elements ?? []);
+    }
+    /** Delete a custom element (presets can't be deleted). */
+    async deleteElement(elementId) {
+        const res = await this.request("/v1/general/delete-advanced-elements", "POST", { element_id: elementId });
+        unwrapKlingEnvelope(res, "delete element");
+    }
     /**
      * Pick the credential for the surface being called. The API 2.0 key is
-     * optional in env — only kling-v3.0-turbo needs it — so its absence must not
+     * optional in env — only the API 2.0 models (turbo, 3.0-omni) need it — so its absence must not
      * break the JWT models that make up the rest of the catalog. Failing here
      * (rather than letting Kling return an opaque 401) means the scene fails at
      * SUBMIT with no task id, which our refund policy treats as never-billed →
@@ -387,7 +436,7 @@ class KlingService extends baseAiGenProvider_service_1.BaseAiGenProviderService
         const apiKey = process.env.KLING_API_KEY;
         if (!apiKey) {
             // Operator detail goes to Loki/Slack; the user sees only the safe copy.
-            logger_1.logger.error("KLING_API_KEY is not set — Kling API 2.0 models (kling-v3.0-turbo) need a console-issued API key from https://kling.ai/dev/api-key. The legacy AK/SK JWT is rejected by that surface with HTTP 401 code 1002.");
+            logger_1.logger.error("KLING_API_KEY is not set — Kling API 2.0 models (kling-v3.0-turbo, kling-v3.0-omni) need a console-issued API key from https://kling.ai/dev/api-key. The legacy AK/SK JWT is rejected by that surface with HTTP 401 code 1002.");
             throw new errors_1.UserFacingError("This model is temporarily unavailable. Please pick another model.", errors_1.USER_FACING_ERROR_CODES.PROVIDER_AUTH_ERROR);
         }
         return apiKey;
@@ -409,3 +458,10 @@ class KlingService extends baseAiGenProvider_service_1.BaseAiGenProviderService
     }
 }
 exports.KlingService = KlingService;
+/** Kling answers HTTP 200 with a non-zero `code` for request-level errors. */
+function unwrapKlingEnvelope(res, what) {
+    if (res.code !== 0) {
+        throw new errors_1.UserFacingError(`Kling couldn't ${what}: ${res.message || `code ${res.code}`}`, errors_1.USER_FACING_ERROR_CODES.CAPABILITY_MISMATCH);
+    }
+    return res.data;
+}

package/lib/services/aiGen/providers/kling/klingCredits.d.ts

@@ -5,5 +5,5 @@ import { CreditUsageParams } from "../types";
  * (per-second, 5s-rounded), v2.6 (audio/noAudio tier table), and the base
  * table with deferred I2V / generate_audio upcharges.
  */
-export declare function getKlingCreditUsed({ modelKey, mode, duration, multiClip, audio, inputType, }: CreditUsageParams): number;
+export declare function getKlingCreditUsed({ modelKey, mode: requestedMode, duration, multiClip, audio, inputType, resolution, }: CreditUsageParams): number;
 //# sourceMappingURL=klingCredits.d.ts.map

package/lib/services/aiGen/providers/kling/klingCredits.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"klingCredits.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/kling/klingCredits.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,IAA8B,EAC9B,QAAY,EACZ,SAAiB,EACjB,KAAa,EACb,SAAS,GACV,EAAE,iBAAiB,GAAG,MAAM,CAoE5B"}
+{"version":3,"file":"klingCredits.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/kling/klingCredits.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAG7C;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,IAAI,EAAE,aAAa,EACnB,QAAY,EACZ,SAAiB,EACjB,KAAa,EACb,SAAS,EACT,UAAU,GACX,EAAE,iBAAiB,GAAG,MAAM,CAuF5B"}

package/lib/services/aiGen/providers/kling/klingCredits.js

@@ -5,15 +5,20 @@ const aiModels_1 = require("../../../../globals/aiModels");
 const logger_1 = require("../../../../utils/logger");
 const helpers_1 = require("../../../../utils/helpers");
 const types_1 = require("../../types");
+const klingRequests_1 = require("./klingRequests");
 /**
  * Kling credit calculation. Pure (config lookup + arithmetic) — broken out of
  * KlingService.getCreditUsed. Handles the three pricing shapes: avatar
  * (per-second, 5s-rounded), v2.6 (audio/noAudio tier table), and the base
  * table with deferred I2V / generate_audio upcharges.
  */
-function getKlingCreditUsed({ modelKey, mode = types_1.EVideoMode.PROFESSIONAL, duration = 5, multiClip = false, audio = false, inputType, }) {
+function getKlingCreditUsed({ modelKey, mode: requestedMode, duration = 5, multiClip = false, audio = false, inputType, resolution, }) {
     const modelConfig = aiModels_1.aiModelConfigs[modelKey];
     const applyFloor = !multiClip;
+    // Legacy default for the table-priced models. kling-3.0-omni reads
+    // `requestedMode` instead: its request builder defaults to 720p, and
+    // billing an unset mode as pro would charge the 1080p rate for a 720p clip.
+    const mode = requestedMode ?? types_1.EVideoMode.PROFESSIONAL;
     // Avatar: per-second pricing based on mode. Kling lipsync bills in
     // 5-second increments (a 7s clip is billed as 10s).
     if (modelKey === "kling-avatar") {
@@ -35,6 +40,19 @@ function getKlingCreditUsed({ modelKey, mode = types_1.EVideoMode.PROFESSIONAL,
             ?? 0.112;
         return (0, helpers_1.getCreditsFromCost)(perSecond * duration, applyFloor);
     }
+    // kling-3.0-omni (API 2.0): per-second, three tiers by video input × native
+    // audio, keyed by the SAME resolution the request builder sends. Any video
+    // input wins over audio: Kling allows no native audio with a video attached.
+    if (modelKey === "kling-v3.0-omni") {
+        const res = (0, klingRequests_1.resolveKlingOmni2Resolution)(resolution, requestedMode);
+        const table = inputType === "video"
+            ? modelConfig?.cost?.videoInputPerSecondByResolution
+            : audio
+                ? modelConfig?.cost?.nativeAudioPerSecondByResolution
+                : modelConfig?.cost?.perSecondByResolution;
+        const perSecond = table?.[res] ?? 0.168;
+        return (0, helpers_1.getCreditsFromCost)(perSecond * duration, applyFloor);
+    }
     // v2.6 splits cost by audio/noAudio tier (audio is 2× upcharge).
     if (modelKey === "kling-v2.6") {
         const branch = audio ? modelConfig?.cost?.audio : modelConfig?.cost?.noAudio;

package/lib/services/aiGen/providers/kling/klingRequests.d.ts

@@ -1,15 +1,19 @@
 import { VideoGenerationParams } from "../types";
-import { KlingAvatarGenerateRequest, KlingImageToVideoRequest, KlingLipSyncRequest, KlingMotionControlRequest, KlingOmniVideoRequest, KlingTurboImageToVideoRequest, KlingTurboTextToVideoRequest, KlingVideoGenerateRequest } from "./types";
+import type { MultiShot } from "../../canonicalAdapters/multiShot.types";
+import { KlingAvatarGenerateRequest, KlingImageToVideoRequest, KlingLipSyncRequest, KlingMotionControlRequest, KlingOmniVideoRequest, KlingOmni2Request, KlingOmni2Resolution, KlingTurboImageToVideoRequest, KlingTurboTextToVideoRequest, KlingVideoGenerateRequest } from "./types";
 /**
- * Pure request-body builders mapping our provider-agnostic
- * VideoGenerationParams onto Kling's per-endpoint request shapes. No I/O —
- * KlingService calls these, then submits the result. Keeping them here makes
- * the per-endpoint field wiring testable in isolation and the service class a
- * thin dispatcher.
+ * Canonical multiShot → Kling 3.0's prompt-encoded storyboard,
+ * "shot 1, 3, words; shot 2, 2, words;" (kling.ai/document-api/api/video/
+ * 3-0-omni/text-to-video and 3-0-turbo/*, fetched 2026-09-29). Each shot is
+ * ≥ 1s and the shot durations must sum to the video duration: caller-supplied
+ * durations are kept when they already satisfy that, otherwise the total is
+ * split evenly (remainder to the earliest shots). Semicolons inside a shot's
+ * text would read as a separator, so they become commas.
  */
+export declare function toKlingShotPrompt(shots: MultiShot, totalDuration: number): string;
 /**
  * text2video / image2video body. Routes by the presence of inputImageUrl and
- * wires the shared optional fields (negative prompt, cfg, camera control,
+ * wires the shared optional fields (negative prompt, cfg, camera direction,
  * audio/sound tier) plus the i2v-only mask / tail-frame fields.
  */
 export declare function buildVideoGenerateRequest(params: VideoGenerationParams, modelId: string): KlingVideoGenerateRequest | KlingImageToVideoRequest;
@@ -42,4 +46,30 @@ export declare function buildLipSyncBody(params: VideoGenerationParams, sessionI
  * an agent-authored scene may carry extras from a prior model.
  */
 export declare function buildTurboVideoBody(params: VideoGenerationParams): KlingTurboTextToVideoRequest | KlingTurboImageToVideoRequest;
+/**
+ * Output resolution for kling-3.0-omni. An explicit `resolution` wins (case-
+ * insensitive, so "4K" works); otherwise our canonical `mode` maps with
+ * Kling's own legacy equivalence (std=720p, pro=1080p, "4k"=4k). Shared with
+ * getKlingCreditUsed so the billed tier is always the requested tier.
+ */
+export declare function resolveKlingOmni2Resolution(resolution: string | undefined, mode: string | undefined): KlingOmni2Resolution;
+/**
+ * kling-3.0-omni body. Canonical params map onto contents[] as:
+ *   inputImageUrl        → first_frame
+ *   lastFrameImageUrl    → last_frame (only together with a first frame)
+ *   referenceImageUrls   → refer_image, ids image_1…image_n
+ *   referenceVideoUrls   → feature_video (style/motion reference), id video_1
+ *   inputVideoUrl        → base_video (the clip to EDIT), id video_1
+ *   klingElements        → element, ids element_1…element_n
+ * The prompt can cite those ids as @image_1 / @video_1 / @element_1.
+ *
+ * Audio: `audio: true` means native sound on a plain generation and "keep
+ * the original track" on a base-video edit. Kling allows no audio at all with
+ * a feature video, so there it is always "off".
+ *
+ * Kling's documented combination rules are enforced here so a bad mix fails
+ * at submit (no task id → full refund) with a readable message, instead of
+ * an opaque provider 400.
+ */
+export declare function buildOmni2VideoBody(params: VideoGenerationParams): KlingOmni2Request;
 //# sourceMappingURL=klingRequests.d.ts.map

package/lib/services/aiGen/providers/kling/klingRequests.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"klingRequests.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/kling/klingRequests.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEjD,OAAO,EAEL,0BAA0B,EAE1B,wBAAwB,EACxB,mBAAmB,EAEnB,yBAAyB,EACzB,qBAAqB,EAErB,6BAA6B,EAI7B,4BAA4B,EAC5B,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AAEjB;;;;;;GAMG;AAEH;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,MAAM,GACd,yBAAyB,GAAG,wBAAwB,CAmDtD;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAC7B,MAAM,EAAE,qBAAqB,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,MAAM,GACd,qBAAqB,CA8CvB;AAED,sEAAsE;AACtE,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,MAAM,GACd,yBAAyB,CAW3B;AAED,iDAAiD;AACjD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,qBAAqB,GAC5B,0BAA0B,CAS5B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,qBAAqB,EAC7B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC5C,mBAAmB,CAgBrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,qBAAqB,GAC5B,4BAA4B,GAAG,6BAA6B,CA+B9D"}
+{"version":3,"file":"klingRequests.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/kling/klingRequests.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,EAEL,0BAA0B,EAE1B,wBAAwB,EACxB,mBAAmB,EAEnB,yBAAyB,EACzB,qBAAqB,EAGrB,iBAAiB,EACjB,oBAAoB,EAGpB,6BAA6B,EAI7B,4BAA4B,EAC5B,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AAcjB;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAgBjF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,MAAM,GACd,yBAAyB,GAAG,wBAAwB,CA+DtD;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAC7B,MAAM,EAAE,qBAAqB,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,MAAM,GACd,qBAAqB,CA+CvB;AAED,sEAAsE;AACtE,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,MAAM,GACd,yBAAyB,CAW3B;AAED,iDAAiD;AACjD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,qBAAqB,GAC5B,0BAA0B,CAS5B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,qBAAqB,EAC7B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC5C,mBAAmB,CAgBrB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,qBAAqB,GAC5B,4BAA4B,GAAG,6BAA6B,CAoC9D;AAID;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,oBAAoB,CAKtB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,qBAAqB,GAAG,iBAAiB,CAkGpF"}

package/lib/services/aiGen/providers/kling/klingRequests.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.toKlingShotPrompt = toKlingShotPrompt;
 exports.buildVideoGenerateRequest = buildVideoGenerateRequest;
 exports.buildExtendBody = buildExtendBody;
 exports.buildOmniVideoBody = buildOmniVideoBody;
@@ -7,8 +8,11 @@ exports.buildMotionControlBody = buildMotionControlBody;
 exports.buildAvatarRequest = buildAvatarRequest;
 exports.buildLipSyncBody = buildLipSyncBody;
 exports.buildTurboVideoBody = buildTurboVideoBody;
+exports.resolveKlingOmni2Resolution = resolveKlingOmni2Resolution;
+exports.buildOmni2VideoBody = buildOmni2VideoBody;
 const types_1 = require("../../types");
-const cameraAdapter_1 = require("./cameraAdapter");
+const cameraDirection_1 = require("../../canonicalAdapters/cameraDirection");
+const errors_1 = require("../../../../utils/errors");
 /**
  * Pure request-body builders mapping our provider-agnostic
  * VideoGenerationParams onto Kling's per-endpoint request shapes. No I/O —
@@ -16,12 +20,46 @@ const cameraAdapter_1 = require("./cameraAdapter");
  * the per-endpoint field wiring testable in isolation and the service class a
  * thin dispatcher.
  */
+/** Kling 3.0 / 3.0 Turbo prompt-encoded multi-shot limits (docs, 2026-09-29). */
+const KLING_MAX_SHOTS = 6;
+const KLING_MAX_SHOT_CHARS = 512;
+/**
+ * Canonical multiShot → Kling 3.0's prompt-encoded storyboard,
+ * "shot 1, 3, words; shot 2, 2, words;" (kling.ai/document-api/api/video/
+ * 3-0-omni/text-to-video and 3-0-turbo/*, fetched 2026-09-29). Each shot is
+ * ≥ 1s and the shot durations must sum to the video duration: caller-supplied
+ * durations are kept when they already satisfy that, otherwise the total is
+ * split evenly (remainder to the earliest shots). Semicolons inside a shot's
+ * text would read as a separator, so they become commas.
+ */
+function toKlingShotPrompt(shots, totalDuration) {
+    const count = Math.max(1, Math.min(shots.length, KLING_MAX_SHOTS, totalDuration));
+    const used = shots.slice(0, count);
+    const given = used.map((s) => s.duration);
+    const keepGiven = given.every((d) => d !== undefined && Number.isInteger(d) && d >= 1) &&
+        given.reduce((a, b) => a + b, 0) === totalDuration;
+    const base = Math.floor(totalDuration / count);
+    const remainder = totalDuration % count;
+    return used
+        .map((s, i) => {
+        const seconds = keepGiven ? given[i] : base + (i < remainder ? 1 : 0);
+        const words = s.prompt.replace(/;/g, ",").trim().slice(0, KLING_MAX_SHOT_CHARS);
+        return `shot ${i + 1}, ${seconds}, ${words};`;
+    })
+        .join(" ");
+}
 /**
  * text2video / image2video body. Routes by the presence of inputImageUrl and
- * wires the shared optional fields (negative prompt, cfg, camera control,
+ * wires the shared optional fields (negative prompt, cfg, camera direction,
  * audio/sound tier) plus the i2v-only mask / tail-frame fields.
  */
 function buildVideoGenerateRequest(params, modelId) {
+    params = (0, cameraDirection_1.applyCameraDirection)(params);
+    // Kling 3.0 reads multi-shot from the prompt (no multi_prompt[] on this
+    // endpoint) — before this, a v3.0 multiShot request was silently dropped.
+    if (params.multiShot?.length && params.modelKey === "kling-v3.0") {
+        params = { ...params, prompt: toKlingShotPrompt(params.multiShot, params.duration ?? 5) };
+    }
     // Common optional fields shared by text2video and image2video endpoints.
     const optional = {};
     if (params.negativePrompt)
@@ -32,20 +70,24 @@ function buildVideoGenerateRequest(params, modelId) {
         optional.callback_url = params.callbackUrl;
     if (params.externalTaskId)
         optional.external_task_id = params.externalTaskId;
-    if (params.cameraControl) {
-        const cc = (0, cameraAdapter_1.toKlingCameraControl)(params.cameraControl);
-        if (cc)
-            optional.camera_control = cc;
-    }
-    // v2.6 uses `sound: "on"|"off"` as a pricing-tier toggle. v3 uses
-    // `generate_audio: boolean` for native audio synthesis. Route by model.
+    // Kling's current text2video / image2video docs (2.5-turbo, 2.6, v3 —
+    // kling.ai/document-api/api/video/2-6/*, fetched 2026-09-29) no longer list
+    // `camera_control`; camera moves go in the prompt. applyCameraDirection
+    // (top of this function) does that.
+    // REMOVED FOR v2 — kept for reference:
+    // if (params.cameraControl) {
+    //   const cc = toKlingCameraControl(params.cameraControl);
+    //   if (cc) optional.camera_control = cc;
+    // }
+    // Native audio is `sound: "on"|"off"` on every model that has it (2.6 and
+    // v3 per the capability map; 2.5-turbo has none). The docs have no
+    // `generate_audio` field — sending it for v3 left audio off.
     if (params.audio !== undefined) {
-        if (params.modelKey === "kling-v3.0") {
-            optional.generate_audio = Boolean(params.audio);
-        }
-        else if (params.modelKey === "kling-v2.6") {
+        if (params.modelKey === "kling-v3.0" || params.modelKey === "kling-v2.6") {
             optional.sound = params.audio ? "on" : "off";
         }
+        // REMOVED FOR v2 — kept for reference: the undocumented v3 flag.
+        // if (params.modelKey === "kling-v3.0") optional.generate_audio = Boolean(params.audio);
     }
     const isImageToVideo = !!params.inputImageUrl;
     if (isImageToVideo) {
@@ -97,6 +139,7 @@ function buildExtendBody(params) {
 }
 /** OmniVideo body: start/end/reference frames, reference videos, multi-shot. */
 function buildOmniVideoBody(params, modelId) {
+    params = (0, cameraDirection_1.applyCameraDirection)(params);
     const body = {
         model_name: modelId,
         mode: params.mode || types_1.EVideoMode.STANDARD,
@@ -225,6 +268,10 @@ function buildTurboVideoBody(params) {
         options.watermark_info = { enabled: Boolean(params.watermark) };
     }
     const maybeOptions = Object.keys(options).length ? { options } : {};
+    // Turbo multi-shot is the same prompt-encoded storyboard as 3.0.
+    if (params.multiShot?.length) {
+        params = { ...params, prompt: toKlingShotPrompt(params.multiShot, settings.duration ?? 5) };
+    }
     if (params.inputImageUrl) {
         // I2V: prompt and image BOTH ride inside contents[].
         const contents = [];
@@ -236,3 +283,134 @@ function buildTurboVideoBody(params) {
     // T2V: prompt is a top-level string on this endpoint (not contents[]).
     return { prompt: params.prompt, settings, ...maybeOptions };
 }
+// ─── Kling 3.0 Omni, API 2.0 (POST /omni-video/kling-3.0-omni) ──────────────
+/**
+ * Output resolution for kling-3.0-omni. An explicit `resolution` wins (case-
+ * insensitive, so "4K" works); otherwise our canonical `mode` maps with
+ * Kling's own legacy equivalence (std=720p, pro=1080p, "4k"=4k). Shared with
+ * getKlingCreditUsed so the billed tier is always the requested tier.
+ */
+function resolveKlingOmni2Resolution(resolution, mode) {
+    const r = resolution?.toLowerCase();
+    if (r === "720p" || r === "1080p" || r === "4k")
+        return r;
+    if (mode === "4k")
+        return "4k";
+    return mode === types_1.EVideoMode.PROFESSIONAL ? "1080p" : "720p";
+}
+/**
+ * kling-3.0-omni body. Canonical params map onto contents[] as:
+ *   inputImageUrl        → first_frame
+ *   lastFrameImageUrl    → last_frame (only together with a first frame)
+ *   referenceImageUrls   → refer_image, ids image_1…image_n
+ *   referenceVideoUrls   → feature_video (style/motion reference), id video_1
+ *   inputVideoUrl        → base_video (the clip to EDIT), id video_1
+ *   klingElements        → element, ids element_1…element_n
+ * The prompt can cite those ids as @image_1 / @video_1 / @element_1.
+ *
+ * Audio: `audio: true` means native sound on a plain generation and "keep
+ * the original track" on a base-video edit. Kling allows no audio at all with
+ * a feature video, so there it is always "off".
+ *
+ * Kling's documented combination rules are enforced here so a bad mix fails
+ * at submit (no task id → full refund) with a readable message, instead of
+ * an opaque provider 400.
+ */
+function buildOmni2VideoBody(params) {
+    const modelId = "kling-3.0-omni";
+    const refImages = params.referenceImageUrls ?? [];
+    const refVideos = params.referenceVideoUrls ?? [];
+    const baseVideo = params.inputVideoUrl;
+    const hasVideo = !!baseVideo || refVideos.length > 0;
+    const fail = (msg) => {
+        throw new errors_1.UserFacingError(`${modelId}: ${msg}`, errors_1.USER_FACING_ERROR_CODES.CAPABILITY_MISMATCH);
+    };
+    if (params.lastFrameImageUrl && !params.inputImageUrl) {
+        fail("a last frame needs a first frame too.");
+    }
+    if (refVideos.length + (baseVideo ? 1 : 0) > 1) {
+        fail("takes at most one video (a reference video or a video to edit, not both).");
+    }
+    // REMOVED FOR v2 — kept for reference: image-only cap, before elements.
+    // const maxImages = hasVideo ? 4 : 7;
+    // if (refImages.length > maxImages) {
+    //   fail(`takes at most ${maxImages} reference images${hasVideo ? " alongside a video" : ""} (got ${refImages.length}).`);
+    // }
+    // Element Library: multi-image elements share the reference-image budget;
+    // video-character elements have their own caps (Kling docs, 2026-09-29).
+    const elements = params.klingElements ?? [];
+    const imageElements = elements.filter((e) => e.referenceType === "image_refer").length;
+    const videoElements = elements.length - imageElements;
+    if (params.inputImageUrl && elements.length > 3) {
+        fail(`takes at most 3 elements with a first frame (got ${elements.length}).`);
+    }
+    if (hasVideo && videoElements > 0 && (imageElements > 0 || refImages.length > 0)) {
+        fail("with a video, a video-character element can't be combined with image elements or reference images.");
+    }
+    const maxVideoElements = hasVideo ? 1 : 3;
+    if (videoElements > maxVideoElements) {
+        fail(`takes at most ${maxVideoElements} video-character element${maxVideoElements > 1 ? "s" : ""}${hasVideo ? " alongside a video" : ""} (got ${videoElements}).`);
+    }
+    const maxImages = hasVideo || videoElements > 0 ? 4 : 7;
+    if (refImages.length + imageElements > maxImages) {
+        const what = imageElements ? "reference images + image elements" : "reference images";
+        const why = hasVideo ? " alongside a video" : videoElements > 0 ? " alongside a video-character element" : "";
+        fail(`takes at most ${maxImages} ${what}${why} (got ${refImages.length + imageElements}).`);
+    }
+    if (baseVideo && (params.inputImageUrl || params.lastFrameImageUrl)) {
+        fail("a video edit cannot also set a first or last frame.");
+    }
+    if (baseVideo && params.multiShot?.length) {
+        fail("a video edit cannot be multi-shot.");
+    }
+    const duration = params.duration ?? 5;
+    let prompt = params.prompt;
+    if (params.multiShot?.length)
+        prompt = toKlingShotPrompt(params.multiShot, duration);
+    if (!prompt)
+        fail("a prompt is required.");
+    if (prompt.length > 3072) {
+        throw new errors_1.UserFacingError(`${modelId} prompts are limited to 3072 characters (got ${prompt.length}).`, errors_1.USER_FACING_ERROR_CODES.PROMPT_TOO_LONG);
+    }
+    const contents = [{ type: "prompt", text: prompt }];
+    if (params.inputImageUrl)
+        contents.push({ type: "first_frame", url: params.inputImageUrl });
+    if (params.lastFrameImageUrl)
+        contents.push({ type: "last_frame", url: params.lastFrameImageUrl });
+    refImages.forEach((url, i) => contents.push({ type: "refer_image", url, id: `image_${i + 1}` }));
+    if (refVideos[0])
+        contents.push({ type: "feature_video", url: refVideos[0], id: "video_1" });
+    if (baseVideo)
+        contents.push({ type: "base_video", url: baseVideo, id: "video_1" });
+    elements.forEach((e, i) => contents.push({ type: "element", element_id: e.elementId, id: `element_${i + 1}` }));
+    // A feature (reference) video allows audio "off" only; a base-video edit
+    // allows "original" or "off"; native sound needs no video at all.
+    const audio = !params.audio || refVideos.length > 0
+        ? "off"
+        : baseVideo ? "original" : "native";
+    const settings = {
+        resolution: resolveKlingOmni2Resolution(params.resolution, params.mode),
+        duration,
+        audio,
+        // Kling defaults multi_shot to TRUE, which lets it cut a single-prompt
+        // clip into shots on its own. Send it explicitly, on only when the caller
+        // asked for shots (base-video edits were rejected above for that).
+        multi_shot: !!params.multiShot?.length,
+    };
+    if (params.aspectRatio) {
+        settings.aspect_ratio = params.aspectRatio;
+    }
+    else if (!params.inputImageUrl && refVideos.length === 0) {
+        // Required by Kling when nothing else fixes the frame shape.
+        settings.aspect_ratio = "16:9";
+    }
+    const options = {};
+    if (params.callbackUrl)
+        options.callback_url = params.callbackUrl;
+    if (params.externalTaskId)
+        options.external_task_id = params.externalTaskId;
+    if (params.watermark !== undefined) {
+        options.watermark_info = { enabled: Boolean(params.watermark) };
+    }
+    return Object.keys(options).length ? { contents, settings, options } : { contents, settings };
+}

package/lib/services/aiGen/providers/kling/types.d.ts

@@ -259,4 +259,82 @@ export interface KlingTurboTasksResponse {
     request_id: string;
     data: KlingTurboTask[];
 }
+export type KlingOmni2Resolution = "720p" | "1080p" | "4k";
+/** settings.audio — "original" keeps the reference/base video's own track. */
+export type KlingOmni2Audio = "native" | "original" | "off";
+/**
+ * contents[] entry. `id` is the handle the prompt cites (`@image_1`,
+ * `@video_1`) and must be unique within a task. `element` entries carry an
+ * `element_id` from Kling's Element Library instead of a url.
+ */
+export interface KlingOmni2Content {
+    type: "prompt" | "first_frame" | "last_frame" | "refer_image" | "feature_video" | "base_video" | "element";
+    /** Set when type === "prompt". Max 3072 chars. */
+    text?: string;
+    url?: string;
+    element_id?: string;
+    id?: string;
+}
+export interface KlingOmni2Settings {
+    /** Default true on Kling's side; forced true with a feature_video. */
+    multi_shot?: boolean;
+    audio?: KlingOmni2Audio;
+    resolution?: KlingOmni2Resolution;
+    /** Required when there is no first frame and no reference video. */
+    aspect_ratio?: KlingAspectRatio;
+    /** 3–15s inclusive. */
+    duration?: number;
+}
+export interface KlingOmni2Request {
+    contents: KlingOmni2Content[];
+    settings?: KlingOmni2Settings;
+    options?: KlingTurboOptions;
+}
+export interface KlingCreateElementRequest {
+    element_name: string;
+    element_description: string;
+    reference_type: "image_refer" | "video_refer";
+    /** Required for image_refer: 1 frontal + 1–3 other angles / close-ups. */
+    element_image_list?: {
+        frontal_image: string;
+        refer_images: {
+            image_url: string;
+        }[];
+    };
+    /** Required for video_refer: one .mp4/.mov, 3–8s, 1080p, 16:9 or 9:16, ≤200MB. */
+    element_video_list?: {
+        refer_videos: {
+            video_url: string;
+        }[];
+    };
+    element_voice_id?: string;
+    tag_list?: {
+        tag_id: string;
+    }[];
+    callback_url?: string;
+    external_task_id?: string;
+}
+export interface KlingElementInfo {
+    element_id: number | string;
+    element_name: string;
+    element_description: string;
+    reference_type: "image_refer" | "video_refer";
+    owned_by?: string;
+    status?: "succeed" | "deleted";
+}
+export interface KlingElementTask {
+    task_id: string;
+    task_status: "submitted" | "processing" | "succeed" | "failed";
+    task_status_msg?: string;
+    task_result?: {
+        elements?: KlingElementInfo[];
+    };
+    final_unit_deduction?: string;
+}
+export interface KlingEnvelope<T> {
+    code: number;
+    message: string;
+    request_id?: string;
+    data: T;
+}
 //# sourceMappingURL=types.d.ts.map