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, Suno direct, Music Video (MV), and task polling.

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/suno/songsDirect Suno song generation
POST/api/v1/suno/clips/{clipId}/deriveExtend, cover, overpaint or underpaint a Suno clip
POST/api/v1/suno/clips/{clipId}/exportWAV, video or stems export
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/{mvId}Read the unified MV view
POST/api/v1/mv/{mvId}/finalizeRecover or recompose the final MP4
GET/api/v1/tasks/{taskId}Poll any task until terminal state

Generation, export, and MV endpoints return a task descriptor. You then read the task by taskId until status 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”