Skip to main content
GET
/
api
/
v1
/
midi
/
record-info
Get MIDI Generation Details
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
  }
}

Usage Guide

  • Use this endpoint to check the status of a MIDI generation task
  • Access complete MIDI note data once processing is complete
  • Retrieve detailed instrument and note information
  • Track processing progress and any errors that may have occurred

Query Parameters

ParameterTypeRequiredDescription
taskIdstringYesThe task ID returned from the MIDI generation request

Developer Notes

  • The midiData field contains the complete MIDI data as a structured object with instruments and notes
  • MIDI data includes all detected instruments with pitch, timing, and velocity for each note
  • MIDI generation records are retained for 14 days

Authorizations

Authorization
string
header
required

All APIs require authentication via Bearer Token.

Get API Key:

  1. Visit API Key Management Page to get your API Key

Usage: Add to request header: Authorization: Bearer YOUR_API_KEY

Note:

  • Keep your API Key secure and do not share it with others
  • If you suspect your API Key has been compromised, reset it immediately in the management page

Query Parameters

taskId
string
required

The task ID returned from the MIDI generation request

Response

MIDI generation task details retrieved successfully

code
integer

Response status code

Example:

200

msg
string

Response message

Example:

"success"

data
object

MIDI generation task details

I