Skip to content
OmnAPI Docs

OmnAPI AI Music, Image, Lyrics, and Music Video API

OmnAPI is a multimodal AI API platform. You issue one API key and call one base URL for image, lyrics, music, and music-video generation. OmnAPI standardizes authentication, task polling, webhooks, rate limits, and credit accounting across supported products.

What’s available today

Section titled “What’s available today”

The public surface covers Producer for image, lyrics, and music generation, structured Lyrics Generation, Suno direct, Music Video (MV), Subtitle Sync, task operations, pricing, and usage export.

VerbEndpointPurpose
POST/api/v1/producer/generate/imageOne-shot image generation
POST/api/v1/producer/generate/lyricsThemed lyrics with structure tags
POST/api/v1/producer/generate/music/composeFull song from a sound prompt
POST/api/v1/producer/generate/music/modifyExtend / cover / inpaint an existing clip
POST/api/v1/lyrics/generateStructured lyrics package with language plan and music-ready prompts
POST/api/v1/suno/songsDirect Suno song generation
POST/api/v1/suno/clips/{clipId}/deriveExtend (with automatic Concat) or Cover an existing Suno clip
POST/api/v1/suno/clips/{clipId}/exportWAV or stems export
GET/api/v1/suno/generations/{generationId}Read candidates and playable Suno clips while processing
POST/api/v1/mv/quotePreview Fast or Studio MV credit cost
POST/api/v1/mv/preflightValidate MV create resources and get a reusable estimate
POST/api/v1/mvCreate a Fast or Studio music video
GET/api/v1/mv/fast/availabilityCheck current Fast MV delivery health
GET/api/v1/mv/{mvId}Read the unified MV view
POST/api/v1/mv/{mvId}/finalizeRecover or recompose the final MP4
POST/api/v1/subtitlesExtract lyrics and subtitle timing from public audio
GET/api/v1/pricing/catalogPublic credit pricing catalog
GET/api/v1/usage/exportAuthenticated usage export for reporting
GET/api/v1/tasks/{taskId}Poll any task until terminal state
POST/api/v1/tasksGeneric task creation by public model path

Generation, export, and MV endpoints return an execution task descriptor. Suno song and derive receipts also return a generationId product view with per-clip states and early playable URLs. Read the task by taskId until execution reaches a terminal state. See The Task Model for the lifecycle, request config, polling, and sync/async behavior shared by every endpoint.

For long-running tasks such as MV generation, subscribe to Webhook Events instead of polling at a fast cadence. Stage events can be used for progress indicators and operations dashboards.

The mental model

Section titled “The mental model”
You ──[x-api-key]──► api.omnapi.com
                         │
        POST /producer/* │ creates a task, returns { taskId, status: "PENDING", creditsRequired }
                         │
        GET  /tasks/{taskId} │ poll until status ∈ { COMPLETED, FAILED, CANCELLED }
                         │
                         ▼
                       Output: resources (URLs) + creditsCharged

Every generation task goes through the same lifecycle, returns the same envelope, and bills against the same credit balance.

When OmnAPI is a fit

Section titled “When OmnAPI is a fit”
  • You want one auth surface across image, lyrics, music, and music video.
  • You want transparent credit pricing (no per-vendor SKUs to compare).
  • You’re OK with async generation (submit → poll). Synchronous-only flows aren’t the focus.

Current boundaries

Section titled “Current boundaries”
  • You need a single vendor with the lowest possible latency and do not need a shared task model.
  • You need streaming token output for chat-style LLMs; OmnAPI is focused on generation tasks.

Up next

Section titled “Up next”