Skip to main content
POST
Full Stem Separation
You can also submit through the unified task endpoint POST /v1/task/submit with model set to suno/stems-all and the parameters inside input. Both behave and bill the same.
When the task succeeds, data.musics holds the tracks it produced.
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
music_id
string
required

Source Track: The track to work on. Use the music_id from an earlier result.

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