- Introduction
- Credits Usage Guide
- Error handling
- Webhook Integration Guide
- suno
- Suno Instructions
- create music (custom mode)POST
- create music (no-custom mode) POST
- create music (Control singer gender) POST
- create music (auto lyrics mode) POST
- extend musicPOST
- concat musicPOST
- cover musicPOST
- remasterPOST
- add vocalPOST
- add instrumentalPOST
- stems basicPOST
- stems fullPOST
- create personaPOST
- create music with personaPOST
- upload musicPOST
- get wavPOST
- get midiPOST
- get musicGET
- riffusion(Deprecated)
- producer
- nuro
- lyrics generation
- get-creditsGET
get midi
POST
https://api.aimusicapi.ai/api/v1/suno/midi
complete song or the single instrumental track clip id (after stems) all can be used;
this endpoint is a synchronous endpoint and requires polling;
Request
Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.Example:
Authorization: Bearer ********************Body Params application/json
Example
{
"clip_id":"29fc9d9e-a550-47d9-bfd2-6640a4025acc"
}Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.aimusicapi.ai/api/v1/suno/midi' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"clip_id":"29fc9d9e-a550-47d9-bfd2-6640a4025acc"
}'Responses
🟢200Success
application/json
Body
Example
{
"code": 200,
"data": {
"midi_url": "https://cdn.sunoapi.com/storage/v1/object/public/midi/suno/4538ed06-ccdd-452d-b90f-c35d29150050.mid",
"instruments": [
{
"name": "Synth Voice",
"notes": [
{
"end": 2.1614583333333335,
"pitch": 64,
"start": 1.34375,
"velocity": 0.49606299212598426
},
{
"end": 2.4322916666666665,
"pitch": 64,
"start": 2.1614583333333335,
"velocity": 0.49606299212598426
},
{
"end": 2.9791666666666665,
"pitch": 58,
"start": 2.4322916666666665,
"velocity": 0.49606299212598426
},
{
"end": 3.1145833333333335,
"pitch": 58,
"start": 2.9791666666666665,
"velocity": 0.49606299212598426
},
{
"end": 3.6614583333333335,
"pitch": 63,
"start": 3.1145833333333335,
"velocity": 0.49606299212598426
},
{
"end": 3.796875,
"pitch": 63,
"start": 3.6614583333333335,
"velocity": 0.49606299212598426
},
{
"end": 3.9322916666666665,
"pitch": 63,
"start": 3.796875,
"velocity": 0.49606299212598426
},
{
"end": 4.34375,
"pitch": 62,
"start": 3.9322916666666665,
"velocity": 0.49606299212598426
},
{
"end": 4.479166666666667,
"pitch": 61,
"start": 4.34375,
"velocity": 0.49606299212598426
},
{
"end": 5.026041666666667,
"pitch": 59,
"start": 4.479166666666667,
"velocity": 0.49606299212598426
},
{
"end": 5.161458333333333,
"pitch": 59,
"start": 5.026041666666667,
"velocity": 0.49606299212598426
},
{
"end": 5.296875,
"pitch": 59,
"start": 5.161458333333333,
"velocity": 0.49606299212598426
},
{
"end": 5.432291666666667,
"pitch": 61,
"start": 5.296875,
"velocity": 0.49606299212598426
},
{
"end": 5.567708333333333,
"pitch": 61,
"start": 5.432291666666667,
"velocity": 0.49606299212598426
},
{
"end": 5.703125,
"pitch": 59,
"start": 5.567708333333333,
"velocity": 0.49606299212598426
},
{
"end": 6.25,
"pitch": 58,
"start": 5.703125,
"velocity": 0.49606299212598426
},
{
"end": 6.385416666666667,
"pitch": 58,
"start": 6.25,
"velocity": 0.49606299212598426
},
{
"end": 6.932291666666667,
"pitch": 63,
"start": 6.385416666666667,
"velocity": 0.49606299212598426
},
{
"end": 7.067708333333333,
"pitch": 63,
"start": 6.932291666666667,
"velocity": 0.49606299212598426
},
{
"end": 7.203125,
"pitch": 63,
"start": 7.067708333333333,
"velocity": 0.49606299212598426
},
{
Modified at 2025-10-24 16:07:29