OmnAPI AI Music, Image, Lyrics, and Music Video API
Overview
Choose a product for the result you need. OmnAPI uses one server-side API key and credit balance, with Task receipts for asynchronous work.
Choose a product
Section titled “Choose a product”| Your goal | Start here | What you receive |
|---|---|---|
| Generate a song from a sound prompt | Producer | MUSIC resources, with optional lyrics and artwork |
| Generate or derive Suno songs | Suno | A Generation with song candidates and a billing Task |
| Turn a song into a music video | Music Video | A video workflow, scenes, and final video URLs |
| Run a selected video, image, or audio operation | Vidu | Operation-specific generated resources |
| Create a structured lyric package | Lyrics | Lyrics, language plans, and music-ready prompts |
| Crop, repeat, reorder, or fade audio | Audio editing | One edited MP3 or WAV |
| Extract timed lyrics from audio | Subtitles | Timeline and subtitle files |
For a minimal integration, create your first task.
Understand the shared workflow
Section titled “Understand the shared workflow”- Authenticate with a server-side API key and review the operation’s price.
- Submit a request with a saved idempotency key where supported.
- Save the receipt before waiting. Acceptance does not mean output is ready.
- Read the Task until terminal, or receive a webhook.
- Consume the product’s result and retain needed files before expiry.
The Task model explains execution and billing fields. Product views can differ: Suno Generations expose candidates and live playback, while Music Video provides scene and final-video views. Follow the product guide for its result paths instead of assuming every HTTP response has one shape.
Before paid work
Section titled “Before paid work”Check authentication, permissions, and credits and settlement. A published endpoint may have operation- or account-specific availability. The receipt and actual availability response remain authoritative.
If a write times out, recover the original operation before creating another one. OmnAPI is focused on media generation workflows; these guides do not describe a streaming chat-token API.
Continue
Section titled “Continue”- SDKs — TypeScript and Python setup.
- Endpoint directory — find a method, field, or response.
- Interactive explorer — inspect and try an operation.
- Legacy Suno compatibility — for existing compatibility clients.