Maestro — AI Video Studio
One sentence, one finished video — describe what you want and Maestro generates a captioned, multi-language video, with your own reference media and remixing.
Your API key is pre-filled in the snippet — copy and run it in your terminal or IDE.
This is only a basic call example. See the full docs for more parameters and advanced usage.
Maestro AI Video Master
One sentence, one complete film. Describe the video you want in natural language, and the AI director automatically writes the script, creates visuals, provides voiceovers, composes music, and renders, producing a complete film with subtitles. Supports reference materials, multi-language output, and secondary creation.
Core Features
Not a fixed template, but an AI director that creates—freely arrange each video according to your intent.
One sentence to a complete film
Simply describe the theme, what to showcase, style, and audience in the prompt, and the AI automatically completes the script, visuals, voiceover, music, subtitles, and rendering, producing a publishable complete film.
Multi-language output at once
Fill in multiple languages in langs, reuse the same visuals with only new voiceovers and rendering, and get multi-language versions like Chinese, English, Japanese, etc., in one task, making overseas distribution easier.
Use your own materials
Attach reference images, videos, or audio via file_urls—let product images, logos appear, or add text and subtitles to existing materials.
Iterative secondary creation
Use action: remix / edit / extend along with ref_task_id to make incremental modifications on existing videos: change titles, swap voiceovers, adjust colors—small changes are quick, large changes require a redo.
Submit once, retrieve video asynchronously
Submit prompt to immediately return task_id, then poll /maestro/tasks to retrieve the video—polling is free. You can also pass callback_url for a callback when completed.
curl -X POST https://api.acedata.cloud/maestro/videos \
-H "authorization: Bearer YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{
"prompt": "Explain what a vector database is in 20 seconds, suitable for a zero-based audience",
"langs": ["zh-cn", "en"],
"aspect": "9:16",
"duration": 20
}'
# Immediately return task_id:
# {
# "success": true,
# "task_id": "f57e99c4f60f4373a15517742ce2357d",
# "trace_id": "3ded4959-7b11-4b5a-b7f8-c1aab6a7063c"
# }
# Polling to retrieve video (free):
curl -X POST https://api.acedata.cloud/maestro/tasks \
-H "authorization: Bearer YOUR_API_KEY" \
-H "content-type: application/json" \
-d '{ "id": "f57e99c4f60f4373a15517742ce2357d" }'
Quick Start in 3 Steps
From a description to getting the final video, it only takes a few minutes.
Write a prompt
Describe the video you want in a natural language sentence, selecting the language, aspect ratio, and duration as needed.
Submit the task
Call POST /maestro/videos to immediately get task_id.
Poll to retrieve video
Use POST /maestro/tasks to poll and retrieve the final videos in various languages after completion.
What is Maestro suitable for?
From knowledge popularization to product promotion, covering most short video needs.
Knowledge Popularization
Turn a topic or an article into a subtitled explanatory short video, explaining a concept in a few minutes.
Product Promotion
Use file_urls to include product images and logos, producing high-quality brand videos.
Social Media Short Videos
Generate 9:16 vertical short videos with one click, suitable for distribution on platforms like Douyin, Reels, and Shorts.
Multilingual Expansion
Produce multiple language versions from the same footage in one go, eliminating the need for repeated production for content expansion.
Content Marketing
Batch convert blogs, announcements, and tutorials into short videos, amplifying content reach.
Video Remix / Add Subtitles
Add captions and subtitles to existing materials, or make derivative creations on past completed works.
Four Creative Actions
From brand new generation to incremental iteration, a single interface covers the complete creative process.
🎬 Generate
Generate a brand new video from a prompt (can include file_urls)—default action.
♻️ Remix / Edit / Extend
Make incremental modifications or extensions based on ref_task_id on existing projects—change title, switch voiceover, adjust colors, continue writing.
Maestro Pricing
Charged per piece, no subscription fee, no hidden costs.
Task polling is free, failures do not affect subsequent creations
Charged based on video length (up to 10 minutes), longer is more expensive, multilingual versions added as needed
- ✓ 30 seconds $10.57 · 2 minutes $25.14 · 10 minutes $102.83
- ✓ Draft version 0.5× / Premium version 2×
- ✓ Each additional language +$0.57
- ✓ Task polling——Free
Exclusive plans for high-usage teams
- ✓ Tiered discounts based on usage
- ✓ Priority support with account manager
- ✓ Higher concurrency and capacity
- ✓ SLA guarantee
- ✓ Private deployment solutions
Frequently Asked Questions
Common questions about using the Maestro API
How does Maestro charge?›
Charged per piece, with a pre-deduction based on target duration at submission: points ≈ (60 + 1.7 × duration in seconds) × quality multiplier. For example, about $10.57 for 30 seconds, about $25.14 for 2 minutes, and about $102.83 for 10 minutes (maximum). Quality tiers: draft 0.5×, premium 2×. langs Each additional language +$0.57 (reuse footage, only additional voiceover and rendering). Polling for task results is free.
What languages are supported?›
Supports Chinese, English, Japanese, Korean, Spanish, French, German, etc. Specify using the langs array, with the first element as the primary language, and the rest will reuse footage to generate localized voiceovers and rendering.
Can I use my own images or videos?›
Yes. Pass the URLs of images, videos, or audio through file_urls, and AI will incorporate them into the final piece—such as featuring product images or logos, or adding subtitles to existing materials.
How long does it take to produce a video?›
This is an asynchronous task: after submission, task_id is returned immediately, and the final piece is usually completed within a few minutes (larger or multilingual tasks may take longer). Poll /maestro/tasks or use callback_url to get results.
Can I modify an existing video?›
Yes. Use action: remix / edit / extend along with the previous task's ref_task_id to make differential edits or extensions on the original project; small changes will be quick, while large changes will require regeneration.
Explore More AI Video Services
Ace Data Cloud offers a variety of AI video generation APIs
Start Generating Videos with Maestro Now
A one-sentence description, get multilingual videos with subtitles in minutes. Let creativity have no boundaries.
Maestro video generation API — orchestrate a complete video from a natural-language prompt.
Maestro task query API — check the status and result of a Maestro video generation job.
Packages
We offer various credit packages. The more you purchase, the higher the discount you receive.
up to37% OFF