v1

latestOpenAPI 3.0.02026-07-26355125.0 KB

Get MIDI Generation Details

Retrieve detailed information about a MIDI generation task including complete note data for all detected instruments.

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

Status Descriptions

  • successFlag: 0: Pending - Task is waiting to be executed
  • successFlag: 1: Success - MIDI generation completed successfully
  • successFlag: 2: Failed - Failed to create task
  • successFlag: 3: Failed - MIDI generation failed
  • Check errorCode and errorMessage fields for failure details

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
get/api/v1/midi/record-info

Query parameters

taskIdstring required

The task ID returned from the MIDI generation request

Response

MIDI generation task details retrieved successfully

codeinteger

Response status code

msgstring

Response message

Example response

{
  "code": 200,
  "msg": "success",
  "data": {
    "midiData": {
      "state": "complete"
    }
  }
}