GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
Tous les guides

· reAPI Team

Import et export Suno MIDI : exigences et guide API

Guide d'import et d'export Suno MIDI : exigences de fichier V6_WILD, durée minimale de 6 secondes, workflow API JSON de stems vers MIDI et tarifs actuels par requête.

Import et export Suno MIDI : exigences et guide API

Suno MIDI fonctionne désormais dans les deux sens, et les règles techniques diffèrent de chaque côté. Le 4 novembre 2026, Suno a ajouté l'import de fichiers MIDI directement sur sa page Create, permettant aux abonnés Pro et Premier de démarrer un morceau V6 à partir d'un fichier .mid ou .midi au lieu de s'appuyer uniquement sur des prompts texte[1]. Dans l'autre sens, reconvertir une piste générée par IA en notes éditables exige toujours d'abord une séparation de stems, que tu cliques sur Get MIDI dans Suno Studio[2] ou que tu enchaînes deux endpoints via l'API Suno MIDI[4].

La plupart des articles traitent Suno MIDI comme un simple bouton d'export ou s'arrêtent à des conseils généraux de mixage en DAW. Si tu développes des outils audio ou fais des allers-retours d'esquisses entre une DAW et Suno, la vraie friction se trouve dans les contraintes : quelle version du modèle exécute l'import Suno MIDI, pourquoi un fichier .mid syntaxiquement valide est rejeté avant le rendu, comment l'extraction API renvoie un JSON de notes au lieu d'un téléchargement binaire .mid, et combien coûte chaque étape. Tout ce qui suit associe la documentation actuelle de Suno à nos propres tests API en conditions réelles menés le 19 novembre 2026.

Deux workflows Suno MIDI et quand chacun convient

Avant d'écrire du code d'intégration ou de payer un abonnement mensuel Studio, distingue bien les deux sens. L'import Suno MIDI transforme une séquence de notes muette en un arrangement complet, ce qui constitue une alternative rapide au chargement de gigaoctets de banques d'échantillons pour une première maquette. L'export Suno MIDI fait l'inverse : il récupère les données de hauteur, de timing et de vélocité depuis des stems séparés afin que tu puisses changer de synthés, vérifier des voicings d'accords ou reconstruire des parties dans Logic, Ableton, FL Studio ou MuseScore.

Détail du workflowApplication web Suno / Studio (UI)API HTTP reAPI (/api/v1/audio/generations)
Démarrer un morceau à partir d'un MIDIGlisser .mid / .midi sur Create (mode Simple, v6-wild, offres Pro/Premier)[1]model: "suno-music", custom_mode: false, version: "V6_WILD", midi_urls (1 URL publique)[4]
Piano roll en direct et contrôleurs USBPistes MIDI natives dans Studio avec Web MIDI API (Chrome ; pas de Web MIDI sur Safari)[3]Non applicable (pipeline de tâches REST sans état)
Extraire le MIDI d'un morceauExtraire les stems dans Studio, puis clic droit sur un stem et Get MIDI (10 crédits Suno)[2]Étape 1 : suno-vocal-separation (piste générée ou audio_url externe). Étape 2 : suno-midi sur le task_id de séparation[4]
Format MIDI exportéTéléchargement de fichier .mid standard[2]JSON structuré (instruments[].notes[] avec pitch, start, end, velocity)[4]
Modèle tarifaire (vérifié le 19 nov. 2026)Formules d'abonnement (Pro / Premier) + solde de crédits Suno[1][2]Paiement forfaitaire à la requête sur reAPI Suno : 0,06 $US génération musicale, 0,05 $US à 0,25 $US séparation de stems, 0,001 $US extraction MIDI[5]

Si tu veux improviser en direct avec un clavier USB, quantifier des notes dans un piano roll de navigateur ou faire du comping de prises sur une timeline audio, Suno Studio est le bon environnement. Safari ne prend actuellement pas en charge Web MIDI ; Suno recommande donc Google Chrome pour les contrôleurs matériels dans Studio[3]. Si tu as besoin de traitement par lots, d'intégration applicative ou d'une facturation à la requête sans siège récurrent, l'API Suno MIDI est beaucoup plus simple à automatiser.

Exigences Suno MIDI et import de fichiers .mid via API

Un Standard MIDI File ne contient aucun son. Comme Suno l'indique dans son annonce du 4 novembre 2026, un fichier .mid ou .midi stocke jusqu'à 16 canaux d'événements de hauteur et de temps, chacun disposant de jusqu'à 120 pistes de contrôleurs pour des paramètres tels que le sustain, le volume et la modulation[1]. Envoyer ce fichier à Suno fournit au modèle un timing exact des notes et un mouvement harmonique précis, et ton prompt contrôle à quel point le résultat suit ta partition : tu peux lui demander de jouer tes accords à l'identique par un quatuor à cordes, ou d'emprunter un court motif pour le développer dans un nouveau genre[1].

Au lancement, l'import Suno MIDI fonctionne en mode Simple (inspiration) sur V6_WILD[1]. Sur reAPI, cela correspond à model: "suno-music" avec custom_mode: false, version: "V6_WILD", et midi_urls contenant une URL HTTP(S) publique[4]. Envoyer une autre version avec midi_urls bascule l'exécution vers V6_WILD en amont[4]. Les données Base64 et les URI data: sont rejetées sur toute la plateforme ; héberge donc le fichier .mid sur un stockage objet public (ou téléverse-le via l'outil suno-midi du playground) avant d'appeler l'endpoint de génération[4].

Limites exactes de fichier et de payload

Chaque requête d'import Suno MIDI doit satisfaire cinq exigences Suno MIDI avant que le modèle ne rende l'audio :

  • Format : binaire .mid ou .midi standard commençant par l'en-tête MThd[4].
  • Taille du fichier : 256 KB maximum[4].
  • Nombre de fichiers : 1 URL MIDI par requête (midi_urls accepte au plus une entrée), et le total des pièces jointes de référence (style, lyrics, image_urls, audio_urls, video_urls et midi_urls) ne peut pas dépasser 10[4].
  • Mode : mode inspiration (custom_mode: false) uniquement. Tu peux combiner midi_urls avec un prompt descriptif (jusqu'à 3 000 caractères), ou omettre prompt lorsqu'une autre entrée non personnalisée est présente[4].
  • Durée : au moins 6 secondes de timeline musicale, vérifié lors de nos tests en direct du 19 novembre 2026[4].

Requête API Suno MIDI fonctionnelle pour générer un morceau

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

L'endpoint renvoie immédiatement un identifiant de tâche. Interroge GET /api/v1/tasks/{id} jusqu'à ce que status passe à "completed" ou "failed"[4]. Une génération Suno MIDI terminée renvoie deux variations audio dans output.audio_urls[] et deux entrées de métadonnées alignées par index dans output.tracks[], chacune portant un id, une url, un title et une duration réutilisables[4].

Ce qui a réellement échoué lors de nos tests d'upload MIDI en direct

La documentation seule explique rarement pourquoi un fichier .mid valide est refusé. Lorsque nous avons testé l'import Suno MIDI de bout en bout le 19 novembre 2026 sur de vraies tâches de génération payantes, deux cas d'échec réalistes sont apparus immédiatement :

  1. Les esquisses courtes de moins de 6 secondes sont rejetées. Notre premier test a envoyé un fichier MIDI Format 0 valide de 58 octets contenant quatre noires à 120 BPM (2 secondes au total). La tâche a échoué avec "Your MIDI file is too short for us to check. Minimum duration is 6 seconds", et les crédits réservés ont été remboursés (usage.credits: 0). Étends les riffs courts à au moins 6 secondes avant de les soumettre.
  2. Les gammes scolaires peuvent déclencher la détection d'enregistrements connus. Notre deuxième test a allongé le fichier à 10 secondes avec une simple gamme ascendante et descendante de do majeur. Même si le fichier était constitué d'octets MIDI fraîchement synthétisés, la tâche a échoué avec "Our system matched this upload to a known recording" (de nouveau remboursé à 0 crédit). Des producteurs sur r/SunoAI ont signalé des faux positifs similaires sur des mélodies nues et des exercices standard.
  3. Les progressions polyphoniques originales passent sans accroc. En remplaçant la gamme par une progression originale en ré lydien de 12 secondes et 461 octets (accords et mélodie à 100 BPM), la tâche s'est terminée en 54,2 secondes et a renvoyé deux variations MP3 lisibles (HTTP 200 sur le CDN reAPI).

Si tu construis un pipeline automatisé autour des uploads Suno MIDI, intercepte tôt les deux modes d'échec : inspecte la durée MIDI localement dans ton client avant d'appeler l'API (bloque tout ce qui fait moins de 6 secondes), et avertis les utilisateurs que des gammes nues ou des mélodies de reprises reconnaissables peuvent provoquer un rejet par empreinte audio.

Exporter du Suno MIDI à partir de morceaux et de stems

Revenir de l'audio aux notes est toujours une opération en deux étapes. Ni Suno Studio ni l'API Suno MIDI ne transcrivent directement un master stéréo dense en MIDI en une seule passe.

Dans Suno Studio, tu divises d'abord ton clip via le panneau Stems pour isoler les voix, la batterie, la basse ou d'autres couches. Une fois que des stems Suno MIDI individuels existent, clique sur le stem cible et choisis Get MIDI dans le menu contextuel. Studio facture 10 crédits Suno et produit un fichier Standard MIDI prêt à être glissé dans une DAW[2].

Par l'interface HTTP de reAPI, la séquence reflète la conception de Studio, avec un avantage pratique : tu n'as pas besoin d'avoir d'abord généré la piste source sur Suno.

Étape 1 : séparer les stems avec suno-vocal-separation

suno-vocal-separation prend en charge deux formes de source mutuellement exclusives[4] :

  • Piste existante générée sur reAPI : passe task_id (l'ID reAPI task_... terminé) et audio_id (l'id d'une entrée dans output.tracks[]).
  • Ton propre audio téléversé : passe uniquement audio_url (URL HTTP(S) publique, jusqu'à 20 MB ; aucun audio_id requis). Les clients historiques qui continuent de passer audio_id avec audio_url restent acceptés par rétrocompatibilité[4].

Choisis le type de séparation de façon réfléchie, car il modifie à la fois le coût et la précision de l'export Suno MIDI en aval :

  • separate_vocal (par défaut, 0,05 $US / 50 crédits) : sépare en 2 stems (Vocals et Instrumental)[4][5].
  • split_stem_advanced (0,10 $US / 100 crédits) : isole un instrument précis via stem_name (98 instruments pris en charge comme Piano, Bass, Electric Guitar, Drum Kit ou Lead Vocal)[4][5].
  • split_stem (0,25 $US / 250 crédits) : sépare jusqu'à 12 stems en une fois[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"
  }'

Lorsque GET /api/v1/tasks/{sep_task_id} se termine, output.tracks[] renvoie chaque stem séparé avec son label (comme Vocals ou Instrumental) et son propre id de piste[4].

Étape 2 : transcrire les stems séparés avec suno-midi

Ensuite, soumets model: "suno-midi" avec task_id défini sur l'ID de tâche de séparation vocale plutôt que sur l'ID de tâche suno-music d'origine[4]. Passer un simple ID de tâche de génération musicale est rejeté. Inclus audio_id issu de output.tracks[].id de la tâche de séparation pour transcrire un seul stem, ou omets audio_id pour transcrire tous les stems séparés[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"
  }'

Contrairement au téléchargement .mid de Studio, l'API Suno MIDI renvoie des données de notes structurées dans 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 }
            ]
          }
        ]
      }
    }
  }
}

Chaque entrée de note contient le pitch MIDI standard (0–127), les temps start et end en secondes, et une velocity normalisée (0–1)[4]. Si ton outil en aval attend un fichier .mid binaire plutôt que du JSON, convertir output.result.midi dans Node.js avec @tonejs/midi ne prend que quelques lignes :

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()));
}

Attentes réalistes sur la qualité de l'export Suno MIDI

Les producteurs sur r/SunoAI qui ont essayé d'importer l'export Suno MIDI directement dans des logiciels de notation comme MuseScore signalent souvent des ghost notes parasites, des rythmes instables ou de la repisse polyphonique. Cette critique repose sur deux réalités techniques :

  1. La transcription audio vers MIDI hérite de la repisse des stems. Toute queue de réverbération ou couche d'accords qui se chevauche dans un stem se transforme en courtes notes supplémentaires lors de la détection de hauteur. Exécuter split_stem_advanced sur un instrument clair (comme Piano ou Bass) ou utiliser separate_vocal avant d'appeler suno-midi produit généralement des tableaux de notes plus propres que la transcription d'un mix complet dense.
  2. La séparation 12 stems split_stem peut renvoyer des données de notes vides. Comme documenté dans la référence Suno de reAPI, les séparations créées avec type: "split_stem" peuvent ne produire aucune note détectée du tout sur des stems clairsemés ou bruités[4]. Si aucune donnée de note ne survit à la transcription, reAPI signale la tâche suno-midi comme échouée et rembourse le crédit au lieu de renvoyer un résultat vide[4].

Traite le Suno MIDI extrait comme une esquisse harmonique et rythmique éditable dans ta DAW, pas comme une partition prête à imprimer. Quantifie (Shift+Q dans Studio ou sur la grille de ta DAW), supprime les artefacts de faible vélocité sous 50 ms et assigne tes propres instruments virtuels.

Tarifs et limites de caractères sur l'ensemble du pipeline

reAPI facture les requêtes Suno à des tarifs forfaitaires par opération qui ne varient pas selon la durée audio ni la version du modèle (V6, V6_MINI et V6_WILD coûtent le même prix). Les tâches échouées et rejetées sont remboursées automatiquement. Les tarifs ci-dessous ont été vérifiés sur /models/suno le 19 novembre 2026 ; consulte la page modèle Suno ou la page Suno V6 en direct pour les prix actuels[5].

Étape du pipeline Suno MIDImodel reAPI + optionTarif (USD, vérifié le 19 nov. 2026)[5]Crédits (1 crédit = 0,001 $US)[5]
Générer un morceau depuis un MIDI (2 pistes)suno-music (V6_WILD + midi_urls)0,06 $US[5]60
Séparer voix + instrumentalsuno-vocal-separation (separate_vocal)0,05 $US[5]50
Isoler 1 des 98 instrumentssuno-vocal-separation (split_stem_advanced)0,10 $US[5]100
Séparer jusqu'à 12 stemssuno-vocal-separation (split_stem)0,25 $US[5]250
Extraire le JSON de notes MIDI des stemssuno-midi0,001 $US[5]1

Avec les tarifs du 19 novembre 2026 ci-dessus, un aller-retour Suno MIDI complet (générer une piste depuis un MIDI à 0,06 $US, séparer voix et instrumental à 0,05 $US, puis transcrire le JSON MIDI à 0,001 $US) revient à 0,111 $US (111 crédits)[5]. Si tu fournis ton propre fichier audio et extrais uniquement des notes de piano isolées via split_stem_advanced (0,10 $US) plus suno-midi (0,001 $US), ce workflow en deux appels totalise 0,101 $US (101 crédits)[5].

Comme les développeurs rencontrent aussi des erreurs de validation de texte lorsqu'ils combinent des prompts avec des requêtes Suno MIDI, voici les limites exactes de caractères V6 sur suno-music[4] :

  • prompt : jusqu'à 3 000 caractères en mode inspiration (custom_mode: false, exigé par midi_urls), ou jusqu'à 5 000 caractères en mode personnalisé (custom_mode: true) sur les modèles V6.
  • lyrics : jusqu'à 5 000 caractères (prioritaire sur prompt pour les paroles chantées).
  • style : jusqu'à 1 000 caractères sur les modèles V6 (200 sur l'ancien V4).
  • title : jusqu'à 80 caractères sur suno-music (100 sur les opérations V6 extend et mashup).

Questions fréquentes

Comment exporter du MIDI depuis Suno ?

Dans Suno Studio, divise d'abord ton clip en stems depuis le panneau Stems, puis sélectionne un stem et choisis Get MIDI (10 crédits Suno) pour télécharger un fichier Standard MIDI[2]. Via l'API Suno MIDI sur reAPI, exécute d'abord suno-vocal-separation, puis passe le task_id de cette tâche de séparation terminée à suno-midi pour obtenir un JSON structuré d'instruments et de notes[4].

Puis-je téléverser plusieurs fichiers MIDI dans le même prompt ?

Non. Selon les exigences Suno MIDI actuelles sur suno-music, midi_urls accepte au maximum une URL .mid ou .midi par requête[4]. Si ton arrangement répartit piano, basse et batterie sur des pistes DAW séparées, exporte-les dans un seul Standard MIDI File multicanal (jusqu'à 16 canaux, moins de 256 KB) avant de téléverser[1][4].

Pourquoi Suno a-t-il rejeté mon fichier .mid valide ?

Deux raisons courantes sont apparues dans nos tests en direct du 19 novembre 2026 : la timeline MIDI durait moins de 6 secondes ("Minimum duration is 6 seconds"), ou une gamme nue a déclenché la détection d'enregistrements connus ("Our system matched this upload to a known recording"). Vérifie aussi que le fichier commence par l'en-tête binaire standard MThd, ne dépasse pas 256 KB et est servi depuis une URL HTTP(S) publique plutôt qu'une URI data:[4].

Suno propose-t-il un accès API officiel pour le MIDI ?

Suno ne publie pas d'API REST publique générale pour les développeurs. Ses fonctions Suno MIDI natives résident dans l'application web Suno et Studio pour les abonnés Pro et Premier[1][3]. Les développeurs qui construisent des pipelines automatisés utilisent des passerelles API unifiées comme l'API Suno de reAPI, qui expose midi_urls, suno-vocal-separation et suno-midi derrière un seul jeton Bearer et un contrat de polling asynchrone[4].

Combien de caractères Suno autorise-t-il dans les prompts avec le MIDI ?

Lorsque tu passes midi_urls sur suno-music, la requête s'exécute en mode inspiration (custom_mode: false), où prompt autorise jusqu'à 3 000 caractères[4]. En mode personnalisé sans pièce jointe MIDI, prompt et lyrics autorisent jusqu'à 5 000 caractères sur les modèles V6, style jusqu'à 1 000 et title jusqu'à 80[4].

Puis-je utiliser Suno MIDI dans un vrai workflow de production musicale sur DAW ?

Oui, tant que tu utilises chaque sens selon ses points forts. Démarrer un morceau à partir de ton propre fichier MIDI de DAW donne un contrôle harmonique et structurel plus précis que les prompts texte seuls[1]. Extraire du MIDI à partir d'audio Suno fonctionne bien pour récupérer des voicings d'accords, des lignes de basse ou des mélodies à redéclencher avec des plugins de DAW, à condition de séparer les stems proprement d'abord et de prévoir quelques minutes pour la quantification et le nettoyage des ghost notes.

Choisir entre Studio et l'API pour travailler avec Suno MIDI

Choisis Suno Studio si tu es un producteur solo qui improvise avec un clavier USB dans Chrome, édite des notes sur une timeline dans le navigateur et exporte occasionnellement à la main des stems WAV ou des fichiers .mid[2][3]. Choisis le workflow HTTP de reAPI quand tu veux exécuter midi_urls sur V6_WILD sans abonnement mensuel, traiter de l'audio téléversé par programmation avec suno-vocal-separation et suno-midi, ou consommer directement des tableaux de notes en JSON. Dans les deux cas, des résultats Suno MIDI fiables reposent sur deux habitudes : exporter en entrée des fichiers .mid multicanaux originaux d'au moins 6 secondes, et isoler soigneusement les stems avant de transcrire en sortie.

Lis le schéma complet des paramètres dans la documentation API Suno de reAPI ou teste des appels directement dans le navigateur sur la page modèle Suno.

Références

  1. Suno. Start Songs with MIDI. Publié le 4 novembre 2026. Consulté en novembre 2026 sur suno.com/blog/MIDI-in-create
  2. Suno Help Center. Exporting from Studio. Consulté en novembre 2026 sur help.suno.com/en/articles/8128193
  3. Suno Help Center. MIDI in Studio. Consulté en novembre 2026 sur help.suno.com/en/articles/13670593
  4. reAPI. Documentation API Suno. Consulté en novembre 2026 sur reapi.ai/docs/suno
  5. reAPI. Page modèle Suno et tarifs en direct. Consulté en novembre 2026 sur reapi.ai/models/suno

Plus d'articles

Tous les guides