MIDI-Abruf-API

Aktualisiert am 2026-09-18 · Suno-API-Team

Beschreibung des Endpunkts

Der MIDI-Endpunkt wandelt Spuren, für die bereits Stems existieren, in eine Standard-MIDI-Datei um — für Arrangement, weitere kreative Arbeit oder den Import in eine DAW.

Suno stellt keine Download-Adresse für MIDI-Dateien bereit, sondern nur die Notendaten jeder Spur (Tonhöhe, Start- und Endzeit, Anschlagstärke). Dieser Endpunkt wandelt diese Notendaten in eine Standard-MIDI-Datei (SMF format 1) um und gibt sie direkt zurück; Sie erhalten also immer eine echte .mid-Datei, die eine DAW öffnen kann.

Endpunkt: POST /api/music/download-file

Diese Seite ist das MIDI-spezifische Beispiel. Die vollständige Beschreibung der Download-Familie (Medienadressen, Einzeldatei, Paketierung, Vorschau während der Generierung) steht in der API zum Herunterladen und Anhören von Song-Medien.

Abrechnung: Kostenlos. Dieser Endpunkt liest die Notendaten vorhandener Stems und zieht kein Guthaben ab.

Anfrageparameter

Headers

Parameter	Typ	Erforderlich	Hinweise
Authorization	string	ja	Bearer YOUR_API_KEY
Content-Type	string	ja	application/json

Body-Parameter

Parameter	Typ	Erforderlich	Standard	Hinweise
song_id	string	ja	-	Die Song-ID einer einzelnen Spur nach der Trennung (jede von `/api/music/separate` zurückgegebene clip id)
kind	string	ja	-	Fest auf `midi`

Beispielanfrage

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

Antwort

Der Antwort-Body ist der binäre Inhalt der MIDI-Datei, nicht JSON.

Antwort-Header	Wert
Content-Type	`audio/midi`
Content-Disposition	`attachment; filename="<Songtitel>.mid"`

Download-Adresse abrufen

Wenn Sie zuerst die Adresse und dann den Download benötigen (z. B. zum Paketieren mehrerer Dateien), rufen Sie zuerst auf:

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

Diese Adresse erfordert ebenfalls den Authorization-Header; ohne API-Schlüssel liefert sie 401.

Zur MIDI-Datei

Element	Wert	Hinweise
Dateiformat	SMF format 1	1 Tempo-Spur + 1 Spur pro Instrument
Zeitauflösung	480 PPQ	480 Ticks pro Schlag
Tempo	120 BPM	Suno liefert nur Sekunden, kein BPM, daher wird ein festes Tempo für die Zeitachse verwendet
Zeitachse	`1 Sekunde = 960 Ticks`	Entspricht eins zu eins den von der Plattform gelieferten Sekunden; ändern Sie das Tempo in der DAW nach Bedarf
Anschlagstärke	0–127	Die Plattform liefert 0–1-Gleitkommazahlen; der Endpunkt hat sie bereits mit ×127 umgerechnet
Schlagzeug	MIDI-Kanal 10	Spuren, die die Plattform als Schlagzeug markiert, werden automatisch auf den Percussion-Kanal gelegt

Hinweise

Nur gültig für Spuren, die bereits Stems haben: song_id muss eine von /api/music/separate zurückgegebene Spur-ID sein, nicht die ID des Originalsongs.
Ein Stem ohne Noten ist ein normales Ergebnis: Manche Spuren (z. B. FX) haben keine übertragbaren Noten; in diesem Fall wird statt eines Fehlers eine gültige MIDI-Datei ohne Noten zurückgegeben.
MIDI enthält nur Noteninformationen: Lautstärke, Panorama und Effekte sind nicht Teil der MIDI; stellen Sie den Klang selbst in der DAW ein.
Jede Spur einzeln anfragen: Eine Anfrage liefert die .mid einer Spur; für mehrere Spuren rufen Sie jede einzeln auf oder nutzen den Stapel-Download der Create UI.

WeiterAPI zum Herunterladen und Anhören von Song-Medien

API-Schlüssel erhalten

Erstellen Sie nach der Anmeldung einen API-Schlüssel in der Konsole. Jede Generierung kostet 0,6 ¥ und liefert 2 Tracks, Downloads sind unbegrenzt und eine Telefonnummer ist nicht erforderlich.

API-Schlüssel holen Zurück zur Übersicht