Vocal & Instrument Stem Separation
POST
/api/v1/vocal-removal/generate
Usage Guide
separate_vocal — 2‑stem splitsplit_stem — up to 12‑stem splitSeparation Mode Details
Mode (type) | Stems Returned | Typical Use | Credit Cost |
|---|---|---|---|
separate_vocal (default) | 2 stems – Vocals + Instrumental | Quick vocal removal, karaoke, basic remixes | 10 Credits |
split_stem | Up to 12 stems – Vocals, Backing Vocals, Drums, Bass, Guitar, Keyboard, Strings, Brass, Woodwinds, Percussion, Synth, FX/Other | Advanced mixing, remixing, sound design | 50 Credits |
Parameter Reference
| Name | Type | Description |
|---|---|---|
taskId | string | ID of the original music‑generation task |
audioId | string | Which audio variation to process when multiple versions exist |
type | string | Required. Separation mode: separate_vocal or split_stem |
Developer Notes
separate_vocal returns 2 stems — vocals + instrumental.split_stem returns up to 12 independent stems — vocals, backing vocals, drums, bass, guitar, keyboard, strings, brass, woodwinds, percussion, synth, FX/other.Callbacks
Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.kie.ai/api/v1/vocal-removal/generate' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"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"
}
}