人声和乐器分离
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.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",
"taskId": "5c79****be8e",
"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"
}
}