获取 MIDI 生成详情

GET

/api/v1/midi/record-info

检索 MIDI 生成任务的详细信息,包括所有检测到的乐器的完整音符数据。

使用指南

使用此接口检查 MIDI 生成任务的状态

处理完成后访问完整的 MIDI 音符数据

检索详细的乐器和音符信息

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

状态说明

successFlag: 0: 待执行 - 任务等待执行中

successFlag: 1: 成功 - MIDI 生成成功完成

successFlag: 2: 失败 - 创建任务失败

successFlag: 3: 失败 - 生成MIDI失败

查看 errorCode 和 errorMessage 字段了解失败详情

开发者注意事项

midiData 字段包含完整的 MIDI 数据,是包含乐器和音符的结构化对象

MIDI 数据包含所有检测到的乐器,每个音符都有音高、时间和力度信息

MIDI 生成记录保留 14 天

重要提醒: 当使用人声分离接口的 type: split_stem 参数时，midiData可能为空

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

MIDI 生成任务详情检索成功

Body

🔴500Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.kie.ai/api/v1/midi/record-info?taskId=5c79****be8e' \
--header 'Authorization: Bearer <token>'

Response Example

200 - 成功示例

{
    "code": 200,
    "msg": "success",
    "data": {
        "taskId": "5c79****be8e",
        "recordTaskId": -1,
        "audioId": "e231****-****-****-****-****8cadc7dc",
        "callbackUrl": "https://example.callback",
        "completeTime": 1760335255000,
        "midiData": {
            "state": "complete",
            "instruments": [
                {
                    "name": "Drums",
                    "notes": [
                        {
                            "pitch": 73,
                            "start": 0.036458333333333336,
                            "end": 0.18229166666666666,
                            "velocity": 1
                        },
                        {
                            "pitch": 61,
                            "start": 0.046875,
                            "end": 0.19270833333333334,
                            "velocity": 1
                        }
                    ]
                },
                {
                    "name": "Electric Bass (finger)",
                    "notes": [
                        {
                            "pitch": 44,
                            "start": 7.6875,
                            "end": 7.911458333333333,
                            "velocity": 1
                        }
                    ]
                }
            ]
        },
        "successFlag": 1,
        "createTime": 1760335251000,
        "errorCode": null,
        "errorMessage": null
    }
}

从音频生成 MIDI

人声和乐器分离

获取 MIDI 生成详情

使用指南#

状态说明#

开发者注意事项#

Request

Responses

使用指南

状态说明

开发者注意事项