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.kie.ai/api/v1/vocal-removal/generate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"taskId": "5c79****be8e",
"audioId": "e231****-****-****-****-****8cadc7dc",
"callBackUrl": "https://api.example.com/callback",
"type": "separate_vocal"
}'Response Response Example
200 - Example 1
{
"code": 200,
"msg": "success",
"data": {
"taskId": "5c79****be8e"
}
}