API pengambilan MIDI

Dikemas kini 2026-09-18 · pasukan Suno-API

Penerangan endpoint

Endpoint MIDI menukar trek yang sudah mempunyai stem kepada fail MIDI standard, untuk susunan muzik, kerja kreatif lanjutan atau import ke DAW.

Suno tidak menyediakan alamat muat turun fail MIDI; ia hanya menyediakan data not setiap trek (pic, masa mula dan tamat, halaju). Endpoint ini menukar data not itu kepada fail MIDI standard (SMF format 1) dan memulangkannya terus, jadi apa yang anda terima sentiasa fail .mid sebenar yang boleh dibuka oleh DAW.

Endpoint: POST /api/music/download-file

Halaman ini ialah contoh khusus MIDI. Penerangan penuh keluarga muat turun (alamat media, fail tunggal, pembungkusan, pratonton semasa penjanaan) ada dalam API muat turun dan pratonton media lagu.

Pengebilan: Percuma. Endpoint ini membaca data not stem sedia 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

Badan respons ialah kandungan binari fail MIDI, bukan JSON.

Mendapatkan alamat muat turun

Jika perlu alamat dahulu kemudian baharu memuat turun (contohnya untuk membungkus beberapa fail), panggil ini dahulu:

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 pengepala Authorization; tanpa kunci API ia memulangkan 401.

Mengenai fail MIDI

Nota

• Hanya sah untuk trek yang sudah mempunyai stem: song_id mesti ID trek yang dipulangkan oleh /api/music/separate, bukan ID lagu asal.
• Stem tanpa not ialah hasil biasa: sesetengah trek (contohnya FX) tiada not yang boleh ditranskripsi; dalam kes itu fail MIDI sah tanpa not dipulangkan, bukan ralat.
• MIDI hanya mengandungi maklumat not: kelantangan, pan dan kesan tidak termasuk dalam MIDI; tetapkan timbre sendiri dalam DAW.
• Minta setiap trek secara berasingan: satu permintaan memulangkan .mid satu trek; untuk beberapa trek, panggil setiap satu atau guna muat turun pakej kelompok dalam Create UI.