Producer API Quickstart

Producer is OmnAPI’s API for image, lyrics, and music generation. Every create call returns a task descriptor; poll the task until it reaches a terminal status.

1. Create cover art

curl -X POST https://api.omnapi.com/api/v1/producer/generate/image \
  -H "x-api-key: $OMNAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "cinematic synthwave album cover, neon skyline, clean typography"
  }'

Response:

{
  "taskId": "task_01J...",
  "status": "PENDING",
  "creditsRequired": 8
}

2. Generate lyrics

curl -X POST https://api.omnapi.com/api/v1/producer/generate/lyrics \
  -H "x-api-key: $OMNAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "English indie pop lyrics about leaving a coastal town at dawn"
  }'

3. Compose the song

curl -X POST https://api.omnapi.com/api/v1/producer/generate/music/compose \
  -H "x-api-key: $OMNAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "soundPrompt": "warm indie pop, jangly guitars, brushed drums, wistful vocal",
    "lyrics": "[Verse]\nThe lighthouse blinks once for you...",
    "title": "Coastal Goodbye",
    "length": 120
  }'

4. Poll the task

curl https://api.omnapi.com/api/v1/tasks/task_01J... \
  -H "x-api-key: $OMNAPI_KEY"

When status is COMPLETED, read resources[] for the audio and cover URLs. Use config.webhookUrl on any create request when you prefer push delivery over polling.

Common prices

Operation	Credits
Image	8
Lyrics	1
Compose	28
Modify	28

See Producer API for every field and Interactive Reference for schemas.