@acedatacloud/sdk 2026.824.0 → 2026.905.0

package/package.json

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

package/src/resources/providers/fish.ts

@@ -22,15 +22,15 @@ export interface FishGenerateOptions {
   /** Top-p nucleus sampling parameter, controls output diversity. */
   topP?: number;
   /** Output audio format, default is `mp3`. */
-  format?: "mp3" | "wav" | "pcm" | "opus";
+  format?: "mp3" | "wav" | "pcm";
   /** Delay mode. The upstream rejects null values, and defaults to `normal` when omitted. */
   latency?: "normal" | "balanced";
   /** Rhythm coverage parameters, forwarded as is to upstream (such as speech rate, volume, etc.). */
   prosody?: Record<string, unknown>;
   /** 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?: Array<Record<string, unknown>>;
+  /** One-shot voice clone reference; cannot be combined with reference_id. */
+  references?: Array<{ audio: string; text: string }>;
   /** MP3 bitrate when `format=mp3`. */
   mp3Bitrate?: number;
   /** Output the audio sampling rate (e.g., 16000, 22050, 44100). */
@@ -41,14 +41,15 @@ export interface FishGenerateOptions {
   chunkLength?: number;
   /** Opus bitrate when `format=opus`. */
   opusBitrate?: number;
-  /** Voice model ID (single speaker). A string array can also be passed in multi-speaker scenarios. */
-  referenceId?: string;
+  /** Saved/public voice ID; cannot be combined with references. */
+  referenceId?: string | string[];
   /** Maximum number of new tokens generated. */
   maxNewTokens?: number;
   /** Minimum block length. */
   minChunkLength?: number;
   /** The repetition penalty coefficient applied during the generation process. */
   repetitionPenalty?: number;
+  model?: "s1" | "s2-pro" | "s2.1-pro";
   /** Submit asynchronously and poll. Defaults to true. */
   async?: boolean;
   /** Wait for completion before returning the handle. */
@@ -108,13 +109,13 @@ export class Fish {
     if (options.minChunkLength !== undefined) body["min_chunk_length"] = options.minChunkLength;
     if (options.repetitionPenalty !== undefined) body["repetition_penalty"] = options.repetitionPenalty;
     for (const [key, value] of Object.entries(options)) {
-      if (!["async", "callbackUrl", "chunkLength", "format", "latency", "maxNewTokens", "maxWait", "minChunkLength", "mp3Bitrate", "normalize", "opusBitrate", "pollInterval", "prosody", "referenceId", "references", "repetitionPenalty", "sampleRate", "temperature", "text", "topP", "wait"].includes(key) && value !== undefined) {
+      if (!["async", "callbackUrl", "chunkLength", "format", "latency", "maxNewTokens", "maxWait", "minChunkLength", "model", "mp3Bitrate", "normalize", "opusBitrate", "pollInterval", "prosody", "referenceId", "references", "repetitionPenalty", "sampleRate", "temperature", "text", "topP", "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', "/fish/tts", { json: body })) as Record<string, unknown>;
+    const result = (await this.transport.request('POST', "/fish/tts", { json: body, headers: options.model !== undefined ? {"model": options.model} : {} })) as Record<string, unknown>;
     const handle = new TaskHandle(taskId(result), "/fish/tasks", this.transport, result);
     if (options.wait) {
       await handle.wait({ pollInterval: options.pollInterval, maxWait: options.maxWait });

package/src/resources/providers/seedream.ts

@@ -17,34 +17,34 @@ function taskId(result: Record<string, unknown>): string {
 }
 
 export interface SeedreamGenerateOptions {
-  /** Models used for generating images. If not specified, the default is `doubao-seedream-5.0-lite`. `doubao-seedream-5.0-pro` is the latest flagship single image model (only generates single images, does not support group images, streaming, or online search). */
-  model: "doubao-seedream-5-0-pro-260628" | "doubao-seedream-5-0-260128" | "doubao-seedream-4-0-250828" | "doubao-seedream-4-5-251128" | "doubao-seedream-3-0-t2i-250415" | "doubao-seededit-3-0-i2i-250628";
-  /** Prompts for generating images. */
-  prompt: string;
-  /** Generate a random seed for image generation. The supported range is [-1, 2147483647], with a default value of `-1`. **Only `doubao-seedream-3.0-t2i` supports this parameter** (according to the official Volcengine documentation), other models do not accept this parameter. */
-  seed?: number;
-  /** Generate image dimensions or aspect ratios. Supports preset options (`1K`/`2K`/`3K`/`4K`), or explicit `<width>x<height>` format (e.g., `1024x1024`). **Different models support different preset options**: `doubao-seedream-5.0-pro` supports `1K`/`2K`; `doubao-seedream-5.0-lite` supports `2K`/`3K`/`4K`; `doubao-seedream-4.5` only supports `2K`/`4K`; `doubao-seedream-4.0` supports `1K`/`2K`/`4K`; `doubao-seedream-3.0-t2i` and `doubao-seedream-3.0-i2i` **do not support** any preset options and must receive explicit `<width>x<height>` values. */
-  size?: "1K" | "2K" | "3K" | "4K";
-  /** 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?: 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`. */
+  /** 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";
+  /** 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. */
+  image?: string | string[];
+  /** Output size. Pro supports 1K/1.5K/2K or valid dimensions; decomposition also supports auto. Lite supports 2K/3K/4K or valid dimensions. */
+  size?: "1K" | "1.5K" | "2K" | "3K" | "4K" | "auto" | `${number}x${number}`;
+  /** Sequential image mode. auto lets supported Lite/4.x models generate a related set; disabled returns one image. Not supported by Pro. */
+  sequentialImageGeneration?: "auto" | "disabled";
+  /** Sequential image options. max_images is 1-15 and input images plus outputs must not exceed 15. */
+  sequentialImageGenerationOptions?: Record<string, unknown>;
+  /** Stream normalized image events. Supported by Lite/4.x only and cannot be combined with async or callback_url. */
   stream?: boolean;
-  /** Whether to add AI-generated watermark, default is `true`. */
+  /** Image response format: url or b64_json. */
+  responseFormat?: "url" | "b64_json";
+  /** Whether to add the AI-generated watermark. */
   watermark?: boolean;
-  /** The output image file format is `jpeg` by default. Only `doubao-seedream-5.0-pro` and `doubao-seedream-5.0-lite` are supported. */
+  /** Output image format, jpeg or png. Supported by Seedream 5.0 Pro and Lite. */
   outputFormat?: "jpeg" | "png";
-  /** Prompt word weight, the larger the value, the more relevant the generated result is to the prompt word. Only supports `doubao-seedream-3.0-t2i` (default value 2.5) and `doubao-seededit-3.0-i2i` (default value 5.5), both ranges are [1, 10]. */
-  guidanceScale?: unknown;
-  /** The response format defaults to `url`, and also supports `b64_json`. */
-  responseFormat?: string;
-  /** Optional prompt word optimization configuration. Only supports `doubao-seedream-5.0-lite`, `doubao-seedream-4.5` (only in `standard` mode), and `doubao-seedream-4.0`. */
+  /** Model tools. Seedream 5.0 Lite supports web_search. */
+  tools?: Array<Record<string, unknown>>;
+  /** Prompt optimization. Pro supports standard/fast; Lite and 4.5 support standard; 4.0 supports standard/fast. */
   optimizePromptOptions?: Record<string, unknown>;
-  /** The default value is `disabled`. Setting it to `auto` allows the model to generate a set of stylistically coherent related images (multi-image consistency, sharing characters, styles, and details across frames). Only `doubao-seedream-5.0-lite`, `doubao-seedream-4.5`, and `doubao-seedream-4.0` are supported. */
-  sequentialImageGeneration?: "auto" | "disabled";
-  /** Adjustable parameters for batch image generation. Effective only when `sequential_image_generation=auto`. Only supports `doubao-seedream-5.0-lite`, `doubao-seedream-4.5`, and `doubao-seedream-4.0`. */
-  sequentialImageGenerationOptions?: Record<string, unknown>;
+  /** Seedream 5.0 Pro layer decomposition. Requires exactly one PNG/JPEG and returns one base image plus up to 16 transparent PNG layers. */
+  layerDecomposition?: boolean;
+  /** Seedream 5.0 Pro background mode. transparent requires one transparent PNG input and PNG output; opaque produces a regular background. */
+  background?: "transparent" | "opaque";
   /** Submit asynchronously and poll. Defaults to true. */
   async?: boolean;
   /** Wait for completion before returning the handle. */
@@ -60,25 +60,25 @@ export interface SeedreamGenerateOptions {
 export class Seedream {
   constructor(private transport: Transport) {}
 
-  /** ByteDance Seedream high-quality image generation and editing API. Supports text-to-image models doubao-seedream-3-0-t2i-250415, doubao-seedream-4-0-250828, doubao-seedream-4-5-251128, doubao-seedream- */
+  /** Call /seedream/images. */
   async generate(options: SeedreamGenerateOptions): Promise<TaskHandle> {
     const body: Record<string, unknown> = {};
     body["model"] = options.model;
-    body["prompt"] = options.prompt;
-    if (options.seed !== undefined) body["seed"] = options.seed;
-    if (options.size !== undefined) body["size"] = options.size;
+    if (options.prompt !== undefined) body["prompt"] = options.prompt;
     if (options.image !== undefined) body["image"] = options.image;
-    if (options.tools !== undefined) body["tools"] = options.tools;
+    if (options.size !== undefined) body["size"] = options.size;
+    if (options.sequentialImageGeneration !== undefined) body["sequential_image_generation"] = options.sequentialImageGeneration;
+    if (options.sequentialImageGenerationOptions !== undefined) body["sequential_image_generation_options"] = options.sequentialImageGenerationOptions;
     if (options.stream !== undefined) body["stream"] = options.stream;
+    if (options.responseFormat !== undefined) body["response_format"] = options.responseFormat;
     if (options.watermark !== undefined) body["watermark"] = options.watermark;
     if (options.outputFormat !== undefined) body["output_format"] = options.outputFormat;
-    if (options.guidanceScale !== undefined) body["guidance_scale"] = options.guidanceScale;
-    if (options.responseFormat !== undefined) body["response_format"] = options.responseFormat;
+    if (options.tools !== undefined) body["tools"] = options.tools;
     if (options.optimizePromptOptions !== undefined) body["optimize_prompt_options"] = options.optimizePromptOptions;
-    if (options.sequentialImageGeneration !== undefined) body["sequential_image_generation"] = options.sequentialImageGeneration;
-    if (options.sequentialImageGenerationOptions !== undefined) body["sequential_image_generation_options"] = options.sequentialImageGenerationOptions;
+    if (options.layerDecomposition !== undefined) body["layer_decomposition"] = options.layerDecomposition;
+    if (options.background !== undefined) body["background"] = options.background;
     for (const [key, value] of Object.entries(options)) {
-      if (!["async", "callbackUrl", "guidanceScale", "image", "maxWait", "model", "optimizePromptOptions", "outputFormat", "pollInterval", "prompt", "responseFormat", "seed", "sequentialImageGeneration", "sequentialImageGenerationOptions", "size", "stream", "tools", "wait", "watermark"].includes(key) && value !== undefined) {
+      if (!["async", "background", "callbackUrl", "image", "layerDecomposition", "maxWait", "model", "optimizePromptOptions", "outputFormat", "pollInterval", "prompt", "responseFormat", "sequentialImageGeneration", "sequentialImageGenerationOptions", "size", "stream", "tools", "wait", "watermark"].includes(key) && value !== undefined) {
         body[key] = value;
       }
     }