Suno API Quickstart

Use /api/v1/suno/* for new Suno-compatible music workflows. Existing Suno Cloud clients can find migration mappings in the full Suno API guide.

1. Generate a song

curl -X POST https://api.omnapi.com/api/v1/suno/songs \
  -H "x-api-key: $OMNAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "simple",
    "prompt": "upbeat city pop, bright guitars, summer night drive",
    "model": "chirp-fenix",
    "config": {
      "metadata": { "source": "suno-quickstart" }
    }
  }'

Response:

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

2. Poll for music resources

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

When the task completes, copy the returned Suno clip id from resources[] or outputResults[].

3. Read the clip

curl "https://api.omnapi.com/api/v1/suno/clips/clip_123" \
  -H "x-api-key: $OMNAPI_KEY"

Read endpoints follow the same task lifecycle, but they are optimized for short requests. A long response may return 202 with a task id; poll that task the same way.

4. Export WAV or stems

curl -X POST https://api.omnapi.com/api/v1/suno/clips/clip_123/export \
  -H "x-api-key: $OMNAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "format": "wav" }'

curl -X POST https://api.omnapi.com/api/v1/suno/clips/clip_123/export \
  -H "x-api-key: $OMNAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "format": "stems", "stemsMode": "two" }'

Common prices

Operation	Credits
Song generation / derive	28
Lyrics / reads	0
Upload / WAV / persona	5
Video export	10
Two-stem export	28
Twelve-stem export	140

See Suno API for derive actions, persona creation, uploads, and migration mappings.