@acedatacloud/sdk 2026.1101.0 → 2026.1101.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acedatacloud/sdk",
-  "version": "2026.1101.0",
+  "version": "2026.1101.1",
   "description": "Ace Data Cloud SDK for Suno, Seedance, HappyHorse, GPT Image and Nano Banana",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/resources/aichat.ts

@@ -5,6 +5,7 @@ import { Transport } from '../runtime/transport';
 export type AiChatModel =
   | 'mimo-v2.6-pro'
   | 'mimo-v2.6-flash'
+  | 'gpt-6.1-terra'
   | 'gpt-5.6-sol-fast'
   | 'gpt-5.5'
   | 'gpt-5.5-pro'

package/src/resources/providers/maestro.ts

@@ -34,9 +34,9 @@ export interface MaestroGenerateOptions {
   /** Production route: auto, narrated, captions, avatar, or drama. captions requires source video in file_urls; avatar requires a portrait. All routes use the same per-second rate. */
   scenario?: "auto" | "narrated" | "captions" | "avatar" | "drama";
   /** Optional visual-style preset — expressed through typography, palette, motion, image treatment and pacing. Orthogonal to `scenario` (it does NOT change routing). `auto` (default) lets the director pick; every other value adopts a real named look: `cinematic` = dark film-noir (black + blood-red, Oswald); `glass` = Apple / iOS-26 frosted liquid glass; `luxury` = timeless near-black + indigo, huge whitespace; `swiss` = precise grid + electric blue + oversized numerals; `modern` = clean light SaaS; `editorial` = cream magazine + serif; `warm` = intimate cream + amber; `vibrant` = festive folk colour; `neon` = electric neon glow; `mono` = grayscale, type-led; `pastel` = soft candy pastels; `bold` = huge poster type; `industrial` = raw glitch + rust; `futuristic` = particle glow. A freeform string is also accepted as a soft hint. */
-  style?: "auto" | "cinematic" | "glass" | "luxury" | "swiss" | "modern" | "editorial" | "warm" | "vibrant" | "neon" | "mono" | "pastel" | "bold" | "industrial" | "futuristic" | "retro";
-  /** Optional narration voice — the **timbre** of the voiceover, independent of language. `auto` (default) lets the director pick a fitting voice. Every preset can speak the language selected in `langs`, so choose purely by character — `warm-female`, `bright-female`, `anchor-female`, `clean-female`, `calm-male`, `deep-male`, `documentary-male`, `energetic-male`, `storyteller-male`. For `drama` / `avatar` this sets the primary / narrator timbre; distinct characters may still get their own. */
-  voice?: "auto" | "warm-female" | "bright-female" | "anchor-female" | "clean-female" | "calm-male" | "deep-male" | "documentary-male" | "energetic-male" | "storyteller-male";
+  style?: string;
+  /** Optional narration voice — the **timbre** of the voiceover, independent of language. `auto` (default) lets the director pick a fitting voice. Every preset can speak the language selected in `langs`, so choose purely by character — `warm-female`, `bright-female`, `anchor-female`, `clean-female`, `calm-male`, `deep-male`, `documentary-male`, `energetic-male`, `storyteller-male`. For `drama` / `avatar` this sets the primary / narrator timbre; distinct characters may still get their own. A 32-character hexadecimal voice reference_id is also accepted. */
+  voice?: "auto" | "warm-female" | "bright-female" | "anchor-female" | "clean-female" | "calm-male" | "deep-male" | "documentary-male" | "energetic-male" | "storyteller-male" | string;
   /** Submit asynchronously and poll. Defaults to true. */
   async?: boolean;
   /** Wait for completion before returning the handle. */

package/src/resources/providers/producer.ts

@@ -41,20 +41,20 @@ export interface ProducerWavOptions {
 }
 
 export interface ProducerGenerateOptions {
-  /** Lyrics content for generating audio. */
-  lyric: string;
   /** Types of audio generation operations. Supported values include `generate` (generate based on prompts), `cover` (cover song), `extend` (continue writing), `variation` (variant), `swap_vocals` (replace vocals), `swap_instrumentals` (replace instrumentals), `replace_section` (replace section), `stems` (separate tracks). */
   action: "generate" | "cover" | "extend" | "variation" | "swap_vocals" | "swap_instrumentals" | "replace_section" | "stems";
-  /** Prompts for generating audio should not exceed 200 characters in length. */
-  prompt: string;
   /** Random seed used for audio generation. */
   seed?: string;
+  /** Lyrics content for generating audio. */
+  lyric?: string;
   /** The model used for generating music is `FUZZ-2.0` by default. */
   model?: "FUZZ-2.0 Pro" | "FUZZ-2.0" | "FUZZ-2.0 Raw" | "FUZZ-1.1 Pro" | "FUZZ-1.0 Pro" | "FUZZ-1.0" | "FUZZ-1.1" | "FUZZ-0.8";
   /** Title used for generating songs. */
   title?: string;
   /** Is it a custom mode? If `true`, the audio will be generated based on the `lyric`; otherwise, it will be generated based on the `prompt`. */
   custom?: boolean;
+  /** Prompts for generating audio should not exceed 200 characters in length. */
+  prompt?: string;
   /** The unique ID of the reference song. */
   audioId?: string;
   /** The degree of uniqueness of style can be selected between 0 and 1, with a default value of 0.5. */
@@ -136,13 +136,13 @@ export class Producer {
   /** Producer AI music generation API, generates 1 song per request. */
   async generate(options: ProducerGenerateOptions): Promise<TaskHandle> {
     const body: Record<string, unknown> = {};
-    body["lyric"] = options.lyric;
     body["action"] = options.action;
-    body["prompt"] = options.prompt;
     if (options.seed !== undefined) body["seed"] = options.seed;
+    if (options.lyric !== undefined) body["lyric"] = options.lyric;
     if (options.model !== undefined) body["model"] = options.model;
     if (options.title !== undefined) body["title"] = options.title;
-    if (options.custom !== undefined) body["custom"] = options.custom;
+    body["custom"] = options.custom ?? false;
+    if (options.prompt !== undefined) body["prompt"] = options.prompt;
     if (options.audioId !== undefined) body["audio_id"] = options.audioId;
     body["weirdness"] = options.weirdness ?? false;
     body["continue_at"] = options.continueAt ?? false;

package/src/resources/providers/suno.ts

@@ -39,7 +39,7 @@ export interface SunoGenerateOptions {
   weirdness?: number;
   /** A list of reference audio URLs for inspiration, requiring 1 to 4 publicly accessible audio addresses. This field is mandatory when `action` is `inspo`. */
   audioUrls?: string[];
-  /** Generate the singer Persona ID used when creating songs based on the unique style characteristics of the specified singer. */
+  /** Singer style or cloned voice Persona ID for generation and cover / upload_cover. For a private voice, first upload the source to /suno/upload with the same persona_id, then use the returned audio_id on the same channel. No vocal_gender is required. */
   personaId?: string;
   /** Continue generating from the specified time point (seconds) of the existing audio. For example, 213.5 means to continue from 3 minutes and 33.5 seconds. */
   continueAt?: number;
@@ -209,6 +209,8 @@ export interface SunoMashupLyricsOptions {
 export interface SunoUploadOptions {
   /** The CDN address (URL) for the custom audio file to be uploaded. */
   audioUrl: string;
+  /** Optional voice Persona ID for standard uploads only. Associate the source audio with this voice before upload_cover; use the returned audio_id and the same persona_id on the same channel. */
+  personaId?: string;
   callbackUrl?: string;
   /** Any parameter added upstream before the SDK is regenerated. */
   [key: string]: unknown;
@@ -228,6 +230,14 @@ export interface SunoMp3Options {
   [key: string]: unknown;
 }
 
+export interface SunoAvailabilityOptions {
+  /** Suno audio ID from a completed task, not the task ID. */
+  audioId: string;
+  callbackUrl?: string;
+  /** Any parameter added upstream before the SDK is regenerated. */
+  [key: string]: unknown;
+}
+
 /** suno client. */
 export class Suno {
   constructor(private transport: Transport) {}
@@ -442,8 +452,9 @@ export class Suno {
   async upload(options: SunoUploadOptions): Promise<Record<string, unknown>> {
     const body: Record<string, unknown> = {};
     body["audio_url"] = options.audioUrl;
+    if (options.personaId !== undefined) body["persona_id"] = options.personaId;
     for (const [key, value] of Object.entries(options)) {
-      if (!["async", "audioUrl", "callbackUrl", "maxWait", "pollInterval", "wait"].includes(key) && value !== undefined) {
+      if (!["async", "audioUrl", "callbackUrl", "maxWait", "personaId", "pollInterval", "wait"].includes(key) && value !== undefined) {
         body[key] = value;
       }
     }
@@ -470,4 +481,17 @@ export class Suno {
     return handle;
   }
 
+  /** Check Suno audio availability. */
+  async availability(options: SunoAvailabilityOptions): Promise<Record<string, unknown>> {
+    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;
+    return (await this.transport.request('POST', "/suno/availability", { json: body })) as Record<string, unknown>;
+  }
+
 }

package/src/resources/webextrator.ts

@@ -2,6 +2,17 @@
 
 import { Transport } from '../runtime/transport';
 
+export interface WebExtratorCookie {
+  name: string;
+  value: string;
+  domain: string;
+  path?: string;
+  expires?: number;
+  httpOnly?: boolean;
+  secure?: boolean;
+  sameSite?: 'Strict' | 'Lax' | 'None';
+}
+
 export class WebExtrator {
   constructor(private transport: Transport) {}
 
@@ -18,9 +29,12 @@ export class WebExtrator {
     userAgent?: string;
     callbackUrl?: string;
     async?: boolean;
+    cookies?: WebExtratorCookie[];
+    bypassCache?: boolean;
+    cacheTtlSeconds?: number;
     [key: string]: unknown;
   }): Promise<Record<string, unknown>> {
-    const { url, expectedType, enableLlm, waitUntil, timeout, delay, waitForSelector, blockResources, headers, userAgent, callbackUrl, ...rest } = opts;
+    const { url, expectedType, enableLlm, waitUntil, timeout, delay, waitForSelector, blockResources, headers, userAgent, callbackUrl, cookies, bypassCache, cacheTtlSeconds, ...rest } = opts;
     const body: Record<string, unknown> = { url, ...rest };
     if (expectedType !== undefined) body.expected_type = expectedType;
     if (enableLlm !== undefined) body.enable_llm = enableLlm;
@@ -32,6 +46,9 @@ export class WebExtrator {
     if (headers !== undefined) body.headers = headers;
     if (userAgent !== undefined) body.user_agent = userAgent;
     if (callbackUrl !== undefined) body.callback_url = callbackUrl;
+    if (cookies !== undefined) body.cookies = cookies;
+    if (bypassCache !== undefined) body.bypass_cache = bypassCache;
+    if (cacheTtlSeconds !== undefined) body.cache_ttl_seconds = cacheTtlSeconds;
     return this.transport.request('POST', '/webextrator/extract', { json: body });
   }
 
@@ -46,9 +63,12 @@ export class WebExtrator {
     userAgent?: string;
     callbackUrl?: string;
     async?: boolean;
+    cookies?: WebExtratorCookie[];
+    bypassCache?: boolean;
+    cacheTtlSeconds?: number;
     [key: string]: unknown;
   }): Promise<Record<string, unknown>> {
-    const { url, waitUntil, timeout, delay, waitForSelector, blockResources, headers, userAgent, callbackUrl, ...rest } = opts;
+    const { url, waitUntil, timeout, delay, waitForSelector, blockResources, headers, userAgent, callbackUrl, cookies, bypassCache, cacheTtlSeconds, ...rest } = opts;
     const body: Record<string, unknown> = { url, ...rest };
     if (waitUntil !== undefined) body.wait_until = waitUntil;
     if (timeout !== undefined) body.timeout = timeout;
@@ -58,6 +78,9 @@ export class WebExtrator {
     if (headers !== undefined) body.headers = headers;
     if (userAgent !== undefined) body.user_agent = userAgent;
     if (callbackUrl !== undefined) body.callback_url = callbackUrl;
+    if (cookies !== undefined) body.cookies = cookies;
+    if (bypassCache !== undefined) body.bypass_cache = bypassCache;
+    if (cacheTtlSeconds !== undefined) body.cache_ttl_seconds = cacheTtlSeconds;
     return this.transport.request('POST', '/webextrator/render', { json: body });
   }
 }