Maestro Videos API
POSThttps://api.acedata.cloud/maestro/videos
Request Headers
authorizationstring
Bearer token
Request Body
langstring
Primary language (e.g. en, zh-cn, ja).
asyncboolean
Return a task_id immediately (recommended) and poll /maestro/tasks.
Please select
musicboolean
Add a Suno music bed.
Please select
aspectstring
Output aspect ratio.
Please select
enginestring
Render engine. ffmpeg = fast lane.
Please select
durationinteger
Target length in seconds (soft). ≤30s and >30s are the two pricing tiers.
source_refstringRequired parameter
The article body (Article) or the topic/brief (Topic).
transitionnumber
Scene crossfade length in seconds (0 = hard cuts).
extra_langsarray
Additional language variants. Each adds a localized voiceover + render (visuals are reused). Billed +6 credits each.
source_typestringRequired parameter
Article = the pasted article body in source_ref; Topic = a short brief in source_ref.
callback_urlstring
Optional. Fired with the result on a terminal state (Completed/Failed).
Response
Maestro
Allow Use General Balance
When 'Allow General Balance' is enabled, the general balance is used automatically if an app's balance is insufficient.
Kind reminder: For streaming requests, the above code may not be fully applicable. Please refer to the integration documentation for changes.