@acedatacloud/sdk 2026.629.0 → 2026.716.1

package/dist/index.mjs

@@ -856,12 +856,148 @@ var Veo = class {
 };
 
 // src/resources/kling.ts
+var KLING_MODELS = [
+  "kling-v1",
+  "kling-v1-6",
+  "kling-v2-master",
+  "kling-v2-1-master",
+  "kling-v2-5-turbo",
+  "kling-v2-6",
+  "kling-v3",
+  "kling-v3-omni",
+  "kling-o1"
+];
+function isHttpUrl(value) {
+  try {
+    const url = new URL(value);
+    return url.protocol === "http:" || url.protocol === "https:";
+  } catch {
+    return false;
+  }
+}
+function validateGenerateOptions(opts) {
+  if (!KLING_MODELS.includes(opts.model)) {
+    throw new Error(`model must be one of: ${KLING_MODELS.join(", ")}`);
+  }
+  const isV3 = opts.model === "kling-v3" || opts.model === "kling-v3-omni";
+  const hasReferences = Boolean(opts.imageList?.length || opts.videoList?.length);
+  if (opts.imageList !== void 0 && opts.imageList.length === 0) {
+    throw new Error("imageList must be non-empty or omitted");
+  }
+  if (opts.videoList !== void 0 && opts.videoList.length === 0) {
+    throw new Error("videoList must be non-empty or omitted");
+  }
+  if ((opts.action === "text2video" || opts.action === "image2video") && !opts.prompt) {
+    throw new Error("prompt is required for text2video and image2video");
+  }
+  if (opts.action === "image2video" && !opts.startImageUrl) {
+    throw new Error("startImageUrl is required for image2video");
+  }
+  if (opts.action === "extend" && !opts.videoId) {
+    throw new Error("videoId is required for extend");
+  }
+  if (opts.endImageUrl && !opts.startImageUrl) {
+    throw new Error("startImageUrl is required with endImageUrl");
+  }
+  if (opts.startImageUrl && !isHttpUrl(opts.startImageUrl)) {
+    throw new Error("startImageUrl must be an HTTP URL");
+  }
+  if (opts.endImageUrl && !isHttpUrl(opts.endImageUrl)) {
+    throw new Error("endImageUrl must be an HTTP URL");
+  }
+  if (opts.callbackUrl && !isHttpUrl(opts.callbackUrl)) {
+    throw new Error("callbackUrl must be an HTTP URL");
+  }
+  if (opts.cfgScale !== void 0 && (opts.cfgScale < 0 || opts.cfgScale > 1)) {
+    throw new Error("cfgScale must be between 0 and 1");
+  }
+  if (opts.duration !== void 0 && !Number.isInteger(opts.duration)) {
+    throw new Error("duration must be an integer");
+  }
+  if (isV3 && opts.duration !== void 0 && (opts.duration < 3 || opts.duration > 15)) {
+    throw new Error("Kling V3 duration must be between 3 and 15 seconds");
+  }
+  if (!isV3 && opts.model !== "kling-o1" && opts.duration !== void 0 && ![5, 10].includes(opts.duration)) {
+    throw new Error("This Kling model supports only 5- or 10-second generation");
+  }
+  if (opts.model === "kling-o1" && opts.duration !== void 0 && opts.duration !== 5) {
+    throw new Error("kling-o1 supports only 5-second generation");
+  }
+  if (opts.model === "kling-o1" && opts.mode !== void 0 && !["std", "pro"].includes(opts.mode)) {
+    throw new Error("kling-o1 supports only std and pro modes");
+  }
+  if (opts.mode === "4k" && !isV3) {
+    throw new Error("4k mode requires kling-v3 or kling-v3-omni");
+  }
+  if (opts.action === "extend" && !["kling-v1", "kling-v1-6", "kling-v2-5-turbo"].includes(opts.model)) {
+    throw new Error("extend requires kling-v1, kling-v1-6, or kling-v2-5-turbo");
+  }
+  if (opts.action === "extend" && hasReferences) {
+    throw new Error("imageList and videoList are not supported with extend");
+  }
+  if (hasReferences && opts.model !== "kling-o1" && opts.model !== "kling-v3-omni") {
+    throw new Error("Omni references require kling-o1 or kling-v3-omni");
+  }
+  if (hasReferences && opts.mode === "4k") {
+    throw new Error("4k cannot be combined with Omni references");
+  }
+  if ((opts.model === "kling-o1" || hasReferences) && (opts.negativePrompt !== void 0 || opts.cameraControl !== void 0 || opts.cfgScale !== void 0)) {
+    throw new Error("Kling O1 and Omni references do not support negativePrompt, cameraControl, or cfgScale");
+  }
+  if (opts.model === "kling-o1" && opts.generateAudio) {
+    throw new Error("kling-o1 does not support generateAudio");
+  }
+  if (opts.generateAudio && !isV3 && opts.model !== "kling-v2-6") {
+    throw new Error("generateAudio requires a V3 model or kling-v2-6 pro mode");
+  }
+  if (opts.generateAudio && opts.model === "kling-v2-6" && opts.mode !== "pro") {
+    throw new Error("kling-v2-6 supports generateAudio only in pro mode");
+  }
+  if (opts.generateAudio && opts.videoList?.length) {
+    throw new Error("generateAudio cannot be used with videoList");
+  }
+  if (opts.videoList && (opts.videoList.length === 0 || opts.videoList.length > 1)) {
+    throw new Error("videoList must contain exactly one reference video");
+  }
+  for (const image of opts.imageList ?? []) {
+    if (!isHttpUrl(image.imageUrl)) throw new Error("Every reference image requires an HTTP imageUrl");
+    if (image.type !== void 0 && !["first_frame", "end_frame"].includes(image.type)) {
+      throw new Error("Reference image type must be first_frame or end_frame");
+    }
+  }
+  for (const video of opts.videoList ?? []) {
+    if (!isHttpUrl(video.videoUrl)) throw new Error("Every reference video requires an HTTP videoUrl");
+    if (video.referType !== void 0 && !["base", "feature"].includes(video.referType)) {
+      throw new Error("Reference video referType must be base or feature");
+    }
+    if (video.keepOriginalSound !== void 0 && !["yes", "no"].includes(video.keepOriginalSound)) {
+      throw new Error("Reference video keepOriginalSound must be yes or no");
+    }
+  }
+  const firstFrames = Number(Boolean(opts.startImageUrl)) + (opts.imageList ?? []).filter((item) => item.type === "first_frame").length;
+  const endFrames = Number(Boolean(opts.endImageUrl)) + (opts.imageList ?? []).filter((item) => item.type === "end_frame").length;
+  if (firstFrames > 1 || endFrames > 1) {
+    throw new Error("Only one first frame and one end frame are allowed");
+  }
+  if (endFrames > 0 && firstFrames === 0) {
+    throw new Error("A first frame is required with an end frame");
+  }
+  if ((opts.videoList?.[0]?.referType ?? "base") === "base" && opts.videoList?.length && (firstFrames > 0 || endFrames > 0)) {
+    throw new Error("A base reference video cannot be combined with first or end frames");
+  }
+  const imageCount = (opts.imageList?.length ?? 0) + Number(Boolean(opts.startImageUrl)) + Number(Boolean(opts.endImageUrl));
+  const imageLimit = opts.videoList?.length ? 4 : 7;
+  if (imageCount > imageLimit) {
+    throw new Error(`Reference images cannot exceed ${imageLimit} for this request`);
+  }
+}
 var Kling = class {
   constructor(transport) {
     this.transport = transport;
   }
   transport;
   async generate(opts) {
+    validateGenerateOptions(opts);
     const {
       action,
       mode,
@@ -873,15 +1009,16 @@ var Kling = class {
       cfgScale,
       aspectRatio,
       callbackUrl,
+      async: asyncMode,
+      timeout,
       endImageUrl,
       cameraControl,
-      elementList,
+      imageList,
       videoList,
       negativePrompt,
-      startImageUrl,
-      ...rest
+      startImageUrl
     } = opts;
-    const body = { action, ...rest };
+    const body = { action };
     if (mode !== void 0) body.mode = mode;
     if (model !== void 0) body.model = model;
     if (prompt !== void 0) body.prompt = prompt;
@@ -891,26 +1028,46 @@ var Kling = class {
     if (cfgScale !== void 0) body.cfg_scale = cfgScale;
     if (aspectRatio !== void 0) body.aspect_ratio = aspectRatio;
     if (callbackUrl !== void 0) body.callback_url = callbackUrl;
+    if (asyncMode !== void 0) body.async = asyncMode;
+    if (timeout !== void 0) body.timeout = timeout;
     if (endImageUrl !== void 0) body.end_image_url = endImageUrl;
     if (cameraControl !== void 0) body.camera_control = cameraControl;
-    if (elementList !== void 0) body.element_list = elementList;
-    if (videoList !== void 0) body.video_list = videoList;
+    if (imageList !== void 0) {
+      body.image_list = imageList.map(({ imageUrl, type }) => ({ image_url: imageUrl, ...type ? { type } : {} }));
+    }
+    if (videoList !== void 0) {
+      body.video_list = videoList.map(({ videoUrl, referType, keepOriginalSound }) => ({
+        video_url: videoUrl,
+        ...referType ? { refer_type: referType } : {},
+        ...keepOriginalSound ? { keep_original_sound: keepOriginalSound } : {}
+      }));
+    }
     if (negativePrompt !== void 0) body.negative_prompt = negativePrompt;
     if (startImageUrl !== void 0) body.start_image_url = startImageUrl;
     return this.transport.request("POST", "/kling/videos", { json: body });
   }
   async motion(opts) {
-    const { mode, imageUrl, videoUrl, characterOrientation, keepOriginalSound, prompt, callbackUrl, ...rest } = opts;
+    const { mode, imageUrl, videoUrl, characterOrientation, keepOriginalSound, prompt, callbackUrl } = opts;
+    if (!["std", "pro"].includes(mode)) throw new Error("mode must be std or pro");
+    if (!isHttpUrl(imageUrl)) throw new Error("imageUrl must be an HTTP URL");
+    if (!isHttpUrl(videoUrl)) throw new Error("videoUrl must be an HTTP URL");
+    if (!["image", "video"].includes(characterOrientation)) {
+      throw new Error("characterOrientation must be image or video");
+    }
+    if (keepOriginalSound !== void 0 && !["yes", "no"].includes(keepOriginalSound)) {
+      throw new Error("keepOriginalSound must be yes or no");
+    }
+    if (callbackUrl && !isHttpUrl(callbackUrl)) throw new Error("callbackUrl must be an HTTP URL");
     const body = {
       mode,
       image_url: imageUrl,
       video_url: videoUrl,
-      character_orientation: characterOrientation,
-      ...rest
+      character_orientation: characterOrientation
     };
     if (keepOriginalSound !== void 0) body.keep_original_sound = keepOriginalSound;
     if (prompt !== void 0) body.prompt = prompt;
     if (callbackUrl !== void 0) body.callback_url = callbackUrl;
+    if (opts.async !== void 0) body.async = opts.async;
     return this.transport.request("POST", "/kling/motion", { json: body });
   }
 };