MIDI-hämtnings-API

Uppdaterad 2026-09-18 · Suno-API-teamet

Beskrivning av ändpunkten

MIDI-ändpunkten konverterar spår som redan har stems till en standard-MIDI-fil, för arrangering, fortsatt kreativt arbete eller import i en DAW.

Suno tillhandahåller ingen nedladdningsadress för MIDI-filer; det ger bara notdata för varje spår (tonhöjd, start- och sluttid, velocity). Den här ändpunkten omvandlar notdatan till en standard-MIDI-fil (SMF format 1) och returnerar den direkt, så det du får är alltid en riktig .mid-fil som en DAW kan öppna.

Ändpunkt: POST /api/music/download-file

Den här sidan är det MIDI-specifika exemplet. Den fullständiga beskrivningen av nedladdningsfamiljen (mediaadresser, enskild fil, paketering, förhandslyssning under generering) finns i API för nedladdning och uppspelning av låtmedia.

Fakturering: Kostnadsfritt. Den här ändpunkten läser notdata från befintliga stems och drar inget saldo.

Begäransparametrar

Headers

Body-parametrar

Exempelbegäran

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

Svar

Svarskroppen är MIDI-filens binära innehåll, inte JSON.

Hämta en nedladdningsadress

Om du först behöver adressen och sedan vill ladda ner (till exempel för att paketera flera filer), anropa först:

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"
  }
}

Den adressen kräver också Authorization-rubriken; utan API-nyckel returneras 401.

Om MIDI-filen

Noter

• Gäller bara spår som redan har stems: song_id måste vara ett spår-ID som /api/music/separate returnerar, inte original-låtens ID.
• Ett stem utan noter är ett normalt resultat: vissa spår (till exempel FX) har inga noter som kan transkriberas; då returneras en giltig MIDI-fil utan noter i stället för ett fel.
• MIDI innehåller bara notinformation: volym, pan och effekter ingår inte i MIDI; ställ in klangen själv i DAW.
• Begär varje spår separat: en begäran returnerar .mid för ett spår; för flera spår anropar du var och ett, eller använder batch-nedladdningen i Create UI.