Vocal & Instrument Stem Separation
POST
/api/v1/jobs/createTask
Document updated
Usage Guide
stem_nametype). Failed tasks are not charged. For current prices, see kie.ai/pricing.Separation Mode Description
Mode (type) | Returned Stems | Typical Use Cases |
|---|---|---|
separate_vocal (default) | 2 stems — Vocals + accompaniment | Quick vocal removal, karaoke, and basic mixing |
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 |
split_stem_advanced | Returns 2 groups, each with "extract" (only the target stem) and "remove" (everything except the target stem). | Individual instrument extraction and detailed post-production |
Parameters
| Name | Type | Description |
|---|---|---|
task_id | string | The ID of the original music generation task |
audio_url | string | The URL of the user-uploaded audio file. Required when processing user-uploaded audio. Cannot be used together with audio_id. |
audio_id | string | Specifies the audio variant to process when multiple versions exist. Cannot be used together with audio_url. |
type | string | Separation mode: separate_vocal, split_stem, or split_stem_advanced; defaults to separate_vocal |
stem_name | string | Used only with type split_stem_advanced, where it is required. |
Query Results
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 stem_name 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/jobs/createTask' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "ai-music-api/separate-vocals",
"callBackUrl": "https://api.example.com/callback",
"input": {
"task_id": "5c79****be8e",
"audio_id": "e231****-****-****-****-****8cadc7dc",
"type": "separate_vocal"
}
}'Response Response Example
200 - Example 1
{
"code": 200,
"msg": "success",
"data": {
"taskId": "5c79****be8e"
}
}