Skip to main content
GET
/
api
/
v1
/
midi
/
record-info
Get MIDI Generation Details
curl --request GET \
  --url https://api.sunoapi.org/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
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.sunoapi.org/llms.txt

Use this file to discover all available pages before exploring further.

​
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
  • Important: When using vocal separation with type: split_stem, the midiData may be empty.

Authorizations

​
Authorization
string
header
required

🔑 API Authentication

All endpoints require authentication using Bearer Token.

Get API Key

  1. Visit the API Key Management Page to obtain your API Key

Usage

Add to request headers:

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 from 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