Skip to main content
POST
/
v1
/
audio_to_midi
Python
import requests

url = "https://api.musicgpt.com/api/public/v1/audio_to_midi"
headers = {"Authorization": "<<<api key>>>"}

# Option 1: Use audio URL
payload = {
    "audio_url": "https://example.com/audio_file.wav",
    "sonify_midi": True,
    "save_note_events": True,
    "webhook_url": "https://your-webhook-url.com/callback"
}
response = requests.post(url, headers=headers, data=payload)
print(response.json())

# Option 2: Upload local audio file
payload = {
    "sonify_midi": True,
    "save_note_events": True,
    "webhook_url": "https://your-webhook-url.com/callback"
}
with open("audio.wav", "rb") as f:
    files = {"audio_file": f}
    response = requests.post(url, headers=headers, data=payload, files=files)
print(response.json())
{
  "success": true,
  "task_id": "task789",
  "message": "MIDI conversion task queued successfully"
}

Authorizations

​
Authorization
string
header
required

Body

multipart/form-data
​
audio_url
string
required

URL of the audio file to convert to MIDI.

Example:

"https://example.com/audio.mp3"

​
audio_file
file

Audio file to upload and process directly.

​
sonify_midi
boolean
default:true

If true, generates a .wav file that sonifies the MIDI output.

​
save_note_events
boolean
default:true

If true, saves predicted note events as a CSV file.

​
webhook_url
string

Callback URL to receive conversion results.

Example:

"https://your-webhook-url.com/callback"

Response

MIDI conversion task initiated successfully

​
success
boolean
Example:

true

​
task_id
string
Example:

"task789"

​
message
string
Example:

"MIDI conversion task queued successfully"