Skip to main content
POST
Sound Effects
You can also submit through the unified task endpoint POST /v1/task/submit with model set to suno/sounds and the parameters inside input. Both behave and bill the same.
When the task succeeds, data.musics holds the tracks it produced, 1 per run. On partial success you are billed for the tracks that actually succeeded.
string
required
Track ID. Pass it to extend, cover, stem separation, export and other follow-up actions.
string
Title.
string
Style tags.
string
Lyrics. Instrumentals do not include this field.
string
Audio URL, downloadable directly.
string
Cover image URL.
string
Large cover image URL.
string
Video URL. Omitted when there is no video.
number
Duration in seconds.

Authorizations

Authorization
string
header
required

Send your API key in the Authorization: Bearer YOUR_API_KEY header.

Body

application/json
sound
string
required

Sound Description: Describe the sound you want, e.g. 'a single soft rain drop'.

mv
enum<string>
default:chirp-v6

Model Version: All three versions are priced the same; pick by the style you want. Options: chirp-v6 v6 (default); chirp-v6-wild v6 Wild (bolder); chirp-v6-mini v6 Mini (faster).

Available options:
chirp-v6,
chirp-v6-wild,
chirp-v6-mini
type
enum<string>
default:one-shot

Sound Type: A one-shot hit, or a seamlessly looping sound.

Available options:
one-shot,
loop
bpm
string

BPM: Beats per minute, between 1 and 300.

key
enum<string>

Key: Musical key of the sound.

Available options:
C,
C#,
Cm,
C#m,
D,
D#,
Dm,
D#m,
F,
F#,
Fm,
F#m,
G,
G#,
Gm,
G#m,
A,
A#,
Am,
A#m,
B,
B#,
Bm,
B#m
audio_format
enum<string>

Output Format: Format of the finished audio. Defaults to mp3. Options: mp3 MP3 (common); m4a M4A; wav WAV (lossless).

Available options:
mp3,
m4a,
wav
notify_hook
string<uri>

Notify hook: when the task ends, the same content as the fetch result is POSTed to this URL (a public http / https URL). Omit it to poll instead.

Response

OK

code
enum<string>
required
Available options:
success
data
object
required
message
string