@acedatacloud/sdk 2026.629.0 → 2026.716.1

package/dist/index.d.mts

@@ -502,7 +502,7 @@ declare class Glm {
 
 /** Veo-specific video generation and editing resources. */
 
-type VeoModel = 'veo2' | 'veo2-fast' | 'veo3' | 'veo3-fast' | 'veo31-fast' | 'veo31' | 'veo31-fast-ingredients' | (string & {});
+type VeoModel = 'veo3' | 'veo3-fast' | 'veo31-fast' | 'veo31' | 'veo31-fast-ingredients' | (string & {});
 declare class Veo {
     private transport;
     constructor(transport: Transport);
@@ -512,8 +512,8 @@ declare class Veo {
         model?: VeoModel;
         resolution?: '4k' | '1080p' | 'gif';
         videoId?: string;
-        translation?: string;
-        aspectRatio?: '9:16' | '1:1' | '3:4' | '4:3' | '16:9';
+        translation?: boolean;
+        aspectRatio?: '16:9' | '9:16';
         imageUrls?: string[];
         callbackUrl?: string;
         async?: boolean;
@@ -554,30 +554,52 @@ declare class Veo {
 
 /** Kling-specific video generation resources. */
 
-type KlingModel = '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-video-o1' | (string & {});
+declare const KLING_MODELS: readonly ["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"];
+type KlingModel = (typeof KLING_MODELS)[number];
+interface KlingCameraControl {
+    type: 'simple' | 'down_back' | 'forward_up' | 'left_turn_forward' | 'right_turn_forward';
+    config?: {
+        horizontal?: number;
+        vertical?: number;
+        pan?: number;
+        tilt?: number;
+        roll?: number;
+        zoom?: number;
+    };
+}
+interface KlingReferenceImage {
+    imageUrl: string;
+    type?: 'first_frame' | 'end_frame';
+}
+interface KlingReferenceVideo {
+    videoUrl: string;
+    referType?: 'base' | 'feature';
+    keepOriginalSound?: 'yes' | 'no';
+}
+interface KlingGenerateOptions {
+    action: 'text2video' | 'image2video' | 'extend';
+    mode?: 'std' | 'pro' | '4k';
+    model: KlingModel;
+    prompt?: string;
+    duration?: number;
+    generateAudio?: boolean;
+    videoId?: string;
+    cfgScale?: number;
+    aspectRatio?: '16:9' | '9:16' | '1:1';
+    callbackUrl?: string;
+    async?: boolean;
+    timeout?: number;
+    endImageUrl?: string;
+    cameraControl?: KlingCameraControl;
+    imageList?: KlingReferenceImage[];
+    videoList?: KlingReferenceVideo[];
+    negativePrompt?: string;
+    startImageUrl?: string;
+}
 declare class Kling {
     private transport;
     constructor(transport: Transport);
-    generate(opts: {
-        action: 'text2video' | 'image2video' | 'extend';
-        mode?: 'std' | 'pro' | '4k';
-        model?: KlingModel;
-        prompt?: string;
-        duration?: 5 | 10;
-        generateAudio?: boolean;
-        videoId?: string;
-        cfgScale?: number;
-        aspectRatio?: '16:9' | '9:16' | '1:1';
-        callbackUrl?: string;
-        async?: boolean;
-        endImageUrl?: string;
-        cameraControl?: string;
-        elementList?: unknown[];
-        videoList?: unknown[];
-        negativePrompt?: string;
-        startImageUrl?: string;
-        [key: string]: unknown;
-    }): Promise<Record<string, unknown>>;
+    generate(opts: KlingGenerateOptions): Promise<Record<string, unknown>>;
     motion(opts: {
         mode: 'std' | 'pro';
         imageUrl: string;
@@ -587,7 +609,6 @@ declare class Kling {
         prompt?: string;
         callbackUrl?: string;
         async?: boolean;
-        [key: string]: unknown;
     }): Promise<Record<string, unknown>>;
 }
 
@@ -712,4 +733,4 @@ declare class AceDataCloud {
     constructor(opts?: AceDataCloudOptions);
 }
 
-export { APIError, AceDataCloud, AceDataCloudError, type AceDataCloudOptions, type AiChatModel, type AudioProvider, AuthenticationError, type GlmModel, type ImageProvider, InsufficientBalanceError, type KlingModel, ModerationError, type PaymentHandler, type PaymentHandlerContext, type PaymentHandlerResult, type PaymentRequiredBody, type PaymentRequirement, RateLimitError, ResourceDisabledError, TaskHandle, type TaskHandleOptions, TimeoutError, TokenMismatchError, TransportError, ValidationError, type VeoModel, type VideoProvider };
+export { APIError, AceDataCloud, AceDataCloudError, type AceDataCloudOptions, type AiChatModel, type AudioProvider, AuthenticationError, type GlmModel, type ImageProvider, InsufficientBalanceError, type KlingCameraControl, type KlingGenerateOptions, type KlingModel, type KlingReferenceImage, type KlingReferenceVideo, ModerationError, type PaymentHandler, type PaymentHandlerContext, type PaymentHandlerResult, type PaymentRequiredBody, type PaymentRequirement, RateLimitError, ResourceDisabledError, TaskHandle, type TaskHandleOptions, TimeoutError, TokenMismatchError, TransportError, ValidationError, type VeoModel, type VideoProvider };

package/dist/index.d.ts

@@ -502,7 +502,7 @@ declare class Glm {
 
 /** Veo-specific video generation and editing resources. */
 
-type VeoModel = 'veo2' | 'veo2-fast' | 'veo3' | 'veo3-fast' | 'veo31-fast' | 'veo31' | 'veo31-fast-ingredients' | (string & {});
+type VeoModel = 'veo3' | 'veo3-fast' | 'veo31-fast' | 'veo31' | 'veo31-fast-ingredients' | (string & {});
 declare class Veo {
     private transport;
     constructor(transport: Transport);
@@ -512,8 +512,8 @@ declare class Veo {
         model?: VeoModel;
         resolution?: '4k' | '1080p' | 'gif';
         videoId?: string;
-        translation?: string;
-        aspectRatio?: '9:16' | '1:1' | '3:4' | '4:3' | '16:9';
+        translation?: boolean;
+        aspectRatio?: '16:9' | '9:16';
         imageUrls?: string[];
         callbackUrl?: string;
         async?: boolean;
@@ -554,30 +554,52 @@ declare class Veo {
 
 /** Kling-specific video generation resources. */
 
-type KlingModel = '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-video-o1' | (string & {});
+declare const KLING_MODELS: readonly ["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"];
+type KlingModel = (typeof KLING_MODELS)[number];
+interface KlingCameraControl {
+    type: 'simple' | 'down_back' | 'forward_up' | 'left_turn_forward' | 'right_turn_forward';
+    config?: {
+        horizontal?: number;
+        vertical?: number;
+        pan?: number;
+        tilt?: number;
+        roll?: number;
+        zoom?: number;
+    };
+}
+interface KlingReferenceImage {
+    imageUrl: string;
+    type?: 'first_frame' | 'end_frame';
+}
+interface KlingReferenceVideo {
+    videoUrl: string;
+    referType?: 'base' | 'feature';
+    keepOriginalSound?: 'yes' | 'no';
+}
+interface KlingGenerateOptions {
+    action: 'text2video' | 'image2video' | 'extend';
+    mode?: 'std' | 'pro' | '4k';
+    model: KlingModel;
+    prompt?: string;
+    duration?: number;
+    generateAudio?: boolean;
+    videoId?: string;
+    cfgScale?: number;
+    aspectRatio?: '16:9' | '9:16' | '1:1';
+    callbackUrl?: string;
+    async?: boolean;
+    timeout?: number;
+    endImageUrl?: string;
+    cameraControl?: KlingCameraControl;
+    imageList?: KlingReferenceImage[];
+    videoList?: KlingReferenceVideo[];
+    negativePrompt?: string;
+    startImageUrl?: string;
+}
 declare class Kling {
     private transport;
     constructor(transport: Transport);
-    generate(opts: {
-        action: 'text2video' | 'image2video' | 'extend';
-        mode?: 'std' | 'pro' | '4k';
-        model?: KlingModel;
-        prompt?: string;
-        duration?: 5 | 10;
-        generateAudio?: boolean;
-        videoId?: string;
-        cfgScale?: number;
-        aspectRatio?: '16:9' | '9:16' | '1:1';
-        callbackUrl?: string;
-        async?: boolean;
-        endImageUrl?: string;
-        cameraControl?: string;
-        elementList?: unknown[];
-        videoList?: unknown[];
-        negativePrompt?: string;
-        startImageUrl?: string;
-        [key: string]: unknown;
-    }): Promise<Record<string, unknown>>;
+    generate(opts: KlingGenerateOptions): Promise<Record<string, unknown>>;
     motion(opts: {
         mode: 'std' | 'pro';
         imageUrl: string;
@@ -587,7 +609,6 @@ declare class Kling {
         prompt?: string;
         callbackUrl?: string;
         async?: boolean;
-        [key: string]: unknown;
     }): Promise<Record<string, unknown>>;
 }
 
@@ -712,4 +733,4 @@ declare class AceDataCloud {
     constructor(opts?: AceDataCloudOptions);
 }
 
-export { APIError, AceDataCloud, AceDataCloudError, type AceDataCloudOptions, type AiChatModel, type AudioProvider, AuthenticationError, type GlmModel, type ImageProvider, InsufficientBalanceError, type KlingModel, ModerationError, type PaymentHandler, type PaymentHandlerContext, type PaymentHandlerResult, type PaymentRequiredBody, type PaymentRequirement, RateLimitError, ResourceDisabledError, TaskHandle, type TaskHandleOptions, TimeoutError, TokenMismatchError, TransportError, ValidationError, type VeoModel, type VideoProvider };
+export { APIError, AceDataCloud, AceDataCloudError, type AceDataCloudOptions, type AiChatModel, type AudioProvider, AuthenticationError, type GlmModel, type ImageProvider, InsufficientBalanceError, type KlingCameraControl, type KlingGenerateOptions, type KlingModel, type KlingReferenceImage, type KlingReferenceVideo, ModerationError, type PaymentHandler, type PaymentHandlerContext, type PaymentHandlerResult, type PaymentRequiredBody, type PaymentRequirement, RateLimitError, ResourceDisabledError, TaskHandle, type TaskHandleOptions, TimeoutError, TokenMismatchError, TransportError, ValidationError, type VeoModel, type VideoProvider };

package/dist/index.js

@@ -904,12 +904,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,
@@ -921,15 +1057,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;
@@ -939,26 +1076,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 });
   }
 };