Suno Sound Effects API

What is Suno Sound Effects?#

Suno Sound Effects is a generation endpoint for short sounds: hits, ambiences, foley, risers, UI cues, and rhythmic loops. Unlike the export and editing operations in the Suno family, it does not need a clip_id. You start from a text prompt, pick a model version with mv, and choose whether you want a one-shot or a loop. For sounds that have to sit inside music, bpm (1 to 300) and key (any major or minor key) keep the result in time and in tune with the rest of your track. The finished task returns clips in the same shape as Suno music generation, so the clip IDs work with the export endpoints if you need a WAV or MP3 copy.

Key features of Suno Sound Effects#

Five parameters do most of the work.

One-shot or loop output

type accepts one-shot (the default) or loop. One-shots suit hits, pickups, and notifications. Loops suit beds, textures, and percussion you want to repeat under a track.

Tempo and key control

Pass bpm from 1 to 300 and a key such as Am or F# to match a project. Useful for risers, stingers, and loops that have to line up with existing music.

Three v6 model versions

Set mv to chirp-hawk for the standard v6 model, chirp-hawk-wild for more experimental results, or chirp-goose for a faster, lighter v6 Mini.

Negative tags for cleaner effects

List what to avoid in negative_tags. Keeping music, vocals, or heavy reverb out of a result matters more for effects than for songs.

Inline custom model

Set mv to chirp-custom and pass a custom_model with a name and reference audio_urls to push results toward your own sound palette. The model is not saved, so resend it with each request.

Best for#

Use cases#

Build a sound design panel inside a game editor that sends a prompt, type, and optional bpm to suno-ai/sound and drops the result into the asset browser. Add a loop generator to a music app that reads the project tempo and key and passes them through, so every loop arrives in sync. Generate a set of notification sounds for an app by looping over prompts with the same key. Once a sound is ready, pull an editable file with the Suno WAV Download API. For full songs instead of effects, use Suno music generation.

API examples#

Every parameter and the list of valid keys is at docs.unifically.com/models/audio/suno/sound.

curl -X POST https://api.unifically.com/v1/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "suno-ai/sound",
    "input": {
      "prompt": "dog barking in street",
      "mv": "chirp-hawk",
      "title": "Dog Bark",
      "type": "one-shot",
      "bpm": 120,
      "key": "Am"
    }
  }'

The response contains a task_id. Poll GET /v1/tasks/<task_id> or set a callback_url on the request to receive the generated clips when they are ready.