@acedatacloud/sdk 2026.1009.1 → 2026.1011.0

package/README.md

@@ -139,6 +139,32 @@ The public model ID also works with `client.openai.images.generate(...)` and
 `client.openai.images.edit(...)`; those use the OpenAI-compatible fields
 (`image` for editing) and return response objects, not task handles.
 
+## Maestro Video Production
+
+Use the provider client to request one finished video in one language:
+
+```typescript
+const task = await client.maestro.generate({
+  prompt: 'Explain vector databases to beginners in 20 seconds',
+  langs: ['en'],
+  aspect: '9:16',
+  duration: 20,
+  scenario: 'narrated',
+});
+const result = await task.wait();
+```
+
+`langs` defaults to `['zh-cn']` and must contain exactly one language; create
+separate tasks for other languages. The completed result contains one video in
+`response.data.variants`. To revise a video, use `action: 'remix'`, `'edit'`, or
+`'extend'` with `refTaskId: task.id`.
+
+There is no quality tier: all videos use 1080p/30fps and target durations of
+5–300 seconds. Successful tasks cost **0.7 Credits per actual delivered second**,
+with integer billed seconds capped at the requested duration (falling back to
+that duration if it cannot be read). All scenarios, actions, and languages have
+the same rate; failed tasks and `/maestro/tasks` polling are free.
+
 ## Multi-Provider Support
 
 Image, video, and audio resources support a `provider` parameter to switch between services:

package/dist/index.js

@@ -1876,7 +1876,7 @@ var Maestro = class {
     this.transport = transport;
   }
   transport;
-  /** Call /maestro/videos. */
+  /** Maestro Videos */
   async generate(options) {
     const body = {};
     body["prompt"] = options.prompt;
@@ -1886,15 +1886,17 @@ var Maestro = class {
     body["langs"] = options.langs ?? ["zh-cn"];
     body["aspect"] = options.aspect ?? "9:16";
     body["duration"] = options.duration ?? 30;
-    body["quality"] = options.quality ?? "standard";
     body["scenario"] = options.scenario ?? "auto";
     body["style"] = options.style ?? "auto";
     body["voice"] = options.voice ?? "auto";
     for (const [key, value] of Object.entries(options)) {
-      if (!["action", "aspect", "async", "callbackUrl", "duration", "fileUrls", "langs", "maxWait", "pollInterval", "prompt", "quality", "refTaskId", "scenario", "style", "voice", "wait"].includes(key) && value !== void 0) {
+      if (!["action", "aspect", "async", "callbackUrl", "duration", "fileUrls", "langs", "maxWait", "pollInterval", "prompt", "refTaskId", "scenario", "style", "voice", "wait"].includes(key) && value !== void 0) {
         body[key] = value;
       }
     }
+    if (body["langs"].length !== 1) {
+      throw new Error("langs must contain exactly one item");
+    }
     if (options.callbackUrl !== void 0) body.callback_url = options.callbackUrl;
     body.async = options.async ?? true;
     const result = await this.transport.request("POST", "/maestro/videos", { json: body });