@acedatacloud/sdk 2026.811.0 → 2026.817.0

package/package.json

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

package/src/resources/providers/digitalhuman.ts

@@ -74,7 +74,7 @@ export class Digitalhuman {
   async generate(options: DigitalhumanGenerateOptions): Promise<TaskHandle> {
     const body: Record<string, unknown> = {};
     body["video_url"] = options.videoUrl;
-    body["text"] = options.text ?? "\u5927\u5bb6\u597d\uff0c\u8fd9\u662f\u79bb\u7ebf\u751f\u6210\u7684\u6570\u5b57\u4eba\u3002";
+    if (options.text !== undefined) body["text"] = options.text;
     body["speed"] = options.speed ?? 1.0;
     body["steps"] = options.steps ?? 40;
     body["engine"] = options.engine ?? "latentsync";

package/src/resources/providers/fish.ts

@@ -30,7 +30,7 @@ export interface FishGenerateOptions {
   /** Is the input text subjected to text normalization processing by the upstream? */
   normalize?: boolean;
   /** Inline reference audio samples will be forwarded upstream as is, for zero-shot voice cloning. */
-  references?: unknown[];
+  references?: Array<Record<string, unknown>>;
   /** MP3 bitrate when `format=mp3`. */
   mp3Bitrate?: number;
   /** Output the audio sampling rate (e.g., 16000, 22050, 44100). */
@@ -103,7 +103,7 @@ export class Fish {
     if (options.temperature !== undefined) body["temperature"] = options.temperature;
     if (options.chunkLength !== undefined) body["chunk_length"] = options.chunkLength;
     if (options.opusBitrate !== undefined) body["opus_bitrate"] = options.opusBitrate;
-    body["reference_id"] = options.referenceId ?? "d7900c21663f485ab63ebdb7e5905036";
+    if (options.referenceId !== undefined) body["reference_id"] = options.referenceId;
     if (options.maxNewTokens !== undefined) body["max_new_tokens"] = options.maxNewTokens;
     if (options.minChunkLength !== undefined) body["min_chunk_length"] = options.minChunkLength;
     if (options.repetitionPenalty !== undefined) body["repetition_penalty"] = options.repetitionPenalty;

package/src/resources/providers/flux.ts

@@ -17,12 +17,12 @@ function taskId(result: Record<string, unknown>): string {
 }
 
 export interface FluxGenerateOptions {
+  /** Image size specifications. */
+  size: string;
   /** Types of operations for generating images. If it is `generate`, a new image will be created based on the prompt; if it is `edit`, the original image will be edited according to the prompt and `image_url`. */
   action: "generate" | "edit";
   /** Prompts for generating images. */
   prompt: string;
-  /** Image size specifications. */
-  size?: string;
   /** Number of generated images. */
   count?: number;
   /** Model used for generating images. */
@@ -47,9 +47,9 @@ export class Flux {
   /** Flux AI image generation API, generates 1 image per request. */
   async generate(options: FluxGenerateOptions): Promise<TaskHandle> {
     const body: Record<string, unknown> = {};
+    body["size"] = options.size;
     body["action"] = options.action;
     body["prompt"] = options.prompt;
-    body["size"] = options.size ?? "1024x1024";
     if (options.count !== undefined) body["count"] = options.count;
     if (options.model !== undefined) body["model"] = options.model;
     if (options.imageUrl !== undefined) body["image_url"] = options.imageUrl;

package/src/resources/providers/hailuo.ts

@@ -45,7 +45,7 @@ export class Hailuo {
     const body: Record<string, unknown> = {};
     body["action"] = options.action;
     if (options.model !== undefined) body["model"] = options.model;
-    body["prompt"] = options.prompt ?? "\u706b\u6c14";
+    if (options.prompt !== undefined) body["prompt"] = options.prompt;
     if (options.firstImageUrl !== undefined) body["first_image_url"] = options.firstImageUrl;
     for (const [key, value] of Object.entries(options)) {
       if (!["action", "async", "callbackUrl", "firstImageUrl", "maxWait", "model", "pollInterval", "prompt", "wait"].includes(key) && value !== undefined) {

package/src/resources/providers/happyhorse.ts

@@ -63,10 +63,10 @@ export class Happyhorse {
     body["model"] = options.model ?? "happyhorse-1.1-t2v";
     body["ratio"] = options.ratio ?? "16:9";
     body["action"] = options.action ?? "generate";
-    body["prompt"] = options.prompt ?? "A cinematic white horse lifts its head, the mane moves gently in the sunrise wind, slow camera push in, warm film lighting";
+    if (options.prompt !== undefined) body["prompt"] = options.prompt;
     body["duration"] = options.duration ?? 5;
-    body["image_url"] = options.imageUrl ?? "https://cdn.acedata.cloud/b1c82e4937.png";
-    body["video_url"] = options.videoUrl ?? "https://platform2.cdn.acedata.cloud/happyhorse/27837f92-d1c1-4db4-ad9a-4e6e81d9f6c1.mp4";
+    if (options.imageUrl !== undefined) body["image_url"] = options.imageUrl;
+    if (options.videoUrl !== undefined) body["video_url"] = options.videoUrl;
     body["watermark"] = options.watermark ?? false;
     if (options.imageUrls !== undefined) body["image_urls"] = options.imageUrls;
     body["resolution"] = options.resolution ?? "1080P";

package/src/resources/providers/luma.ts

@@ -57,14 +57,14 @@ export class Luma {
     const body: Record<string, unknown> = {};
     body["loop"] = options.loop ?? false;
     body["action"] = options.action ?? "generate";
-    body["prompt"] = options.prompt ?? "Astronauts shuttle from space to volcano";
+    if (options.prompt !== undefined) body["prompt"] = options.prompt;
     body["timeout"] = options.timeout ?? 300;
     if (options.videoId !== undefined) body["video_id"] = options.videoId;
     if (options.videoUrl !== undefined) body["video_url"] = options.videoUrl;
     body["enhancement"] = options.enhancement ?? true;
     if (options.aspectRatio !== undefined) body["aspect_ratio"] = options.aspectRatio;
-    body["end_image_url"] = options.endImageUrl ?? "https://cdn.acedata.cloud/0iad3k.png";
-    body["start_image_url"] = options.startImageUrl ?? "https://cdn.acedata.cloud/r9vsv9.png";
+    if (options.endImageUrl !== undefined) body["end_image_url"] = options.endImageUrl;
+    if (options.startImageUrl !== undefined) body["start_image_url"] = options.startImageUrl;
     for (const [key, value] of Object.entries(options)) {
       if (!["action", "aspectRatio", "async", "callbackUrl", "endImageUrl", "enhancement", "loop", "maxWait", "pollInterval", "prompt", "startImageUrl", "timeout", "videoId", "videoUrl", "wait"].includes(key) && value !== undefined) {
         body[key] = value;

package/src/resources/providers/minimax.ts

@@ -8,6 +8,7 @@
 import { Transport } from '../../runtime/transport';
 import { TaskHandle } from '../../runtime/tasks';
 
+
 function taskId(result: Record<string, unknown>): string {
   if (typeof result?.task_id === 'string') return result.task_id;
   const data = result?.data as Record<string, unknown> | undefined;
@@ -15,19 +16,20 @@ function taskId(result: Record<string, unknown>): string {
   return typeof result?.id === 'string' ? result.id : '';
 }
 
-
 export interface MinimaxGenerateOptions {
-  /** Minimax Videos Model */
+  /** Model name, currently only supports the official value `MiniMax-H3`. */
   model: "MiniMax-H3";
-  /** Minimax Videos Content */
+  /** Official MiniMax H3 V2 multimodal input array. Each request must include a non-empty `text`; supports images at the beginning and end or multimodal reference materials, but the two types of scenes cannot be mixed. */
   content: Array<Record<string, unknown>>;
-  /** Minimax Videos Resolution */
-  resolution: "768P" | "2K";
-  /** Minimax Videos Duration */
+  /** Video duration, required, integer between 4 and 15 seconds. */
   duration: number;
-  /** Minimax Videos Ratio */
+  /** Video resolution, required, optional `768P` or `2K`. */
+  resolution: "768P" | "2K";
+  /** Video aspect ratio. Text-to-video is required and cannot be `adaptive`; image-to-video defaults to `adaptive`; multimodal reference is optional. */
   ratio?: "adaptive" | "21:9" | "16:9" | "4:3" | "1:1" | "3:4" | "9:16";
+  /** Submit asynchronously and poll. Defaults to true. */
   async?: boolean;
+  /** Wait for completion before returning the handle. */
   wait?: boolean;
   pollInterval?: number;
   maxWait?: number;
@@ -40,13 +42,13 @@ export interface MinimaxGenerateOptions {
 export class Minimax {
   constructor(private transport: Transport) {}
 
-  /** Minimax Videos */
+  /** Call /minimax/videos. */
   async generate(options: MinimaxGenerateOptions): Promise<TaskHandle> {
     const body: Record<string, unknown> = {};
     body["model"] = options.model;
     body["content"] = options.content;
-    body["resolution"] = options.resolution;
     body["duration"] = options.duration;
+    body["resolution"] = options.resolution;
     if (options.ratio !== undefined) body["ratio"] = options.ratio;
     for (const [key, value] of Object.entries(options)) {
       if (!["async", "callbackUrl", "content", "duration", "maxWait", "model", "pollInterval", "ratio", "resolution", "wait"].includes(key) && value !== undefined) {

package/src/resources/providers/nano-banana.ts

@@ -55,7 +55,7 @@ export class NanoBanana {
     if (options.model !== undefined) body["model"] = options.model;
     if (options.imageUrls !== undefined) body["image_urls"] = options.imageUrls;
     if (options.resolution !== undefined) body["resolution"] = options.resolution;
-    body["aspect_ratio"] = options.aspectRatio ?? "1:1";
+    if (options.aspectRatio !== undefined) body["aspect_ratio"] = options.aspectRatio;
     for (const [key, value] of Object.entries(options)) {
       if (!["action", "aspectRatio", "async", "callbackUrl", "count", "imageUrls", "maxWait", "model", "pollInterval", "prompt", "resolution", "wait"].includes(key) && value !== undefined) {
         body[key] = value;

package/src/resources/providers/seedance.ts

@@ -17,30 +17,36 @@ function taskId(result: Record<string, unknown>): string {
 }
 
 export interface SeedanceGenerateOptions {
-  /** Model ID for video generation */
-  model: "doubao-seedance-1-0-pro-250528" | "doubao-seedance-1-0-pro-fast-251015" | "doubao-seedance-1-5-pro-251215" | "doubao-seedance-1-0-lite-t2v-250428" | "doubao-seedance-1-0-lite-i2v-250428" | "doubao-seedance-2-0-260128" | "doubao-seedance-2-0-fast-260128" | "doubao-seedance-2-0-mini-260615";
-  /** Input content for video generation. Each entry must include one of `text`, `image_url`, `audio_url`, or `video_url` corresponding to the `type`. The meaning of other fields and whether they are required depends on the value of `type`. */
-  content: unknown[];
-  /** The random seed used for reproducible generation has a value range from -1 to 4294967295; -1 indicates randomness. */
-  seed?: number;
-  /** Aspect ratio of the generated video */
+  /** $t(seedance_videos_model) */
+  model: "doubao-seedance-1-0-pro-250528" | "doubao-seedance-1-0-pro-fast-251015" | "doubao-seedance-1-5-pro-251215" | "doubao-seedance-1-0-lite-t2v-250428" | "doubao-seedance-1-0-lite-i2v-250428" | "doubao-seedance-2-0-260128" | "doubao-seedance-2-0-fast-260128" | "doubao-seedance-2-0-mini-260615" | "doubao-seedance-2-5-260628";
+  /** $t(seedance_videos) */
+  content: Array<Record<string, unknown>>;
+  /** $t(seedance_videos_resolution) */
+  resolution?: "480p" | "720p" | "1080p" | "4k";
+  /** $t(seedance_videos_ratio) */
   ratio?: "16:9" | "4:3" | "1:1" | "3:4" | "9:16" | "21:9" | "adaptive";
-  /** The frame count for generating a video must meet 25 + 4n (such as 29, 33, 37... 361). Either duration or frames can be specified; if both are specified, frames take priority over duration. */
-  frames?: number;
-  /** The duration of the generated video, in seconds. Either duration or frames can be specified; if both are specified, frames take priority over duration. The duration range varies for each model: Seedance 2.0 series is 4 to 15 seconds or -1, Seedance 1.5 Pro is 4 to 12 seconds or -1, and Seedance 1.0 series is 2 to 12 seconds. -1 indicates automatic duration. */
+  /** $t(seedance_videos_duration) */
   duration?: number;
-  /** Whether to add a watermark to the generated video. */
-  watermark?: boolean;
-  /** Video resolution. The default value depends on the model used: most models default to 720p, while the lite model defaults to 480p. Note that the supported resolutions vary by model: `4k` is only supported by doubao-seedance-2-0 (standard version); doubao-seedance-2-0-fast and doubao-seedance-2-0-mini do not support 1080p and 4k. */
-  resolution?: "480p" | "720p" | "1080p" | "4k";
-  /** Is the camera position fixed during the generation process? */
+  /** $t(seedance_videos_frames) */
+  frames?: number;
+  /** $t(seedance_videos_seed) */
+  seed?: number;
+  /** $t(seedance_videos_camerafixed) */
   camerafixed?: boolean;
-  /** Whether to generate audio from video. The `doubao-seedance-1-5-pro-251215` and `doubao-seedance-2-0` series models support this parameter, while other models will ignore this parameter. */
+  /** $t(seedance_videos_watermark) */
+  watermark?: boolean;
+  /** $t(seedance_videos_generate_audio) */
   generateAudio?: boolean;
-  /** Whether to return the last frame of the generated video. */
+  /** $t(seedance_videos_return_last_frame) */
   returnLastFrame?: boolean;
-  /** Task timeout threshold, unit in seconds */
+  /** $t(seedance_videos_execution_expires_after) */
   executionExpiresAfter?: number;
+  /** $t(seedance_videos_omni_reference_task_type) */
+  omniReferenceTaskType?: "auto" | "edit" | "extend";
+  /** $t(seedance_videos_output_format) */
+  outputFormat?: "mp4" | "mov";
+  /** $t(seedance_videos_tools) */
+  tools?: Array<Record<string, unknown>>;
   /** Submit asynchronously and poll. Defaults to true. */
   async?: boolean;
   /** Wait for completion before returning the handle. */
@@ -56,23 +62,26 @@ export interface SeedanceGenerateOptions {
 export class Seedance {
   constructor(private transport: Transport) {}
 
-  /** ByteDance Seedance video generation API. Supports doubao-seedance-1-0-pro-250528, doubao-seedance-1-0-pro-fast-251015, doubao-seedance-1-5-pro-251215, doubao-seedance-1-0-lite-t2v-250428, and doubao-s */
+  /** Call /seedance/videos. */
   async generate(options: SeedanceGenerateOptions): Promise<TaskHandle> {
     const body: Record<string, unknown> = {};
     body["model"] = options.model;
     body["content"] = options.content;
-    if (options.seed !== undefined) body["seed"] = options.seed;
+    if (options.resolution !== undefined) body["resolution"] = options.resolution;
     body["ratio"] = options.ratio ?? "16:9";
-    if (options.frames !== undefined) body["frames"] = options.frames;
     if (options.duration !== undefined) body["duration"] = options.duration;
-    if (options.watermark !== undefined) body["watermark"] = options.watermark;
-    if (options.resolution !== undefined) body["resolution"] = options.resolution;
+    if (options.frames !== undefined) body["frames"] = options.frames;
+    if (options.seed !== undefined) body["seed"] = options.seed;
     if (options.camerafixed !== undefined) body["camerafixed"] = options.camerafixed;
+    if (options.watermark !== undefined) body["watermark"] = options.watermark;
     body["generate_audio"] = options.generateAudio ?? false;
     body["return_last_frame"] = options.returnLastFrame ?? false;
     body["execution_expires_after"] = options.executionExpiresAfter ?? 172800;
+    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;
     for (const [key, value] of Object.entries(options)) {
-      if (!["async", "callbackUrl", "camerafixed", "content", "duration", "executionExpiresAfter", "frames", "generateAudio", "maxWait", "model", "pollInterval", "ratio", "resolution", "returnLastFrame", "seed", "wait", "watermark"].includes(key) && value !== undefined) {
+      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) {
         body[key] = value;
       }
     }

package/src/resources/providers/seedream.ts

@@ -28,7 +28,7 @@ export interface SeedreamGenerateOptions {
   /** Reference image links for image editing are required, supporting accessible http/https URLs, or base64 encoded image strings in the format `data:image/png;base64,iVBORw0KG...`. Each image must not exceed 10MB in size. This parameter is mandatory when using image-to-image models (such as `doubao-seededit-3.0-i2i`). */
   image?: string[];
   /** List of tools that can be called by the model. Currently, only `web_search` is supported. Applicable only to `doubao-seedream-5.0-lite`. */
-  tools?: unknown[];
+  tools?: Array<Record<string, unknown>>;
   /** Whether to return all images in a streaming manner, default is `false`. Only supports `doubao-seedream-5.0-lite`, `doubao-seedream-4.5`, and `doubao-seedream-4.0`. */
   stream?: boolean;
   /** Whether to add AI-generated watermark, default is `true`. */

package/src/resources/providers/suno.ts

@@ -222,16 +222,16 @@ export class Suno {
   async generate(options: SunoGenerateOptions = {}): Promise<TaskHandle> {
     const body: Record<string, unknown> = {};
     if (options.lyric !== undefined) body["lyric"] = options.lyric;
-    body["model"] = options.model ?? "chirp-v5-5";
+    if (options.model !== undefined) body["model"] = options.model;
     if (options.style !== undefined) body["style"] = options.style;
     if (options.title !== undefined) body["title"] = options.title;
-    body["action"] = options.action ?? "generate";
+    if (options.action !== undefined) body["action"] = options.action;
     if (options.custom !== undefined) body["custom"] = options.custom;
-    body["prompt"] = options.prompt ?? "A song for Christmas";
+    if (options.prompt !== undefined) body["prompt"] = options.prompt;
     if (options.audioId !== undefined) body["audio_id"] = options.audioId;
     if (options.duration !== undefined) body["duration"] = options.duration;
     if (options.weirdness !== undefined) body["weirdness"] = options.weirdness;
-    body["audio_urls"] = options.audioUrls ?? ["https://cdn1.suno.ai/b481b17a-bf50-4e10-8adc-4d5635050893.mp3"];
+    if (options.audioUrls !== undefined) body["audio_urls"] = options.audioUrls;
     if (options.personaId !== undefined) body["persona_id"] = options.personaId;
     if (options.continueAt !== undefined) body["continue_at"] = options.continueAt;
     if (options.samplesEnd !== undefined) body["samples_end"] = options.samplesEnd;
@@ -251,7 +251,7 @@ export class Suno {
     if (options.underpaintingStart !== undefined) body["underpainting_start"] = options.underpaintingStart;
     if (options.replaceSectionStart !== undefined) body["replace_section_start"] = options.replaceSectionStart;
     for (const [key, value] of Object.entries(options)) {
-      if (!["action", "async", "audioId", "audioUrls", "audioWeight", "callbackUrl", "continueAt", "custom", "duration", "instrumental", "lyric", "lyricPrompt", "mashupAudioIds", "maxWait", "model", "overpaintingEnd", "overpaintingStart", "personaId", "pollInterval", "prompt", "replaceSectionEnd", "replaceSectionStart", "samplesEnd", "samplesStart", "style", "styleInfluence", "negativeTags", "title", "underpaintingEnd", "underpaintingStart", "variationCategory", "vocalGender", "wait", "weirdness"].includes(key) && value !== undefined) {
+      if (!["action", "async", "audioId", "audioUrls", "audioWeight", "callbackUrl", "continueAt", "custom", "duration", "instrumental", "lyric", "lyricPrompt", "mashupAudioIds", "maxWait", "model", "negativeTags", "overpaintingEnd", "overpaintingStart", "personaId", "pollInterval", "prompt", "replaceSectionEnd", "replaceSectionStart", "samplesEnd", "samplesStart", "style", "styleInfluence", "title", "underpaintingEnd", "underpaintingStart", "variationCategory", "vocalGender", "wait", "weirdness"].includes(key) && value !== undefined) {
         body[key] = value;
       }
     }

package/src/resources/providers/wan.ts

@@ -68,11 +68,11 @@ export class Wan {
     body["audio"] = options.audio ?? false;
     if (options.duration !== undefined) body["duration"] = options.duration;
     if (options.audioUrl !== undefined) body["audio_url"] = options.audioUrl;
-    body["image_url"] = options.imageUrl ?? "https://cdn.acedata.cloud/r9vsv9.png";
+    if (options.imageUrl !== undefined) body["image_url"] = options.imageUrl;
     if (options.shotType !== undefined) body["shot_type"] = options.shotType;
     if (options.resolution !== undefined) body["resolution"] = options.resolution;
     body["prompt_extend"] = options.promptExtend ?? false;
-    body["negative_prompt"] = options.negativePrompt ?? "Astronauts shuttle from space to volcano";
+    if (options.negativePrompt !== undefined) body["negative_prompt"] = options.negativePrompt;
     if (options.referenceVideoUrls !== undefined) body["reference_video_urls"] = options.referenceVideoUrls;
     for (const [key, value] of Object.entries(options)) {
       if (!["action", "async", "audio", "audioUrl", "callbackUrl", "duration", "imageUrl", "maxWait", "model", "negativePrompt", "pollInterval", "prompt", "promptExtend", "referenceVideoUrls", "resolution", "shotType", "size", "wait"].includes(key) && value !== undefined) {