人声和乐器分离
POST
/api/v1/vocal-removal/generate
使用指南
分离模式说明
模式（type） | 返回音轨 | 典型用途 | 积分消耗 |
|---|---|---|---|
separate_vocal （默认） | 2 轨 — 人声 + 伴奏 | 快速去人声、卡拉 OK、基础混音 | 10 积分 |
split_stem | 最多 12 轨 — 人声、和声、鼓、贝斯、吉他、键盘、弦乐、铜管、木管、打击乐、合成器、FX/其他； | 进阶混音、重混、声音设计、单乐器提取 | 50 积分 |
split_stem_advanced | 最多 12 轨 — 同 split_stem，并可通过 stemName指定单个目标音轨进行精准分离 | 单乐器提取、精细后期 | 20 积分 |
参数说明
| 名称 | 类型 | 说明 |
|---|---|---|
taskId | string | 原始音乐生成任务的 ID |
audioUrl | string | 用户上传音频文件的 URL 地址。使用用户上传音频时必填。 不可与 audioId 同时使用。 |
audioId | string | 存在多个版本时，指定要处理的音频变体。不可与 audioUrl 同时使用。 |
type | string | 分离模式：separate_vocal 、split_stem或 split_stem_advanced；默认 separate_vocal |
stemName | string | 仅在 type 为 split_stem 时生效，用于指定要分离的单个音轨/乐器名称； |
开发者注意事项
separate_vocal 返回 2 轨 — 人声 + 伴奏。split_stem 返回 最多 12 条独立音轨 — 人声、和声、鼓、贝斯、吉他、键盘、弦乐、铜管、木管、打击乐、合成器、FX/其他。split_stem_advanced 支持通过 stemName 指定单个目标音轨进行精准提取。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
{
"code": 200,
"msg": "success",
"data": {
"taskId": "5c79****be8e"
}
}