@acedatacloud/sdk 2026.910.0 → 2026.1005.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acedatacloud/sdk",
-  "version": "2026.910.0",
+  "version": "2026.1005.0",
   "description": "Official TypeScript SDK for AceDataCloud — AI-powered data services",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/resources/kling.ts

@@ -10,6 +10,7 @@ export const KLING_MODELS = [
   'kling-v2-5-turbo',
   'kling-v2-6',
   'kling-v3',
+  'kling-v3-turbo',
   'kling-v3-omni',
   'kling-o1',
 ] as const;
@@ -58,6 +59,11 @@ export interface KlingGenerateOptions {
   videoList?: KlingReferenceVideo[];
   negativePrompt?: string;
   startImageUrl?: string;
+  multiShot?: boolean;
+  shotType?: 'intelligence' | 'customize';
+  multiPrompt?: Array<{ index: number; prompt: string; duration: number }>;
+  elementList?: Array<Record<string, unknown>>;
+  voiceList?: Array<Record<string, unknown>>;
 }
 
 function isHttpUrl(value: string): boolean {
@@ -73,7 +79,16 @@ function validateGenerateOptions(opts: KlingGenerateOptions): void {
   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 isTurbo = opts.model === 'kling-v3-turbo';
+  const isV3 = opts.model === 'kling-v3' || opts.model === 'kling-v3-omni' || isTurbo;
+  if (isTurbo) {
+    if ((opts.mode !== undefined && !['std', 'pro'].includes(opts.mode)) || opts.generateAudio === false) {
+      throw new Error('Turbo supports std/pro with included audio');
+    }
+    if ([opts.endImageUrl, opts.cameraControl, opts.cfgScale, opts.negativePrompt, opts.imageList, opts.videoList, opts.elementList, opts.voiceList].some(value => value !== undefined) || opts.multiShot || opts.multiPrompt) {
+      throw new Error('Turbo does not support tail frames, camera controls, Omni references or storyboards');
+    }
+  }
   const hasReferences = Boolean(opts.imageList?.length || opts.videoList?.length);
 
   if (opts.imageList !== undefined && opts.imageList.length === 0) {
@@ -83,7 +98,7 @@ function validateGenerateOptions(opts: KlingGenerateOptions): void {
     throw new Error('videoList must be non-empty or omitted');
   }
 
-  if ((opts.action === 'text2video' || opts.action === 'image2video') && !opts.prompt) {
+  if ((opts.action === 'text2video' || opts.action === 'image2video') && !opts.prompt && !opts.multiPrompt?.length) {
     throw new Error('prompt is required for text2video and image2video');
   }
   if (opts.action === 'image2video' && !opts.startImageUrl) {
@@ -217,6 +232,11 @@ export class Kling {
       startImageUrl,
     } = opts;
     const body: Record<string, unknown> = { action };
+    if (opts.multiShot !== undefined) body.multi_shot = opts.multiShot;
+    if (opts.shotType !== undefined) body.shot_type = opts.shotType;
+    if (opts.multiPrompt !== undefined) body.multi_prompt = opts.multiPrompt;
+    if (opts.elementList !== undefined) body.element_list = opts.elementList;
+    if (opts.voiceList !== undefined) body.voice_list = opts.voiceList;
     if (mode !== undefined) body.mode = mode;
     if (model !== undefined) body.model = model;
     if (prompt !== undefined) body.prompt = prompt;
@@ -278,4 +298,20 @@ export class Kling {
     if (opts.async !== undefined) body.async = opts.async;
     return this.transport.request('POST', '/kling/motion', { json: body });
   }
+
+  async lipSync(request: Record<string, unknown>): Promise<Record<string, unknown>> {
+    return this.transport.request('POST', '/kling/lip-sync', { json: request });
+  }
+
+  async talkingPhoto(request: Record<string, unknown>): Promise<Record<string, unknown>> {
+    return this.transport.request('POST', '/kling/talking-photo', { json: request });
+  }
+
+  async goodsStudio(request: Record<string, unknown>): Promise<Record<string, unknown>> {
+    return this.transport.request('POST', '/kling/goods-studio', { json: request });
+  }
+
+  async videoCommerce(request: Record<string, unknown>): Promise<Record<string, unknown>> {
+    return this.transport.request('POST', '/kling/video-commerce', { json: request });
+  }
 }

package/src/resources/providers/flux.ts

@@ -40,6 +40,32 @@ export interface FluxGenerateOptions {
   [key: string]: unknown;
 }
 
+export interface FluxVideosOptions {
+  mode: "t2v" | "i2v" | "v2v" | "draft_enhance";
+  action?: "generate";
+  prompt?: string;
+  aspectRatio?: "21:9" | "2:1" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16" | "9:21" | "auto";
+  duration?: number | "auto";
+  resolution?: "hd" | "fhd" | "qhd" | "uhd";
+  version?: "latest";
+  generateAudio?: boolean;
+  safetyTolerance?: number;
+  draft?: boolean;
+  model?: "flux-3";
+  keyframes?: string | unknown[] | string[];
+  startVideo?: string;
+  draftTaskId?: string;
+  /** Submit asynchronously and poll. Defaults to true. */
+  async?: boolean;
+  /** Wait for completion before returning the handle. */
+  wait?: boolean;
+  pollInterval?: number;
+  maxWait?: number;
+  callbackUrl?: string;
+  /** Any parameter added upstream before the SDK is regenerated. */
+  [key: string]: unknown;
+}
+
 /** flux client. */
 export class Flux {
   constructor(private transport: Transport) {}
@@ -68,4 +94,36 @@ export class Flux {
     return handle;
   }
 
+  /** Flux Generate Summary */
+  async videos(options: FluxVideosOptions): Promise<TaskHandle> {
+    const body: Record<string, unknown> = {};
+    body["mode"] = options.mode;
+    body["action"] = options.action ?? "generate";
+    if (options.prompt !== undefined) body["prompt"] = options.prompt;
+    body["aspect_ratio"] = options.aspectRatio ?? "auto";
+    if (options.duration !== undefined) body["duration"] = options.duration;
+    body["resolution"] = options.resolution ?? "hd";
+    body["version"] = options.version ?? "latest";
+    if (options.generateAudio !== undefined) body["generate_audio"] = options.generateAudio;
+    body["safety_tolerance"] = options.safetyTolerance ?? 2;
+    if (options.draft !== undefined) body["draft"] = options.draft;
+    body["model"] = options.model ?? "flux-3";
+    if (options.keyframes !== undefined) body["keyframes"] = options.keyframes;
+    if (options.startVideo !== undefined) body["start_video"] = options.startVideo;
+    if (options.draftTaskId !== undefined) body["draft_task_id"] = options.draftTaskId;
+    for (const [key, value] of Object.entries(options)) {
+      if (!["action", "aspectRatio", "async", "callbackUrl", "draft", "draftTaskId", "duration", "generateAudio", "keyframes", "maxWait", "mode", "model", "pollInterval", "prompt", "resolution", "safetyTolerance", "startVideo", "version", "wait"].includes(key) && value !== undefined) {
+        body[key] = value;
+      }
+    }
+    if (options.callbackUrl !== undefined) body.callback_url = options.callbackUrl;
+    body.async = options.async ?? true;
+    const result = (await this.transport.request('POST', "/flux/videos", { json: body })) as Record<string, unknown>;
+    const handle = new TaskHandle(taskId(result), "/flux/tasks", this.transport, result);
+    if (options.wait) {
+      await handle.wait({ pollInterval: options.pollInterval, maxWait: options.maxWait });
+    }
+    return handle;
+  }
+
 }

package/src/resources/providers/seedance.ts

@@ -41,12 +41,16 @@ export interface SeedanceGenerateOptions {
   returnLastFrame?: boolean;
   /** $t(seedance_videos_execution_expires_after) */
   executionExpiresAfter?: number;
-  /** $t(seedance_videos_omni_reference_task_type) */
-  omniReferenceTaskType?: "auto" | "edit" | "extend";
+  /** Seedance Videos Omni Reference Task Type */
+  omniReferenceTaskType?: "auto" | "reference" | "edit" | "extend";
   /** $t(seedance_videos_output_format) */
   outputFormat?: "mp4" | "mov";
   /** $t(seedance_videos_tools) */
   tools?: Array<Record<string, unknown>>;
+  /** Seedance Videos Priority */
+  priority?: number;
+  /** Seedance Videos Safety Identifier */
+  safetyIdentifier?: string;
   /** Submit asynchronously and poll. Defaults to true. */
   async?: boolean;
   /** Wait for completion before returning the handle. */
@@ -80,8 +84,10 @@ export class Seedance {
     if (options.omniReferenceTaskType !== undefined) body["omni_reference_task_type"] = options.omniReferenceTaskType;
     if (options.outputFormat !== undefined) body["output_format"] = options.outputFormat;
     if (options.tools !== undefined) body["tools"] = options.tools;
+    body["priority"] = options.priority ?? 0;
+    if (options.safetyIdentifier !== undefined) body["safety_identifier"] = options.safetyIdentifier;
     for (const [key, value] of Object.entries(options)) {
-      if (!["async", "callbackUrl", "camerafixed", "content", "duration", "executionExpiresAfter", "frames", "generateAudio", "maxWait", "model", "omniReferenceTaskType", "outputFormat", "pollInterval", "ratio", "resolution", "returnLastFrame", "seed", "tools", "wait", "watermark"].includes(key) && value !== undefined) {
+      if (!["async", "callbackUrl", "camerafixed", "content", "duration", "executionExpiresAfter", "frames", "generateAudio", "maxWait", "model", "omniReferenceTaskType", "outputFormat", "pollInterval", "priority", "ratio", "resolution", "returnLastFrame", "safetyIdentifier", "seed", "tools", "wait", "watermark"].includes(key) && value !== undefined) {
         body[key] = value;
       }
     }

package/src/resources/providers/seedream.ts

@@ -18,7 +18,7 @@ function taskId(result: Record<string, unknown>): string {
 
 export interface SeedreamGenerateOptions {
   /** Full model ID. Seedream 5.0 Pro supports single-image generation, precise editing, transparent backgrounds, and layer decomposition; Seedream 5.0 Lite supports single or sequential images, streaming, and web search. */
-  model: "doubao-seedream-5-0-pro-260628" | "doubao-seedream-5-0-260128" | "doubao-seedream-5-0-lite-260128" | "doubao-seedream-4-0-250828" | "doubao-seedream-4-5-251128";
+  model: "doubao-seedream-5-0-pro-260628" | "doubao-seedream-5-0-lite-260128" | "doubao-seedream-4-0-250828" | "doubao-seedream-4-5-251128";
   /** Generation or editing prompt. Optional only for Seedream 5.0 Pro layer decomposition, where omission automatically decomposes the main elements. */
   prompt?: string;
   /** One reference image URL/base64 string or an array. Pro accepts up to 10 images in regular mode and exactly one for decomposition; Lite/4.x accept up to 14. Each image must be at most 30 MB. */

package/src/resources/providers/suno.ts

@@ -214,6 +214,20 @@ export interface SunoUploadOptions {
   [key: string]: unknown;
 }
 
+export interface SunoMp3Options {
+  /** Suno Mp3 Audio Id */
+  audioId: string;
+  /** Submit asynchronously and poll. Defaults to true. */
+  async?: boolean;
+  /** Wait for completion before returning the handle. */
+  wait?: boolean;
+  pollInterval?: number;
+  maxWait?: number;
+  callbackUrl?: string;
+  /** Any parameter added upstream before the SDK is regenerated. */
+  [key: string]: unknown;
+}
+
 /** suno client. */
 export class Suno {
   constructor(private transport: Transport) {}
@@ -437,4 +451,23 @@ export class Suno {
     return (await this.transport.request('POST', "/suno/upload", { json: body })) as Record<string, unknown>;
   }
 
+  /** Suno Mp3 */
+  async mp3(options: SunoMp3Options): Promise<TaskHandle> {
+    const body: Record<string, unknown> = {};
+    body["audio_id"] = options.audioId;
+    for (const [key, value] of Object.entries(options)) {
+      if (!["async", "audioId", "callbackUrl", "maxWait", "pollInterval", "wait"].includes(key) && value !== undefined) {
+        body[key] = value;
+      }
+    }
+    if (options.callbackUrl !== undefined) body.callback_url = options.callbackUrl;
+    body.async = options.async ?? true;
+    const result = (await this.transport.request('POST', "/suno/mp3", { json: body })) as Record<string, unknown>;
+    const handle = new TaskHandle(taskId(result), "/suno/tasks", this.transport, result);
+    if (options.wait) {
+      await handle.wait({ pollInterval: options.pollInterval, maxWait: options.maxWait });
+    }
+    return handle;
+  }
+
 }