获取人声和乐器分离详情

GET

/api/v1/vocal-removal/record-info

获取人声分离任务的详细信息。

使用指南

使用此接口检查人声分离任务的状态

处理完成后访问人声、伴奏和单个乐器轨道的URL

跟踪处理进度和可能发生的任何错误

支持查询 separate_vocal 和 split_stem 两种分离类型的结果

状态说明

PENDING: 任务等待处理中

SUCCESS: 人声分离成功完成

CREATE_TASK_FAILED: 创建分离任务失败

GENERATE_AUDIO_FAILED: 音频处理过程中失败

CALLBACK_EXCEPTION: 回调过程中发生错误

响应数据结构说明

separate_vocal 类型：返回 instrumentalUrl 和 vocalUrl 字段，其他乐器字段为 null

split_stem 类型：返回详细的乐器分离字段，instrumentalUrl 为 null

开发者注意事项

分离的音频文件URL仅在状态为SUCCESS时可用

对于失败的任务提供错误代码和消息

成功处理后，分离的音频文件保留14天

根据原始请求的 type 参数不同，返回的字段结构会有所差异

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

请求成功

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.kie.ai/api/v1/vocal-removal/record-info?taskId=5e72****97c7' \
--header 'Authorization: Bearer <token>'

Response Example

separate_vocal类型查询结果

{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "3e63b4cc88d52611159371f6af5571e7",
        "musicId": "376c687e-d439-42c1-b1e4-bcb43b095ec2",
        "callbackUrl": "https://57312fc2e366.ngrok-free.app/api/v1/vocal-removal/test",
        "musicIndex": 0,
        "completeTime": 1753782937000,
        "response": {
            "id": null,
            "originUrl": null,
            "originData": [
                {
                    "duration": 245.6,
                    "audio_url": "https://example001.mp3",
                    "stem_type_group_name": "Vocals",
                    "id": "3d7021c9-fa8b-4eda-91d1-3b9297ddb172"
                },
                {
                    "duration": 245.6,
                    "audio_url": "https://example002.mp3",
                    "stem_type_group_name": "Instrumental",
                    "id": "d92a13bf-c6f4-4ade-bb47-f69738435528"
                }
            ],
            "instrumentalUrl": "https://file.aiquickdraw.com/s/d92a13bf-c6f4-4ade-bb47-f69738435528_Instrumental.mp3",
            "vocalUrl": "https://file.aiquickdraw.com/s/3d7021c9-fa8b-4eda-91d1-3b9297ddb172_Vocals.mp3",
            "backingVocalsUrl": null,
            "drumsUrl": null,
            "bassUrl": null,
            "guitarUrl": null,
            "pianoUrl": null,
            "keyboardUrl": null,
            "percussionUrl": null,
            "stringsUrl": null,
            "synthUrl": null,
            "fxUrl": null,
            "brassUrl": null,
            "woodwindsUrl": null
        },
        "successFlag": "SUCCESS",
        "createTime": 1753782854000,
        "errorCode": null,
        "errorMessage": null
    }
}

人声和乐器分离

从音频生成 MIDI

获取人声和乐器分离详情

使用指南#

状态说明#