Text-to-Music

Suno API for direct song generation workflows

Create Suno songs through simple prompts, custom lyrics, reusable public Voices, and managed upload + Extend/Cover with one OmnAPI task model.

View current credit pricing

Start integrationRead docs

Why teams evaluate this API

Built for teams migrating from Suno-specific integrations or adding direct Suno workflows alongside broader music generation APIs.

Best-fit teams

  • • Apps migrating existing Suno traffic
  • • Creator products that need direct Suno output
  • • Music platforms offering multiple generation modes

Core capabilities

  • • Simple prompt, custom lyrics, Voice, and managed upload + Extend/Cover modes
  • • Task-first response shape with an up-front credit debit and polling
  • • Model override support for teams that need a specific Suno generation family
  • • Shared auth, billing, usage tracking, and task history with the rest of OmnAPI

Typical implementation flow

  1. 1Choose a generation mode and collect prompt, lyrics, style, Voice, or upload source
  2. 2Submit `POST /api/v1/suno/songs` with your API key
  3. 3Poll the returned task until completion
  4. 4Store clip IDs for later Extend/Cover, M4A/MP3/WAV/Stems export, timeline, or Voice workflows

Example request

Set OMNAPI_KEY on your server and create REQUEST_ID once for this logical request. Reuse that ID on transport retries. A new generation can incur a charge; review current pricing first.

curl --fail-with-body --max-time 60 -X POST "https://api.omnapi.com/api/v1/suno/songs" \
  -H "x-api-key: $OMNAPI_KEY" \
  -H "Idempotency-Key: $REQUEST_ID" \
  -H "Content-Type: application/json" \
  --data '{
  "mode": "simple",
  "prompt": "Upbeat city pop, bright guitars, summer night drive",
  "model": "chirp-fenix"
}'

This example selects chirp-fenix explicitly. Save taskId and inspect /api/v1/suno/generations/{taskId} for individual clip playback states; the shared Task API provides execution and billing details.

See the authentication and task quickstart and complete request schema.

FAQ

Is this the same as the Producer Compose API?

No. Producer Compose is a higher-level composition surface. Suno Songs is the direct Suno workflow surface for teams that specifically want Suno generation modes.

Can existing Suno Cloud customers migrate here?

Yes, but the new public API is task-first and uses `/api/v1/suno/*`. Keep a compatibility facade during migration if existing clients cannot change request and response shapes immediately.