@acedatacloud/sdk 2026.727.1 → 2026.728.0

package/package.json

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

package/src/resources/providers/producer.ts

@@ -24,7 +24,7 @@ export interface ProducerUploadOptions {
   [key: string]: unknown;
 }
 
-export interface ProducerGenerateOptions {
+export interface ProducerVideosOptions {
   /** Reference audio ID. */
   audioId: string;
   callbackUrl?: string;
@@ -40,7 +40,7 @@ export interface ProducerWavOptions {
   [key: string]: unknown;
 }
 
-export interface ProducerProducerAudiosOptions {
+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). */
@@ -108,7 +108,7 @@ export class Producer {
   }
 
   /** AceData Producer MP4 retrieval API. Pass an audio_id to receive an MP4 video download link with cover art. */
-  async generate(options: ProducerGenerateOptions): Promise<Record<string, unknown>> {
+  async videos(options: ProducerVideosOptions): Promise<Record<string, unknown>> {
     const body: Record<string, unknown> = {};
     body["audio_id"] = options.audioId;
     for (const [key, value] of Object.entries(options)) {
@@ -134,7 +134,7 @@ export class Producer {
   }
 
   /** Producer AI music generation API, generates 1 song per request. */
-  async producer_audios(options: ProducerProducerAudiosOptions): Promise<TaskHandle> {
+  async generate(options: ProducerGenerateOptions): Promise<TaskHandle> {
     const body: Record<string, unknown> = {};
     body["lyric"] = options.lyric;
     body["action"] = options.action;

package/src/runtime/tasks.ts

@@ -137,6 +137,17 @@ export function taskStatus(state: Record<string, unknown>): 'succeeded' | 'faile
   }
   if (words.length > 0) return '';
 
+  // `success: false` alone is ambiguous — some services set it for a transient
+  // hiccup mid-run, alongside a bare string, and carry on. A *structured* error
+  // (a dict with a code) is the upstream's final answer: hailuo reports an
+  // unavailable model that way, with no finished_at, and treating it as still
+  // running makes the caller poll until timeout instead of showing the reason.
+  if (response.success === false) {
+    const error = response.error as Record<string, unknown> | undefined;
+    const structured = !!error && typeof error === 'object' && !!error.code;
+    if (artifactUrls(state).length > 0 || structured) return 'failed';
+  }
+
   const finished =
     (response.finished_at !== undefined && response.finished_at !== null) ||
     (state.finished_at !== undefined && state.finished_at !== null);