Audio-to-MIDI Pro

Suggest instruments

Suggests instruments for the instruments field of an Audio-to-MIDI request. The detector listens to sampled windows of the audio, reported in windows, several times each. Suggestions need review: instruments is exhaustive, so a missing instrument cannot appear in the transcription and a wrong one pulls notes onto the wrong part. Review every suggestion, not only the low-agreement ones, and add anything the detector missed; a missing instrument carries no score at all. Upload the audio once with POST /v2/assets and pass the same asset to this route and to the transcription; for a URL source the response returns the stored copy's asset_id. A detection is free when an Audio-to-MIDI request that succeeds passes its instrument_detection_id. Unused detections are free up to 10 per account in any 24 hours. Past that a detection costs up to 50 credits (never more than transcribing the same audio), charged on success, and those credits come off the transcription that later uses it within 30 days, in the same billing period. Organization keys cannot call this route yet. Send max_credits: 0 to run only when free: past the allowance the request fails with max_credits_exceeded and charges nothing. The same account, audio content and detector revision returns the cached answer free.

post/v2/audio-to-midi/v1.0/instruments

Request

  • Base URL: https://api.mirelo.ai
  • URL: https://api.mirelo.ai/v2/audio-to-midi/v1.0/instruments
  • Auth: HTTP bearer

Request body

max_creditsinteger

The most this request may charge. With 0 the request runs only when it is free and otherwise fails with max_credits_exceeded, charging nothing. Omit it to allow the price.

Example request

{
  "audio": {
    "type": "asset",
    "asset_id": "3f1f4c1e-8a4b-4b8e-9f9e-2b6c1d0a7e55"
  },
  "max_credits": 0
}

Response

Suggested instruments for review

instrument_detection_idstring required

Pass as instrument_detection_id on the Audio-to-MIDI request that uses these suggestions.

detector_revisionstring required

Identifies the detector that produced this answer. A cached answer is reused only for the same revision.

asset_idstring uuid required

The asset that was analysed. For a URL source this is the stored copy; pass it as audio to the Audio-to-MIDI request.

recommended_instrumentsstring[] required

The instruments the detector recommends, ready to pass as instruments after you review them.

credits_chargedinteger required

Credits this request charged. Zero when the detection was free or cached.

free_detections_remaininginteger required

Free unused detections left in the current window.

Changes

No recorded changes to this operation across all 1 revision of this API.