Skip to main content
POST
Suno Stem Split

Headers

Authorization
string

Body

application/json
model
enum<string>
required

Model name. Must be suno-stem-split.

Available options:
suno-stem-split
task_id
string

The img_uuid of one of your earlier successful Suno tasks that produced songs (suno-v6, suno-extend, suno-cover, suno-add-vocals, suno-add-instrumental, suno-replace-section or suno-mashup). Must be sent together with audio_id.

audio_id
string

The audio_id of the song to use, taken from that task's result (json[].audio_id). Must be sent together with task_id.

audio_url
string<uri>

Alternative to task_id + audio_id: a public URL of any audio file, up to 20 MB.

mode
enum<string>
default:vocals

vocals (default): 2 stems, vocals + instrumental (vocal remover / karaoke). stems: up to 12 stems. single: extract one instrument named in stem_name.

Available options:
vocals,
stems,
single
stem_name
enum<string>

Required when mode is single (case-insensitive), not allowed otherwise. The instrument to extract.

Available options:
Lead Vocal,
Drum Kit,
Kick,
Snare,
Risers,
Bass,
Backing Vocals,
Piano,
Electric Guitar,
Percussion,
String Section,
Synth,
Acoustic Guitar,
Sound Effects,
Synth Pad,
Synth Bass,
Guitar,
Brass Section,
Organ,
Electronic Drum Kit,
Lead Electric Guitar,
Synth Keys,
Rhythm Electric Guitar,
Electric Piano,
Upright Bass,
Keyboards,
Distorted Electric Guitar,
Synth Strings,
Synth Lead,
Woodwinds,
Rhythm Acoustic Guitar,
Flute,
Harp,
Tambourine,
Trumpet,
Arpeggiator,
Accordion,
Fiddle,
Pedal Steel Guitar,
Synth Voice,
Violin,
Digital Piano,
Synth Brass,
Mandolin,
Choir,
Banjo,
Bells,
Clarinet,
Tenor Saxophone,
Trombone,
Shaker,
French Horn,
Glockenspiel,
Electric Bass,
Cello,
Timpani,
Harmonica,
Marimba,
Vibraphone,
Lap Steel Guitar,
Saxophone,
Orchestra,
Horns,
Cymbals,
Hand Clap,
Oboe,
Celesta,
Congas,
Drone,
Alto Saxophone,
Double Bass,
Ukulele,
Harpsichord,
Baritone Saxophone,
Xylophone,
Tuba,
Bass Guitar,
Whistle,
Lead Guitar,
Rhodes,
808,
Bongos,
Bassoon,
Cowbell,
Viola,
Sitar,
Steel Drums,
Piccolo,
Theremin,
Bagpipes,
Hi-Hat,
Music Box,
Melodica,
Tabla,
Koto,
Djembe,
Taiko,
Didgeridoo
custom_callback_url
string<uri>

Optional. A publicly accessible HTTPS URL. When the task status changes (processing / success / failed), GoEnhance sends a POST request to this URL. The request body is identical to the response of GET /api/v1/jobs/detail. If your server does not respond with HTTP 200, the notification is retried up to 3 times, with a 3-second timeout per attempt.

Example:

"https://your-server.com/goenhance/callback"

Response

code
integer
required
msg
string
required
data
object
required