跳转到主要内容
GET
/
api
/
v1
/
midi
/
record-info
获取 MIDI 生成详情
curl --request GET \
  --url https://api.kie.ai/api/v1/midi/record-info \
  --header 'Authorization: Bearer <token>'
{
  "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 音符数据
  • 检索详细的乐器和音符信息
  • 跟踪处理进度和可能发生的任何错误

查询参数

参数名称类型必填说明
taskIdstringMIDI 生成请求返回的任务 ID

开发者注意事项

  • midiData 字段包含完整的 MIDI 数据,是包含乐器和音符的结构化对象
  • MIDI 数据包含所有检测到的乐器,每个音符都有音高、时间和力度信息
  • MIDI 生成记录保留 14 天

Authorizations

Authorization
string
header
required

所有接口都需要通过 Bearer Token 方式进行认证。

获取 API Key:

  1. 访问 API Key 管理页面 获取您的 API Key

使用方式: 在请求头中添加: Authorization: Bearer YOUR_API_KEY

注意事项:

  • 请妥善保管您的 API Key,不要泄露给他人
  • 如果怀疑 API Key 泄露,请立即在管理页面重置

Query Parameters

taskId
string
required

MIDI 生成请求返回的任务 ID

Response

MIDI 生成任务详情检索成功

code
integer

响应状态码

Example:

200

msg
string

响应消息

Example:

"success"

data
object

MIDI 生成任务详情

I