· reAPI Team
Suno MIDI-Import und -Export: Anforderungen und API-Leitfaden
Leitfaden für Suno MIDI-Import und -Export: V6_WILD-Dateianforderungen, 6 Sekunden Mindestdauer, Stem-zu-MIDI-JSON-API-Workflow und aktuelle Preise pro Anfrage.

Suno MIDI funktioniert jetzt in beide Richtungen, und die technischen Regeln unterscheiden sich auf beiden Seiten. Am 4. November 2026 hat Suno den MIDI-Datei-Upload direkt auf der Create-Seite hinzugefügt, sodass Pro- und Premier-Abonnenten einen V6-Song aus einer .mid- oder .midi-Datei starten können, statt sich allein auf Text-Prompts zu verlassen[1]. In der Gegenrichtung erfordert das Zurückverwandeln eines KI-generierten Tracks in bearbeitbare Noten weiterhin zuerst eine Stem-Trennung – egal, ob du in Suno Studio auf Get MIDI klickst[2] oder zwei Endpunkte über die Suno MIDI API verkettest[4].
Die meisten Artikel behandeln Suno MIDI wie einen einzelnen Export-Button oder bleiben bei allgemeinen DAW-Mixing-Tipps stehen. Wenn du Audio-Tools entwickelst oder Skizzen zwischen einer DAW und Suno hin- und herschiebst, liegt die eigentliche Reibung in den Einschränkungen: welche Modellversion den Suno MIDI-Import ausführt, warum eine syntaktisch gültige .mid-Datei noch vor dem Rendern abgelehnt wird, wie die API-Extraktion Noten-JSON statt eines binären .mid-Downloads zurückgibt und was jeder Schritt kostet. Alles Folgende kombiniert die aktuelle Dokumentation von Suno mit unseren eigenen Live-API-Testläufen vom 19. November 2026.
Zwei Suno MIDI-Workflows und wann welcher passt
Bevor du Integrationscode schreibst oder einen monatlichen Studio-Tarif bezahlst, trenne die beiden Richtungen klar voneinander. Der Suno MIDI-Import macht aus einer stummen Notensequenz ein vollständiges Arrangement und dient als schnelle Alternative dazu, für ein frühes Demo gigabyteweise Sample-Bibliotheken zu laden. Der Suno MIDI-Export arbeitet umgekehrt und gewinnt Tonhöhen-, Timing- und Velocity-Daten aus getrennten Stems zurück, damit du Synthesizer tauschen, Akkord-Voicings prüfen oder Spuren in Logic, Ableton, FL Studio oder MuseScore neu aufbauen kannst.
| Workflow-Detail | Suno Web-App / Studio (UI) | reAPI HTTP API (/api/v1/audio/generations) |
|---|---|---|
| Song aus MIDI starten | .mid / .midi auf Create ziehen (Simple-Modus, v6-wild, Pro-/Premier-Tarife)[1] | model: "suno-music", custom_mode: false, version: "V6_WILD", midi_urls (1 öffentliche URL)[4] |
| Live-Pianorolle & USB-Controller | Native MIDI-Spuren in Studio mit Web MIDI API (Chrome; kein Safari Web MIDI)[3] | Nicht anwendbar (zustandslose REST-Task-Pipeline) |
| MIDI aus einem Song extrahieren | Stems in Studio extrahieren, dann Rechtsklick auf einen Stem und Get MIDI klicken (10 Suno-Credits)[2] | Schritt 1: suno-vocal-separation (generierter Track oder externe audio_url). Schritt 2: suno-midi mit der task_id der Trennung[4] |
| Exportiertes MIDI-Format | Standard-.mid-Dateidownload[2] | Strukturiertes JSON (instruments[].notes[] mit pitch, start, end, velocity)[4] |
| Preismodell (geprüft am 19. Nov. 2026) | Abo-Stufen (Pro / Premier) + Suno-Credit-Guthaben[1][2] | Pauschale Abrechnung pro Anfrage auf reAPI Suno: 0,06 $ Musikgenerierung, 0,05 $ bis 0,25 $ Stem-Trennung, 0,001 $ MIDI-Extraktion[5] |
Wenn du live mit einem USB-Keyboard jammen, Noten in einer Browser-Pianorolle quantisieren oder Takes auf einer Audio-Timeline compen möchtest, ist Suno Studio die richtige Umgebung. Safari unterstützt derzeit kein Web MIDI, weshalb Suno für Hardware-Controller in Studio Google Chrome empfiehlt[3]. Wenn du Stapelverarbeitung, App-Integration oder nutzungsabhängige Abrechnung pro Anfrage ohne laufendes Abo brauchst, lässt sich die Suno MIDI API deutlich einfacher automatisieren.
Suno MIDI-Anforderungen und Import von .mid-Dateien per API
Eine Standard-MIDI-Datei enthält keinen Klang. Wie Suno in seiner Ankündigung vom 4. November 2026 erklärt, fasst eine .mid- oder .midi-Datei bis zu 16 Kanäle mit Tonhöhen- und Timing-Ereignissen, jeweils mit bis zu 120 Controller-Spuren für Parameter wie Sustain, Lautstärke und Modulation[1]. Wenn du diese Datei an Suno übergibst, erhält das Modell exaktes Noten-Timing und harmonische Bewegung, und dein Prompt steuert, wie eng sich das Ergebnis an deine Vorlage hält: Du kannst es deine Akkorde wortgetreu von einem Streichquartett spielen lassen oder ein kurzes Motiv übernehmen und es in ein neues Genre weiterentwickeln[1].
Zum Start läuft der Suno MIDI-Import im Simple-(Inspirations-)Modus auf V6_WILD[1]. Bei reAPI entspricht das model: "suno-music" mit custom_mode: false, version: "V6_WILD" und midi_urls mit einer öffentlichen HTTP(S)-URL[4]. Wenn du zusammen mit midi_urls eine andere Version angibst, schaltet die Ausführung upstream auf V6_WILD um[4]. Base64- und data:-URIs werden plattformweit abgelehnt; hoste die .mid-Datei daher auf einem öffentlichen Objektspeicher (oder lade sie über den suno-midi-Uploader im Playground hoch), bevor du den Generierungsendpunkt aufrufst[4].
Exakte Datei- und Payload-Limits
Jede Suno MIDI-Import-Anfrage muss fünf Suno MIDI-Anforderungen erfüllen, bevor das Modell Audio rendert:
- Format: Standard-
.mid- oder.midi-Binärdatei, die mit demMThd-Header beginnt[4]. - Dateigröße: maximal 256 KB[4].
- Dateianzahl: 1 MIDI-URL pro Anfrage (
midi_urlsakzeptiert höchstens einen Eintrag), und die Gesamtzahl der Referenzanhänge (style,lyrics,image_urls,audio_urls,video_urlsundmidi_urls) darf 10 nicht überschreiten[4]. - Modus: Nur Inspirationsmodus (
custom_mode: false). Du kannstmidi_urlsmit einem beschreibendenprompt(bis zu 3.000 Zeichen) kombinieren oderpromptweglassen, wenn eine andere Nicht-Custom-Eingabe vorhanden ist[4]. - Dauer: Mindestens 6 Sekunden musikalische Timeline, bestätigt in unseren Live-Läufen vom 19. November 2026[4].
Funktionierende Suno MIDI API-Anfrage für die Songgenerierung
curl -X POST https://reapi.ai/api/v1/audio/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-music",
"custom_mode": false,
"instrumental": true,
"version": "V6_WILD",
"prompt": "Warm ambient electric piano and soft synth pad following the MIDI progression",
"midi_urls": ["https://your-storage.example.com/original-progression-12s.mid"]
}'Der Endpunkt liefert sofort eine Task-ID zurück. Frage GET /api/v1/tasks/{id} ab, bis status zu "completed" oder "failed" wechselt[4]. Eine abgeschlossene Suno MIDI-Generierung liefert zwei Audio-Varianten in output.audio_urls[] sowie zwei indexgleich zugeordnete Metadateneinträge in output.tracks[], jeweils mit wiederverwendbarer id, url, title und duration[4].
Was in unseren Live-MIDI-Upload-Tests tatsächlich fehlgeschlagen ist
Die Dokumentation allein verrät selten, warum eine gültige .mid-Datei zurückgewiesen wird. Als wir den Suno MIDI-Import am 19. November 2026 End-to-End mit echten kostenpflichtigen Generierungs-Tasks getestet haben, zeigten sich sofort zwei praxisnahe Fehlerfälle:
- Kurze Skizzen unter 6 Sekunden werden abgelehnt. Unser erster Test lud eine gültige 58-Byte-MIDI-Datei im Format 0 mit vier Viertelnoten bei 120 BPM (insgesamt 2 Sekunden) hoch. Der Task schlug mit
"Your MIDI file is too short for us to check. Minimum duration is 6 seconds"fehl, und die reservierten Credits wurden erstattet (usage.credits: 0). Verlängere kurze Riffs vor dem Absenden auf mindestens 6 Sekunden. - Lehrbuch-Tonleitern können den Abgleich mit bekannten Aufnahmen auslösen. Unser zweiter Test verlängerte die Datei mit einer schlichten auf- und absteigenden C-Dur-Tonleiter auf 10 Sekunden. Obwohl die Datei aus frisch synthetisierten MIDI-Bytes bestand, schlug der Task mit
"Our system matched this upload to a known recording"fehl (erneut mit 0 Credits erstattet). Produzenten auf r/SunoAI berichten über ähnliche Fehlalarme bei schlichten Melodien und Standardübungen. - Eigene mehrstimmige Progressionen laufen sauber durch. Der Austausch der Tonleiter gegen eine 12 Sekunden lange, 461 Byte große eigene D-lydische Akkord- und Melodieprogression bei 100 BPM wurde in 54,2 Sekunden abgeschlossen und lieferte zwei abspielbare MP3-Varianten (
HTTP 200über das reAPI-CDN).
Wenn du eine automatisierte Pipeline rund um Suno MIDI-Uploads baust, fange beide Fehlerarten frühzeitig ab: Prüfe die MIDI-Dauer lokal im Client vor dem API-Aufruf (blockiere alles unter 6 Sekunden) und weise Nutzer darauf hin, dass blanke Tonleitern oder wiedererkennbare Cover-Melodien eine Fingerprint-Ablehnung auslösen können.
Suno MIDI aus Songs und Stems exportieren
Der Weg zurück von Audio zu Noten ist immer eine zweistufige Aufgabe. Weder Suno Studio noch die Suno MIDI API transkribieren einen dichten Stereo-Master in einem einzigen Schritt direkt in MIDI.
In Suno Studio teilst du deinen Clip zuerst über das Stems-Panel auf, um Vocals, Drums, Bass oder andere Ebenen zu isolieren. Sobald einzelne Suno MIDI-Stems vorliegen, klickst du den gewünschten Stem an und wählst Get MIDI im Kontextmenü. Studio berechnet 10 Suno-Credits und gibt eine Standard-MIDI-Datei aus, die du direkt in eine DAW ziehen kannst[2].
Über die reAPI-HTTP-Oberfläche spiegelt der Ablauf das Design von Studio wider – mit einem praktischen Vorteil: Du musst den Ausgangstrack nicht zuerst auf Suno generiert haben.
Schritt 1: Stems mit suno-vocal-separation trennen
suno-vocal-separation unterstützt zwei sich gegenseitig ausschließende Quellformen[4]:
- Bereits auf reAPI generierter Track: Übergib
task_id(die abgeschlossene reAPI-task_...-ID) undaudio_id(dieideines Eintrags ausoutput.tracks[]). - Dein eigenes hochgeladenes Audio: Übergib allein
audio_url(öffentliche HTTP(S)-URL, bis zu 20 MB; keineaudio_iderforderlich). Ältere Clients, die weiterhinaudio_idzusammen mitaudio_urlsenden, werden aus Gründen der Abwärtskompatibilität weiterhin akzeptiert[4].
Wähle den Trennungs-type bewusst, da er sowohl die Kosten als auch die Genauigkeit des nachgelagerten Suno MIDI-Exports beeinflusst:
separate_vocal(Standard,0,05 $/ 50 Credits): teilt in 2 Stems (VocalsundInstrumental)[4][5].split_stem_advanced(0,10 $/ 100 Credits): isoliert ein bestimmtes Instrument perstem_name(98 unterstützte Instrumente wiePiano,Bass,Electric Guitar,Drum KitoderLead Vocal)[4][5].split_stem(0,25 $/ 250 Credits): teilt in einem Durchgang in bis zu 12 Stems[4][5].
curl -X POST https://reapi.ai/api/v1/audio/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-vocal-separation",
"audio_url": "https://your-storage.example.com/mix.mp3",
"type": "separate_vocal"
}'Sobald GET /api/v1/tasks/{sep_task_id} abgeschlossen ist, liefert output.tracks[] jeden getrennten Stem samt seinem label (etwa Vocals oder Instrumental) und einer eigenen Track-id[4].
Schritt 2: Getrennte Stems mit suno-midi transkribieren
Sende als Nächstes model: "suno-midi" mit task_id auf die Vocal-Separation-Task-ID statt auf die ursprüngliche suno-music-Task-ID[4]. Die Übergabe einer gewöhnlichen Musikgenerierungs-Task-ID wird abgelehnt. Gib audio_id aus output.tracks[].id des Trennungs-Tasks an, um einen einzelnen Stem zu transkribieren, oder lass audio_id weg, um alle getrennten Stems zu transkribieren[4].
curl -X POST https://reapi.ai/api/v1/audio/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-midi",
"task_id": "task_YOUR_SEPARATION_TASK_ID",
"audio_id": "STEM_TRACK_ID_FROM_SEPARATION"
}'Anders als der .mid-Download in Studio liefert die Suno MIDI API strukturierte Notendaten in output.result.midi[4]:
{
"output": {
"result": {
"midi": {
"state": "completed",
"instruments": [
{
"name": "Electric Bass (finger)",
"notes": [
{ "pitch": 45, "start": 1.24, "end": 1.72, "velocity": 0.78 }
]
}
]
}
}
}
}Jeder Noteneintrag enthält den Standard-MIDI-pitch (0–127), start- und end-Zeiten in Sekunden sowie eine normalisierte velocity (0–1)[4]. Wenn dein nachgelagertes Tool statt JSON eine binäre .mid-Datei erwartet, lässt sich output.result.midi in Node.js mit @tonejs/midi in wenigen Zeilen umwandeln:
import { writeFileSync } from 'node:fs';
import { Midi } from '@tonejs/midi';
function saveSunoMidiJson(midiResult, outPath) {
const midi = new Midi();
for (const inst of midiResult.instruments ?? []) {
const track = midi.addTrack();
track.name = inst.name;
for (const n of inst.notes ?? []) {
track.addNote({
midi: n.pitch,
time: n.start,
duration: Math.max(0.02, n.end - n.start),
velocity: n.velocity,
});
}
}
writeFileSync(outPath, Buffer.from(midi.toArray()));
}Realistische Erwartungen an die Qualität des Suno MIDI-Exports
Produzenten auf r/SunoAI, die versucht haben, den Suno MIDI-Export direkt in Notationsprogramme wie MuseScore zu importieren, berichten häufig von verstreuten Ghost-Notes, unruhigen Rhythmen oder polyphonem Übersprechen. Diese Kritik beruht auf zwei technischen Realitäten:
- Audio-zu-MIDI-Transkription übernimmt Stem-Übersprechen. Jede Hallfahne oder überlappende Akkordschicht, die im Stem verbleibt, wird bei der Tonhöhenerkennung zu zusätzlichen kurzen Noten.
split_stem_advancedauf ein klares Instrument (wiePianooderBass) anzuwenden oderseparate_vocalvor dem Aufruf vonsuno-midizu nutzen, liefert in der Regel sauberere Noten-Arrays als die Transkription eines dichten Vollmixes. - 12-Stem-
split_stemkann leere Notendaten liefern. Wie in der reAPI-Suno-Referenz dokumentiert, können Trennungen mittype: "split_stem"bei spärlichen oder verrauschten Stems überhaupt keine erkannten Noten ergeben[4]. Bleiben nach der Transkription keine Notendaten übrig, meldet reAPI densuno-midi-Task als fehlgeschlagen und erstattet den Credit, statt ein leeres Ergebnis zurückzugeben[4].
Behandle extrahiertes Suno MIDI als bearbeitbare Harmonie- und Rhythmusskizze in deiner DAW, nicht als druckfertige Partitur. Quantisiere (Shift+Q in Studio oder das Raster deiner DAW), entferne Artefakte unter 50 ms mit geringer Velocity und weise deine eigenen virtuellen Instrumente zu.
Preise und Zeichenlimits entlang der Pipeline
reAPI berechnet Suno-Anfragen zu pauschalen Preisen pro Vorgang, die nicht von der Audiolänge oder der Modellversion abhängen (V6, V6_MINI und V6_WILD kosten dasselbe). Fehlgeschlagene und abgelehnte Tasks werden automatisch erstattet. Die folgenden Preise wurden am 19. November 2026 auf /models/suno geprüft; aktuelle Preise findest du live auf der Suno-Modellseite oder der Suno-V6-Seite[5].
| Schritt in der Suno MIDI-Pipeline | reAPI model + Option | Preis (USD, geprüft am 19. Nov. 2026)[5] | Credits (1 Credit = 0,001 $)[5] |
|---|---|---|---|
| Song aus MIDI generieren (2 Tracks) | suno-music (V6_WILD + midi_urls) | 0,06 $[5] | 60 |
| Vocals + Instrumental trennen | suno-vocal-separation (separate_vocal) | 0,05 $[5] | 50 |
| 1 von 98 Instrumenten isolieren | suno-vocal-separation (split_stem_advanced) | 0,10 $[5] | 100 |
| In bis zu 12 Stems teilen | suno-vocal-separation (split_stem) | 0,25 $[5] | 250 |
| MIDI-Noten-JSON aus Stems extrahieren | suno-midi | 0,001 $[5] | 1 |
Mit den obigen Preisen vom 19. November 2026 kostet ein kompletter Suno MIDI-Durchlauf (Track aus MIDI generieren für 0,06 $, Vocals und Instrumental trennen für 0,05 $ und MIDI-JSON transkribieren für 0,001 $) insgesamt 0,111 $ (111 Credits)[5]. Wenn du deine eigene Audiodatei mitbringst und nur isolierte Klaviernoten über split_stem_advanced (0,10 $) plus suno-midi (0,001 $) extrahierst, kostet dieser Zwei-Aufrufe-Workflow insgesamt 0,101 $ (101 Credits)[5].
Da Entwickler beim Kombinieren von Prompts mit Suno MIDI-Anfragen auch auf Textvalidierungsfehler stoßen, folgen hier die exakten V6-Zeichenlimits bei suno-music[4]:
prompt: bis zu 3.000 Zeichen im Inspirationsmodus (custom_mode: false, denmidi_urlsvoraussetzt) oder bis zu 5.000 Zeichen im Custom-Modus (custom_mode: true) bei V6-Modellen.lyrics: bis zu 5.000 Zeichen (hat als gesungener Text Vorrang vorprompt).style: bis zu 1.000 Zeichen bei V6-Modellen (200 beim älteren V4).title: bis zu 80 Zeichen beisuno-music(100 bei V6-Extend- und Mashup-Vorgängen).
Häufig gestellte Fragen
Wie exportierst du MIDI aus Suno?
Teile deinen Clip in Suno Studio zuerst über das Stems-Panel in Stems, wähle dann einen Stem aus und klicke auf Get MIDI (10 Suno-Credits), um eine Standard-MIDI-Datei herunterzuladen[2]. Über die Suno MIDI API auf reAPI führst du zuerst suno-vocal-separation aus und übergibst die task_id dieses abgeschlossenen Trennungs-Tasks an suno-midi, um strukturiertes Instrumenten- und Noten-JSON zu erhalten[4].
Kann ich mehrere MIDI-Dateien im selben Prompt hochladen?
Nein. Nach den aktuellen Suno MIDI-Anforderungen für suno-music akzeptiert midi_urls höchstens eine .mid- oder .midi-URL pro Anfrage[4]. Wenn dein Arrangement Klavier, Bass und Schlagzeug auf getrennten DAW-Spuren verteilt, exportiere sie vor dem Hochladen in eine einzige mehrkanalige Standard-MIDI-Datei (bis zu 16 Kanäle, unter 256 KB)[1][4].
Warum hat Suno meine gültige .mid-Datei abgelehnt?
In unseren Live-Tests vom 19. November 2026 traten zwei häufige Gründe auf: Die MIDI-Timeline war kürzer als 6 Sekunden ("Minimum duration is 6 seconds"), oder eine blanke Tonleiter hat den Abgleich mit bekannten Aufnahmen ausgelöst ("Our system matched this upload to a known recording"). Prüfe außerdem, ob die Datei mit dem Standard-Binärheader MThd beginnt, höchstens 256 KB groß ist und über eine öffentliche HTTP(S)-URL statt einer data:-URI bereitgestellt wird[4].
Bietet Suno einen offiziellen API-Zugang für MIDI an?
Suno veröffentlicht keine allgemeine öffentliche REST-API für Entwickler. Die nativen Suno MIDI-Funktionen befinden sich in der Suno Web-App und in Studio für Pro- und Premier-Abonnenten[1][3]. Entwickler, die automatisierte Pipelines bauen, nutzen einheitliche API-Gateways wie reAPIs Suno API, die midi_urls, suno-vocal-separation und suno-midi über einen einzelnen Bearer-Token und einen asynchronen Polling-Vertrag bereitstellen[4].
Wie viele Zeichen erlaubt Suno in Prompts bei Verwendung von MIDI?
Wenn du midi_urls bei suno-music übergibst, läuft die Anfrage im Inspirationsmodus (custom_mode: false), in dem prompt bis zu 3.000 Zeichen erlaubt[4]. Im Custom-Modus ohne MIDI-Anhänge erlauben V6-Modelle bis zu 5.000 Zeichen für prompt und lyrics, bis zu 1.000 für style und bis zu 80 für title[4].
Kann ich Suno MIDI in einem echten DAW-Musikproduktions-Workflow nutzen?
Ja, solange du jede Richtung entsprechend ihren Stärken einsetzt. Einen Song aus deiner eigenen DAW-MIDI-Datei zu starten, bietet engere harmonische und strukturelle Kontrolle als reine Text-Prompts[1]. MIDI aus Suno-Audio zu extrahieren eignet sich gut, um Akkord-Voicings, Basslinien oder Melodien festzuhalten und mit DAW-Plugins neu anzutriggern – vorausgesetzt, du trennst die Stems zuerst sauber und planst ein paar Minuten für Quantisierung und das Bereinigen von Ghost-Notes ein.
Zwischen Studio und API für Suno MIDI-Arbeit entscheiden
Wähle Suno Studio, wenn du als Solo-Produzent mit einem USB-Keyboard in Chrome jammst, Noten auf einer Browser-Timeline bearbeitest und gelegentlich von Hand WAV-Stems oder .mid-Dateien exportierst[2][3]. Wähle den reAPI-HTTP-Workflow, wenn du midi_urls ohne monatliches Abo auf V6_WILD ausführen, hochgeladenes Audio programmatisch durch suno-vocal-separation und suno-midi schicken oder Noten-Arrays direkt als JSON verarbeiten möchtest. So oder so hängen verlässliche Suno MIDI-Ergebnisse an zwei Gewohnheiten: Exportiere auf dem Hinweg eigene mehrkanalige .mid-Dateien mit mindestens 6 Sekunden Länge und isoliere auf dem Rückweg die Stems sorgfältig vor dem Transkribieren.
Das vollständige Parameter-Schema findest du in der reAPI Suno API-Dokumentation, oder teste Aufrufe direkt im Browser auf der Suno-Modellseite.
Quellen
- Suno. Start Songs with MIDI. Veröffentlicht am 4. November 2026. Abgerufen im November 2026 unter suno.com/blog/MIDI-in-create
- Suno Help Center. Exporting from Studio. Abgerufen im November 2026 unter help.suno.com/en/articles/8128193
- Suno Help Center. MIDI in Studio. Abgerufen im November 2026 unter help.suno.com/en/articles/13670593
- reAPI. Suno API-Dokumentation. Abgerufen im November 2026 unter reapi.ai/docs/suno
- reAPI. Suno-Modellseite & Live-Preise. Abgerufen im November 2026 unter reapi.ai/models/suno