Music Video — turn a song into a video
MV means music video: you supply a song; OmnAPI generates visuals and returns a finished MP4 with that audio. Use a public audio URL or a Suno clip you can access.
OneClick means the video is generated and assembled automatically. OneClick V1, OneClick V2, and Omn V1 are three generation options for the same Music Video API. All use the same create → wait → download workflow.
Choose a workflow
Section titled “Choose a workflow”| Option | Choose it when… | Output and limits |
|---|---|---|
| OneClick V1 | You want a first automatic video with a simple request. | 10–600 seconds; 540p, 720p, or 1080p. Lip-sync and high quality need at least 720p. |
| OneClick V2 | You want to select singing, stage performance, or dance explicitly. | 10–300 seconds; 720p. Singing needs singer portraits. |
| Omn V1 · pilot | You want render tiers up to 1440p, shot edits, or later quality upgrades. | 5–600 seconds for the standard request; explicit performance profiles accept 5–300 seconds. Check capabilities and preflight. |
New here? Create a 10-second OneClick V1 video. For explicit singing or dance, compare V2 with Omn V1. Check availability and the validated price before choosing; version numbers alone do not rank output quality.
Create your first video
Section titled “Create your first video”- Check availability and run free preflight to validate your audio and price.
- Create with that preflight ID, your credit limit, and a saved idempotency key.
- Wait for the returned task to complete, then download the final MP4.
The quickstart includes the requests and result handling.
fast describes automatic assembly; it does not promise an instant result.
API fields for each video option
All three automatic options use mode: "fast". Set these fields inside generation
on both preflight and create to select one explicitly:
| Option | engineVersion | managedVersion |
|---|---|---|
| OneClick V1 | vidu-v1 | oneclick-v1 |
| OneClick V2 | vidu-v2 | premium-v2 |
| Omn V1 | omn-v1 | oneclick-v1 (default), or premium-v2 for performance modes |
Both engines require generation.performanceMode when managedVersion is
premium-v2. Omn V1 also offers generation.renderTier for quality.
If you omit the engine, account rollout rules can select Omn V1 for a compatible request. Preflight confirms the engine and price; an explicit engine stays selected. Existing integration behavior.
Before you generate
Section titled “Before you generate”Generation costs credits. Preflight is free; review its amount before creating. Technical failures without a deliverable follow the refund rules. A subjective quality concern does not automatically qualify for a refund.
Studio Beta (mode: "studio") is a separate, manual workflow: review a
storyboard, render scenes, and assemble the selected shots yourself. Use it only
when you need that control. Studio guide.
Go further
Section titled “Go further”Edit a scene · Add subtitles or references · Prices and refunds · Results and recovery
Save a creative draft · Review the result · All MV endpoints