· reAPI Team
Importación y exportación de Suno MIDI: requisitos y guía de API
Guía de importación y exportación de Suno MIDI: requisitos de archivo de V6_WILD, duración mínima de 6 segundos, flujo API JSON de stems a MIDI y tarifas actuales por solicitud.

Suno MIDI ahora funciona en ambos sentidos y las reglas técnicas cambian en cada lado. El 4 de noviembre de 2026, Suno añadió la carga de archivos MIDI directamente en su página Create, lo que permite a los suscriptores Pro y Premier empezar una canción V6 desde un archivo .mid o .midi en lugar de depender solo de prompts de texto[1]. En el sentido contrario, volver a convertir una pista generada por IA en notas editables sigue requiriendo primero la separación de stems, tanto si haces clic en Get MIDI dentro de Suno Studio[2] como si encadenas dos endpoints a través de la API de Suno MIDI[4].
La mayoría de los artículos tratan Suno MIDI como un único botón de exportación o se quedan en consejos generales de mezcla en DAW. Si desarrollas herramientas de audio o pasas bocetos de ida y vuelta entre una DAW y Suno, la fricción real está en las restricciones: qué versión del modelo ejecuta la importación de Suno MIDI, por qué un archivo .mid sintácticamente válido es rechazado antes del renderizado, cómo la extracción por API devuelve notas en JSON en lugar de una descarga binaria .mid y cuánto cuesta cada paso. Todo lo siguiente combina la documentación actual de Suno con nuestras propias pruebas reales de API ejecutadas el 19 de noviembre de 2026.
Dos flujos de trabajo de Suno MIDI y cuándo conviene cada uno
Antes de escribir código de integración o pagar un plan mensual de Studio, separa ambas direcciones. La importación de Suno MIDI convierte una secuencia muda de notas en un arreglo completo y sirve como alternativa rápida a cargar gigabytes de librerías de samples para una maqueta inicial. La exportación de Suno MIDI hace lo contrario: recupera los datos de altura, tiempo y velocidad desde stems separados para que puedas cambiar sintetizadores, revisar voicings de acordes o reconstruir partes en Logic, Ableton, FL Studio o MuseScore.
| Detalle del flujo | App web de Suno / Studio (UI) | API HTTP de reAPI (/api/v1/audio/generations) |
|---|---|---|
| Empezar una canción desde MIDI | Arrastrar .mid / .midi a Create (modo Simple, v6-wild, planes Pro/Premier)[1] | model: "suno-music", custom_mode: false, version: "V6_WILD", midi_urls (1 URL pública)[4] |
| Piano roll en vivo y controladores USB | Pistas MIDI nativas en Studio con Web MIDI API (Chrome; sin Web MIDI en Safari)[3] | No aplica (pipeline de tareas REST sin estado) |
| Extraer MIDI de una canción | Extraer stems en Studio, luego clic derecho en un stem y Get MIDI (10 créditos de Suno)[2] | Paso 1: suno-vocal-separation (pista generada o audio_url externa). Paso 2: suno-midi sobre el task_id de separación[4] |
| Formato MIDI exportado | Descarga de archivo .mid estándar[2] | JSON estructurado (instruments[].notes[] con pitch, start, end y velocity)[4] |
| Modelo de precios (verificado el 19 nov 2026) | Planes de suscripción (Pro / Premier) + saldo de créditos de Suno[1][2] | Tarifa fija por solicitud en reAPI Suno: 0,06 US$ generación musical, 0,05 US$ a 0,25 US$ separación de stems, 0,001 US$ extracción MIDI[5] |
Si quieres improvisar en vivo con un teclado USB, cuantizar notas en un piano roll del navegador o compilar tomas sobre una línea de tiempo de audio, Suno Studio es el entorno adecuado. Safari actualmente no admite Web MIDI, por lo que Suno recomienda Google Chrome para controladores físicos en Studio[3]. Si necesitas procesamiento por lotes, integración en aplicaciones o facturación por solicitud sin una licencia recurrente, la API de Suno MIDI es mucho más sencilla de automatizar.
Requisitos de Suno MIDI e importación de archivos .mid mediante API
Un archivo Standard MIDI no contiene sonido. Como señala Suno en su anuncio del 4 de noviembre de 2026, un archivo .mid o .midi almacena hasta 16 canales de eventos de altura y tiempo, cada uno con hasta 120 carriles de controlador para parámetros como sustain, volumen y modulación[1]. Pasar ese archivo a Suno le da al modelo una sincronización exacta de notas y movimiento armónico, y tu prompt controla cuán fielmente sigue el resultado a tu partitura: puedes pedirle que toque tus acordes tal cual con un cuarteto de cuerdas, o tomar un motivo breve y desarrollarlo en un género nuevo[1].
En su lanzamiento, la importación de Suno MIDI se ejecuta en modo Simple (inspiración) sobre V6_WILD[1]. En reAPI, esto equivale a model: "suno-music" con custom_mode: false, version: "V6_WILD" y midi_urls con una URL pública HTTP(S)[4]. Enviar una versión distinta junto con midi_urls cambia la ejecución a V6_WILD en el servicio upstream[4]. Tanto Base64 como las URI data: se rechazan en toda la plataforma, así que aloja el archivo .mid en almacenamiento de objetos público (o súbelo con el cargador suno-midi del playground) antes de llamar al endpoint de generación[4].
Límites exactos de archivo y payload
Toda solicitud de importación de Suno MIDI debe cumplir cinco requisitos de Suno MIDI antes de que el modelo renderice el audio:
- Formato: binario
.mido.midiestándar que comience con el encabezadoMThd[4]. - Tamaño de archivo: 256 KB como máximo[4].
- Cantidad de archivos: 1 URL MIDI por solicitud (
midi_urlsacepta como máximo una entrada), y el total de adjuntos de referencia (style,lyrics,image_urls,audio_urls,video_urlsymidi_urls) no puede superar 10[4]. - Modo: solo modo inspiración (
custom_mode: false). Puedes combinarmidi_urlscon unpromptdescriptivo (hasta 3.000 caracteres), u omitirpromptcuando haya otra entrada no personalizada[4]. - Duración: al menos 6 segundos de línea de tiempo musical, verificado en nuestras pruebas reales del 19 de noviembre de 2026[4].
Solicitud funcional de la API de Suno MIDI para generar canciones
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"]
}'El endpoint devuelve un ID de tarea de inmediato. Consulta GET /api/v1/tasks/{id} hasta que status pase a "completed" o "failed"[4]. Una generación de Suno MIDI completada devuelve dos variaciones de audio en output.audio_urls[] y dos entradas de metadatos alineadas por índice en output.tracks[], cada una con id, url, title y duration reutilizables[4].
Qué falló realmente en nuestras pruebas en vivo de carga MIDI
La documentación por sí sola rara vez explica por qué se rechaza un archivo .mid válido. Cuando probamos la importación de Suno MIDI de principio a fin el 19 de noviembre de 2026 con tareas de generación reales de pago, aparecieron de inmediato dos casos realistas de fallo:
- Los bocetos cortos de menos de 6 segundos se rechazan. Nuestra primera prueba subió un archivo MIDI Format 0 válido de 58 bytes con cuatro negras a 120 BPM (2 segundos en total). La tarea falló con
"Your MIDI file is too short for us to check. Minimum duration is 6 seconds"y los créditos reservados se reembolsaron (usage.credits: 0). Rellena los riffs cortos hasta al menos 6 segundos antes de enviarlos. - Las escalas de manual pueden activar la coincidencia con grabaciones conocidas. Nuestra segunda prueba extendió el archivo a 10 segundos con una escala ascendente y descendente simple de do mayor. Aunque eran bytes MIDI recién sintetizados, la tarea falló con
"Our system matched this upload to a known recording"(de nuevo reembolsada con 0 créditos). Productores en r/SunoAI han reportado falsos positivos similares con melodías desnudas y ejercicios estándar. - Las progresiones polifónicas originales pasan sin problemas. Al cambiar la escala por una progresión original en re lidio de 12 segundos y 461 bytes con acordes y melodía a 100 BPM, la tarea finalizó en 54,2 segundos y devolvió dos variaciones MP3 reproducibles (
HTTP 200en la CDN de reAPI).
Si construyes un pipeline automatizado alrededor de cargas Suno MIDI, atrapa ambos modos de fallo cuanto antes: inspecciona la duración MIDI localmente en tu cliente antes de llamar a la API (bloquea todo lo inferior a 6 segundos) y advierte a los usuarios de que las escalas simples o melodías de versiones reconocibles pueden disparar un rechazo por huella acústica.
Exportación de Suno MIDI desde canciones y stems
Pasar de audio de vuelta a notas es siempre una tarea en dos etapas. Ni Suno Studio ni la API de Suno MIDI transcriben un máster estéreo denso directamente a MIDI en un solo paso.
Dentro de Suno Studio, primero divides tu clip mediante el panel Stems para aislar voces, batería, bajo u otras capas. Una vez que existen stems individuales de Suno MIDI, haz clic en el stem deseado y elige Get MIDI en el menú contextual. Studio cobra 10 créditos de Suno y genera un archivo Standard MIDI listo para arrastrar a una DAW[2].
A través de la interfaz HTTP de reAPI, la secuencia refleja el diseño de Studio, con una ventaja práctica: no necesitas haber generado primero la pista original en Suno.
Paso 1: separar stems con suno-vocal-separation
suno-vocal-separation admite dos formatos de origen mutuamente excluyentes[4]:
- Pista existente generada en reAPI: pasa
task_id(el ID completadotask_...de reAPI) yaudio_id(elidde una entrada deoutput.tracks[]). - Tu propio audio subido: pasa solo
audio_url(URL HTTP(S) pública, hasta 20 MB; no se requiereaudio_id). Los clientes heredados que siguen pasandoaudio_idjunto conaudio_urlsiguen aceptándose por retrocompatibilidad[4].
Elige el type de separación con criterio, ya que modifica tanto el costo como la precisión posterior de la exportación de Suno MIDI:
separate_vocal(predeterminado,0,05 US$/ 50 créditos): divide en 2 stems (VocalseInstrumental)[4][5].split_stem_advanced(0,10 US$/ 100 créditos): aísla un instrumento concreto mediantestem_name(98 instrumentos compatibles comoPiano,Bass,Electric Guitar,Drum KitoLead Vocal)[4][5].split_stem(0,25 US$/ 250 créditos): divide en hasta 12 stems de una sola vez[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"
}'Cuando GET /api/v1/tasks/{sep_task_id} se completa, output.tracks[] devuelve cada stem separado con su label (como Vocals o Instrumental) y su propio id de pista[4].
Paso 2: transcribir stems separados con suno-midi
Después, envía model: "suno-midi" con task_id configurado con el ID de la tarea de separación vocal en lugar del ID de tarea original de suno-music[4]. Pasar un ID simple de generación musical es rechazado. Incluye audio_id de output.tracks[].id de la tarea de separación para transcribir un stem, u omite audio_id para transcribir todos los stems separados[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"
}'A diferencia de la descarga .mid de Studio, la API de Suno MIDI devuelve datos estructurados de notas dentro de 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 }
]
}
]
}
}
}
}Cada entrada de nota incluye el pitch MIDI estándar (0–127), los tiempos start y end en segundos y una velocity normalizada (0–1)[4]. Si tu herramienta posterior espera un archivo .mid binario en lugar de JSON, convertir output.result.midi en Node.js con @tonejs/midi lleva unas pocas líneas:
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()));
}Expectativas realistas sobre la calidad de exportación de Suno MIDI
Los productores en r/SunoAI que intentaron importar la exportación de Suno MIDI directamente en programas de notación como MuseScore suelen reportar notas fantasma sueltas, ritmos inestables o filtración polifónica. Esa crítica responde a dos realidades técnicas:
- La transcripción de audio a MIDI hereda la filtración entre stems. Cualquier cola de reverberación o capa superpuesta de acordes que quede en un stem se convierte en notas cortas adicionales durante la detección de altura. Ejecutar
split_stem_advancedsobre un instrumento limpio (comoPianooBass) o usarseparate_vocalantes de llamar asuno-midisuele producir arreglos de notas más limpios que transcribir una mezcla completa densa. split_stemde 12 stems puede devolver datos de notas vacíos. Como documenta la referencia de Suno en reAPI, las separaciones creadas contype: "split_stem"pueden no detectar ninguna nota en absoluto en stems escasos o con ruido[4]. Si no sobrevive ningún dato de nota tras la transcripción, reAPI marca la tareasuno-midicomo fallida y reembolsa el crédito en vez de devolver un resultado vacío[4].
Trata el Suno MIDI extraído como un boceto armónico y rítmico editable en tu DAW, no como una partitura lista para imprimir. Cuantiza (Shift+Q en Studio o en la cuadrícula de tu DAW), elimina artefactos de baja velocidad menores a 50 ms y asigna tus propios instrumentos virtuales.
Precios y límites de caracteres en todo el pipeline
reAPI cobra las solicitudes de Suno con tarifas fijas por operación que no varían según la duración del audio ni la versión del modelo (V6, V6_MINI y V6_WILD cuestan lo mismo). Las tareas fallidas y rechazadas se reembolsan automáticamente. Las tarifas siguientes se verificaron en /models/suno el 19 de noviembre de 2026; consulta la página del modelo Suno o la página de Suno V6 en vivo para ver los precios actuales[5].
| Paso en el pipeline de Suno MIDI | model de reAPI + opción | Tarifa (USD, verificada el 19 nov 2026)[5] | Créditos (1 crédito = 0,001 US$)[5] |
|---|---|---|---|
| Generar canción desde MIDI (2 pistas) | suno-music (V6_WILD + midi_urls) | 0,06 US$[5] | 60 |
| Separar voces + instrumental | suno-vocal-separation (separate_vocal) | 0,05 US$[5] | 50 |
| Aislar 1 de 98 instrumentos | suno-vocal-separation (split_stem_advanced) | 0,10 US$[5] | 100 |
| Dividir en hasta 12 stems | suno-vocal-separation (split_stem) | 0,25 US$[5] | 250 |
| Extraer JSON de notas MIDI de stems | suno-midi | 0,001 US$[5] | 1 |
Con las tarifas del 19 de noviembre de 2026 anteriores, un ciclo completo de ida y vuelta con Suno MIDI (generar una pista desde MIDI por 0,06 US$, separar voces e instrumental por 0,05 US$ y transcribir JSON MIDI por 0,001 US$) suma 0,111 US$ (111 créditos)[5]. Si aportas tu propio archivo de audio y solo extraes notas de piano aisladas mediante split_stem_advanced (0,10 US$) más suno-midi (0,001 US$), el flujo de dos llamadas suma 0,101 US$ (101 créditos)[5].
Como los desarrolladores también encuentran errores de validación de texto al combinar prompts con solicitudes de Suno MIDI, aquí tienes los límites exactos de caracteres de V6 en suno-music[4]:
prompt: hasta 3.000 caracteres en modo inspiración (custom_mode: false, requerido pormidi_urls), o hasta 5.000 caracteres en modo personalizado (custom_mode: true) en modelos V6.lyrics: hasta 5.000 caracteres (tiene prioridad sobrepromptcomo letra cantada).style: hasta 1.000 caracteres en modelos V6 (200 en el antiguo V4).title: hasta 80 caracteres ensuno-music(100 en operaciones V6 extend y mashup).
Preguntas frecuentes
¿Cómo se exporta MIDI desde Suno?
En Suno Studio, divide primero tu clip en stems desde el panel Stems, luego selecciona un stem y elige Get MIDI (10 créditos de Suno) para descargar un archivo Standard MIDI[2]. A través de la API de Suno MIDI en reAPI, ejecuta primero suno-vocal-separation y pasa el task_id de esa tarea de separación completada a suno-midi para obtener JSON estructurado de instrumentos y notas[4].
¿Puedo subir varios archivos MIDI en el mismo prompt?
No. Según los requisitos actuales de Suno MIDI en suno-music, midi_urls acepta un máximo de una URL .mid o .midi por solicitud[4]. Si tu arreglo reparte piano, bajo y batería en pistas de DAW separadas, expórtalas en un único archivo Standard MIDI multicanal (hasta 16 canales, menos de 256 KB) antes de subirlo[1][4].
¿Por qué rechazó Suno mi archivo .mid válido?
En nuestras pruebas reales del 19 de noviembre de 2026 aparecieron dos motivos frecuentes: la línea de tiempo MIDI duraba menos de 6 segundos ("Minimum duration is 6 seconds"), o una escala simple activó la coincidencia con grabaciones conocidas ("Our system matched this upload to a known recording"). Verifica también que el archivo comience con el encabezado binario estándar MThd, pese 256 KB o menos y se sirva desde una URL pública HTTP(S) en lugar de una URI data:[4].
¿Ofrece Suno acceso oficial por API para MIDI?
Suno no publica una API REST pública general para desarrolladores. Sus funciones nativas de Suno MIDI viven dentro de la app web de Suno y Studio para suscriptores Pro y Premier[1][3]. Los desarrolladores que crean pipelines automatizados usan pasarelas API unificadas como la API de Suno de reAPI, que expone midi_urls, suno-vocal-separation y suno-midi detrás de un único token Bearer y un contrato de sondeo asíncrono[4].
¿Cuántos caracteres permite Suno en los prompts al usar MIDI?
Al pasar midi_urls en suno-music, la solicitud se ejecuta en modo inspiración (custom_mode: false), donde prompt permite hasta 3.000 caracteres[4]. En modo personalizado sin adjuntos MIDI, prompt y lyrics permiten hasta 5.000 caracteres en modelos V6, style hasta 1.000 y title hasta 80[4].
¿Puedo usar Suno MIDI en un flujo real de producción musical en DAW?
Sí, siempre que trates cada dirección según sus puntos fuertes. Empezar una canción desde tu propio archivo MIDI de DAW ofrece un control armónico y estructural más ajustado que los prompts de texto por sí solos[1]. Extraer MIDI a partir de audio de Suno funciona bien para capturar voicings de acordes, líneas de bajo o melodías y volver a dispararlas con plugins de DAW, siempre que separes los stems con limpieza primero y reserves unos minutos para cuantización y limpieza de notas fantasma.
Decidir entre Studio y la API para trabajar con Suno MIDI
Elige Suno Studio si eres un productor individual que improvisa con un teclado USB en Chrome, edita notas en una línea de tiempo del navegador y exporta ocasionalmente stems WAV o archivos .mid a mano[2][3]. Elige el flujo HTTP de reAPI cuando quieras ejecutar midi_urls sobre V6_WILD sin suscripción mensual, procesar audio subido de forma programática mediante suno-vocal-separation y suno-midi, o consumir arreglos de notas directamente en JSON. En cualquiera de los dos casos, obtener resultados fiables de Suno MIDI se reduce a dos hábitos: exportar a la entrada archivos .mid multicanal originales de al menos 6 segundos, y aislar los stems con cuidado antes de transcribir a la salida.
Consulta el esquema completo de parámetros en la documentación de la API de Suno de reAPI o prueba llamadas directamente en el navegador en la página del modelo Suno.
Referencias
- Suno. Start Songs with MIDI. Publicado el 4 de noviembre de 2026. Consultado en noviembre de 2026 en suno.com/blog/MIDI-in-create
- Suno Help Center. Exporting from Studio. Consultado en noviembre de 2026 en help.suno.com/en/articles/8128193
- Suno Help Center. MIDI in Studio. Consultado en noviembre de 2026 en help.suno.com/en/articles/13670593
- reAPI. Documentación de la API de Suno. Consultado en noviembre de 2026 en reapi.ai/docs/suno
- reAPI. Página del modelo Suno y precios en vivo. Consultado en noviembre de 2026 en reapi.ai/models/suno