Skip to content
OmnAPI Docs

OmnAPI Postman Starter Collection

Reference

Download the public collection:

Download omnapi-public.postman_collection.json

After importing:

  1. Set baseUrl to https://api.omnapi.com.
  2. Set apiKey to your sk_live_... key.
  3. Run a create request.
  4. Copy the returned taskId into the collection variable.
  5. Run Tasks → Get Task until the task is terminal.

Each create request saves a UUID in its own requestKey_... collection variable on first send. Keep that variable and the body unchanged for recovery after a timeout. For a new logical job, clear that request’s variable first; the next send will generate and save a new key. Do not clear keys while a result is uncertain. Keep the API key local and remove it before exporting or sharing the collection. Send requests individually; create and storage-enrollment requests can charge credits.

For Suno songs or derives, also copy generationId into the collection variable and use Suno → Get Generation for candidate-level delivery. Once a clip has playable: true and a non-null playback.url, resolve that URL against baseUrl and use Suno → Play Returned Audio. Supply playbackUrl as a local, unsynced variable and clear it afterward. This request sends no API key and returns audio, not JSON. You can also open the URL directly in a browser. A live response can remain open while audio is generated; stop it when finished. No SSE subscription or playback-session request is required. Refresh Get Generation if the URL expires or playback fails. Do not export or share temporary media URLs. See the playback guide.

Copy any returned external clipId into clipId for direct clip reads, Extend/Cover, WAV, or Stems.

For a recording-based Voice, run Suno → Get Voice Verification Phrase, copy its completed taskId into voicePhraseTaskId, update both recording URLs in Create Public Voice from Recording, and copy the final Voice ID into voiceId.

The collection is a curated starter set rather than an exhaustive mirror of every OpenAPI operation. It includes:

FolderRequests
ProducerGenerate Image, Compose Music
SunoSong generation, Generation polling and audio playback, direct clip reads, Extend/Cover, WAV/Stems, analysis, managed upload workflows, and Voice verification/create/list/detail/use
Suno StorageList assets, get a fresh download URL, inspect storage availability/rate, enable storage at an explicitly accepted rate, and list charges
MV FastQuote, Preflight, Create, read, scene edit quote/edit, recompose quote/finalize, and final URL
SubtitlesQuote, create, and poll Subtitle Sync
TasksGet Task

For the complete schema surface, use the Interactive Reference.

Before enabling storage, read Suno Storage → Get Storage Enrollment and Rate. Proceed only when available is true and you accept the published rate. Copy its exact publishedRateUnitsPerGbMonth string into acceptedStorageRateUnits. See retention, cancellation, and scope requirements.