Vocal & Instrument Stem Separation
POST
/api/v1/vocal-removal/generate
Usage Guide
stemNameSeparation Mode Description
Mode (type) | Returned Stems | Typical Use Cases | Credit Cost |
|---|---|---|---|
separate_vocal （default） | 2 stems — Vocals + accompaniment | Quick vocal removal, karaoke, and basic mixing | 10 credits |
split_stem | Up to 12 stems — Vocals, backing vocals, drums, bass, guitar, keyboard, strings, brass, woodwinds, percussion, synthesizer, FX/other; | Advanced mixing, remixing, sound design, and individual instrument extraction | 50 credits |
split_stem_advanced | Up to 12 stems — Same as split_stem, with support for specifying a single target stem through stemName for precise separation | Individual instrument extraction and detailed post-production | 20 credits |
Parameters
| Name | Type | Description |
|---|---|---|
taskId | string | The ID of the original music generation task |
audioUrl | string | The URL of the user-uploaded audio file. Required when processing user-uploaded audio. Cannot be used together with audioId. |
audioId | string | Specifies the audio variant to process when multiple versions exist. Cannot be used together with audioUrl. |
type | string | Separation mode: separate_vocal, split_stem, or split_stem_advanced; defaults to separate_vocal |
stemName | string | Takes effect only when type is split_stem; specifies the name of the individual stem/instrument to separate; |
Developer Notes
separate_vocal returns 2 stems — vocals + accompaniment.split_stem returns up to 12 independent stems — vocals, backing vocals, drums, bass, guitar, keyboard, strings, brass, woodwinds, percussion, synthesizer, and FX/other.split_stem_advanced supports specifying a single target stem through stemName for precise extraction.Callbacks
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.emix.ai/api/v1/vocal-removal/generate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"type": "separate_vocal",
"stemName": "Piano",
"callBackUrl": "https://api.example.com/callback",
"audioUrl": "https://example.com/audio.mp3",
"audioId": "e231****-****-****-****-****8cadc7dc"
}'Response Response Example
{
"msg": "Playground task completed successfully.",
"code": 200,
"data": {
"resultJson": "{\"origin_url\":\"\",\"vocal_url\":\"***\",\"instrumental_url\":\"https://tempfile.aiquickdraw.com/r/b4863fea-784e-46bb-860a-d6052fb554e7_Instrumental.mp3\",\"origin_data\":[{\"duration\":265.76,\"audio_url\":\"***\",\"stem_type_group_name\":\"Vocals\",\"id\":\"7002bb81-5af7-460c-bfeb-c0f98cff9edc\"},{\"duration\":265.76,\"audio_url\":\"https://tempfile.aiquickdraw.com/r/b4863fea-784e-46bb-860a-d6052fb554e7_Instrumental.mp3\",\"stem_type_group_name\":\"Instrumental\",\"id\":\"b4863fea-784e-46bb-860a-d6052fb554e7\"}]}",
"param": "{\"model\":\"suno/separate-vocals\",\"input\":\"{\\\"taskId\\\":\\\"***\\\",\\\"audioId\\\":\\\"5c834fd5-4c9e-4196-9840-d05e048d481a\\\",\\\"type\\\":\\\"separate_vocal\\\"}\",\"callBackUrl\":\"http://localhost:8305/test\"}",
"costTime": 122,
"createTime": 1786345527000,
"completeTime": 1786345661000,
"model": "suno/separate-vocals",
"updateTime": 1786345661000,
"state": "success",
"creditsConsumed": 10.0,
"taskId": "8428871e6b58a3abb71996182000b95d"
}
}