Why teams evaluate this API
Built for music, creator, and campaign products that need an asynchronous music-to-video API with explicit spend controls and a durable project workflow.
Music-to-Video
AI music video API for production and editable workflows
Turn Suno clips or public audio URLs into finished music videos with Fast mode, or use Studio Beta for storyboard, scene-render, selection, and finalization control.
DynamicUse quote APIMVs
Best-fit teams
- • Music and creator platforms shipping automated video output
- • Products that need editable scene workflows after initial generation
- • Campaign teams turning finished audio into social video assets
Core capabilities
- • Fast production path with public availability checks and automatic final MP4 storage
- • Studio Beta storyboard, persistent scene edits, rendering, selection, and finalization
- • Dynamic quotes and create-time media preflight, with idempotent task creation
- • Project-level charge and refund ledger plus signed customer media links
Typical implementation flow
- 1Check Fast availability and request a dynamic quote
- 2Preflight the Suno clip or public audio URL without charging credits
- 3Create an idempotent Fast or Studio task and track it asynchronously
- 4Refresh the final signed URL or continue through Studio scene controls
Modes, controls, and current pricing contract
Fast is the one-request production path. Studio Beta exposes storyboard, scene-render, selection, and finalization steps for products that need review.
| Mode | Use when | Control surface | Billing |
|---|---|---|---|
| Fast | A finished MV is the required output | Availability, quote, preflight, create, status, final URL | Dynamic quote by duration, resolution, and options |
| Studio Beta | Users review and revise scene decisions | Storyboard, stills, scene renders, selections, finalize | Fixed workflow steps plus quoted scene renders |
Fixed catalog operations
Preview price
per request
0 credits
$0.00 on Starter
Compose final copy
per request
2 credits
$0.0057 on Starter
Generate storyboard and scene stills
per storyboard task
250 credits
$0.7143 on Starter
Regenerate scene still
per scene
10 credits
$0.0286 on Starter
Finalize selected scene renderings
per request
50 credits
$0.1429 on Starter
Read MV state and final URL
per request
0 credits
$0.00 on Starter
Quoted operations
One-click MV generationQuote API
standard 540p: 6 Vidu credits/sec; lip-sync unsupported · 60s example: 720 credits
One-click MV generationQuote API
standard 720p: 8 Vidu credits/sec, optional lip-sync +4/sec · 60s example: 960 credits
One-click MV generationQuote API
standard 1080p: 10 Vidu credits/sec, optional lip-sync +4/sec · 60s example: 1,200 credits
One-click MV generationQuote API
high 720p: 24 Vidu credits/sec · 60s example: 2,880 credits
One-click MV generationQuote API
high 1080p: 29 Vidu credits/sec · 60s example: 3,480 credits
SingingQuote API
managedVersion=premium-v2, performanceMode=sing, 720p, 1-2 ordered singer portraits · 60s example: 2,880 credits
Singing + performanceQuote API
managedVersion=premium-v2, performanceMode=sing_perform, 720p, 1-2 ordered singer portraits · 60s example: 2,880 credits
PerformanceQuote API
managedVersion=premium-v2, performanceMode=perform, 720p, 1-6 scene or performance references · 60s example: 2,520 credits
DanceQuote API
managedVersion=premium-v2, performanceMode=dance, 720p, 1-6 scene or dance references · 60s example: 2,880 credits
Add lip-syncQuote API
Adds 4 Vidu credits/sec to Fast MV duration · 60s example: +480 credits
Render scene videoQuote API
expectedVersion, videoProvider, videoModel, resolution, fps, duration
POST /api/v1/mv/quote → POST /api/v1/mvView the complete MV price tableFAQ
When should I use Fast instead of Studio?
Use Fast for the production one-click path. Use Studio Beta when your product needs human review, persistent scene edits, rendering choices, and controlled finalization.
How is music video pricing calculated?
Pricing is dynamic by mode, duration, resolution, selected operation, and optional features. Use the Quote API before every paid operation; for initial Fast or Studio creation, use preflight to validate media before authorizing credits.
Does the API accept uploaded audio bytes?
The public API accepts Suno clip IDs or caller-hosted public audio URLs. The first-party web app can upload an asset and then submits its resulting URL through the same MV workflow.
How long does AI music video generation take?
The create receipt may include a queue-aware estimated completion time, but delivery varies with duration, mode, and generation capacity. Production integrations should poll the Task API or use webhooks until the task is terminal.
Are finished music video URLs permanent?
No. Scene and final media use signed links. Read the MV or final endpoint again when a link expires; the media retention window is separate from link lifetime.