API pengambilan MIDI

Diperbarui 2026-09-18 · tim Suno-API

Deskripsi endpoint

Endpoint MIDI mengubah track yang sudah memiliki stem menjadi berkas MIDI standar, untuk aransemen, karya kreatif lanjutan, atau impor ke DAW.

Suno tidak menyediakan alamat unduhan berkas MIDI; ia hanya menyediakan data not setiap track (tinggi nada, waktu mulai dan selesai, velocity). Endpoint ini mengubah data not tersebut menjadi berkas MIDI standar (SMF format 1) lalu mengembalikannya langsung, jadi yang Anda terima selalu berkas .mid asli yang bisa dibuka DAW.

Endpoint: POST /api/music/download-file

Halaman ini adalah contoh khusus MIDI. Deskripsi lengkap keluarga unduhan (alamat media, berkas tunggal, pengemasan, pratinjau saat pembuatan) ada di API unduh dan pratinjau media lagu.

Biaya: Gratis. Endpoint ini membaca data not stem yang sudah ada dan tidak memotong kuota.

Parameter permintaan

Headers

Parameter body

Contoh permintaan

curl -X POST https://www.suno-api.io/api/music/download-file \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "song_id": "stem_clip_id",
    "kind": "midi"
  }' \
  --output track.mid

Respons

Isi respons adalah konten biner berkas MIDI, bukan JSON.

Mendapatkan alamat unduhan

Jika perlu alamatnya lebih dulu lalu mengunduh (misalnya untuk mengemas beberapa berkas), panggil ini dulu:

curl -X POST https://www.suno-api.io/api/music/download-url \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"song_id":"stem_clip_id","kind":"midi"}'

{
  "success": true,
  "message": "",
  "data": {
    "song_id": "stem_clip_id",
    "kind": "midi",
    "url": "https://www.suno-api.io/api/music/download?song_id=stem_clip_id&kind=midi"
  }
}

Alamat itu juga memerlukan header Authorization; tanpa kunci API akan mengembalikan 401.

Tentang berkas MIDI

Catatan

• Hanya berlaku untuk track yang sudah memiliki stem: song_id harus ID track yang dikembalikan /api/music/separate, bukan ID lagu asli.
• Stem tanpa not adalah hasil normal: beberapa track (misalnya FX) tidak memiliki not yang bisa ditranskripsikan; dalam kasus itu berkas MIDI valid tanpa not dikembalikan, bukan error.
• MIDI hanya memuat informasi not: volume, pan, dan efek tidak termasuk MIDI; atur timbre sendiri di DAW.
• Minta setiap track secara terpisah: satu permintaan mengembalikan .mid satu track; untuk beberapa track, panggil masing-masing atau gunakan unduhan paket massal di Create UI.