API de obținere MIDI

Actualizat pe 2026-09-18 · echipa Suno-API

Descrierea endpoint-ului

Endpointul MIDI convertește în fișier MIDI standard piesele care au deja stem-uri, pentru aranjament, muncă creativă ulterioară sau import într-un DAW.

Suno nu oferă o adresă de descărcare pentru fișiere MIDI; oferă doar datele de note ale fiecărei piste (înălțime, timp de început și sfârșit, intensitate). Acest endpoint convertește datele de note într-un fișier MIDI standard (SMF format 1) și îl returnează direct, deci primești întotdeauna un .mid real care poate fi deschis într-un DAW.

Endpoint: POST /api/music/download-file

Această pagină este exemplul specific MIDI. Descrierea completă a familiei de descărcări (adrese media, fișier unic, împachetare, ascultare în timpul generării) este în API de descărcare și ascultare a conținutului media al pieselor.

Facturare: Gratuit. Acest endpoint citește datele de note ale stem-urilor existente și nu debitează din sold.

Parametrii cererii

Headers

Parametri din body

Exemplu de cerere

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

Răspuns

Corpul răspunsului este conținutul binar al fișierului MIDI, nu JSON.

Obținerea unei adrese de descărcare

Dacă ai nevoie mai întâi de adresă și apoi de descărcare (de exemplu pentru a împacheta mai multe fișiere), apelează mai întâi:

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

Această adresă necesită și antetul Authorization; fără cheie API returnează 401.

Despre fișierul MIDI

Note

• Valabil doar pentru piesele care au deja stem-uri: song_id trebuie să fie un ID de pistă returnat de /api/music/separate, nu ID-ul piesei originale.
• Un stem fără note este un rezultat normal: unele piste (de exemplu FX) nu au note transcriibile; în acest caz se returnează un fișier MIDI valid fără note, nu o eroare.
• MIDI conține doar informații despre note: volumul, panoramarea și efectele nu fac parte din MIDI; setează timbrul singur în DAW.
• Solicită fiecare pistă separat: o cerere returnează .mid-ul unei piste; pentru mai multe piste apelează fiecare pistă sau folosește descărcarea împachetată în lot din Create UI.