· reAPI Team
Импорт и экспорт Suno MIDI: требования и руководство по API
Руководство по импорту и экспорту Suno MIDI: требования к файлам V6_WILD, минимальная длительность 6 секунд, рабочий процесс API JSON для перевода стемов в MIDI и текущие тарифы за запрос.

Suno MIDI теперь работает в обоих направлениях, и технические правила для каждой стороны разные. 4 ноября 2026 года Suno добавила загрузку MIDI-файлов прямо на страницу Create, позволив подписчикам Pro и Premier начинать песню V6 из файла .mid или .midi, а не полагаться только на текстовые промпты[1]. В обратную сторону преобразование сгенерированного ИИ трека обратно в редактируемые ноты по-прежнему требует предварительного разделения на стемы — независимо от того, нажимаешь ли ты Get MIDI в Suno Studio[2] или связываешь два эндпоинта через Suno MIDI API[4].
Большинство статей рассматривают Suno MIDI как одну кнопку экспорта или ограничиваются общими советами по сведению в DAW. Если ты разрабатываешь аудиоинструменты или перекидываешь наброски между DAW и Suno, реальные сложности кроются в ограничениях: какая версия модели выполняет импорт Suno MIDI, почему синтаксически корректный файл .mid отклоняется до рендеринга, как извлечение через API возвращает JSON с нотами вместо бинарного .mid-файла и сколько стоит каждый шаг. Всё нижеследующее объединяет актуальную документацию Suno с нашими собственными боевыми тестовыми запусками API от 19 ноября 2026 года.
Два рабочих процесса Suno MIDI и когда подходит каждый из них
Прежде чем писать код интеграции или оплачивать ежемесячный тариф Studio, раздели два направления. Импорт Suno MIDI превращает беззвучную последовательность нот в полноценную аранжировку, выступая быстрой альтернативой загрузке гигабайтов библиотек сэмплов для раннего демо. Экспорт Suno MIDI работает наоборот: он извлекает данные о высоте, тайминге и велосити из разделённых стемов, чтобы ты мог заменить синтезаторы, проверить расположение аккордов или пересобрать партии в Logic, Ableton, FL Studio или MuseScore.
| Деталь процесса | Веб-приложение Suno / Studio (UI) | HTTP API reAPI (/api/v1/audio/generations) |
|---|---|---|
| Начать песню с MIDI | Перетащить .mid / .midi на Create (режим Simple, v6-wild, тарифы Pro/Premier)[1] | model: "suno-music", custom_mode: false, version: "V6_WILD", midi_urls (1 публичный URL)[4] |
| Живой piano roll и USB-контроллеры | Нативные MIDI-дорожки в Studio с Web MIDI API (Chrome; Safari не поддерживает Web MIDI)[3] | Неприменимо (пайплайн REST-задач без состояния) |
| Извлечь MIDI из песни | Извлечь стемы в Studio, затем правый клик по стему и Get MIDI (10 кредитов Suno)[2] | Шаг 1: suno-vocal-separation (сгенерированный трек или внешний audio_url). Шаг 2: suno-midi по task_id задачи разделения[4] |
| Формат экспортированного MIDI | Скачивание стандартного файла .mid[2] | Структурированный JSON (instruments[].notes[] с полями pitch, start, end и velocity)[4] |
| Модель оплаты (проверено 19 нояб. 2026) | Тарифы подписки (Pro / Premier) + баланс кредитов Suno[1][2] | Фиксированная оплата за запрос на reAPI Suno: 0,06 $ генерация музыки, от 0,05 $ до 0,25 $ разделение на стемы, 0,001 $ извлечение MIDI[5] |
Если ты хочешь джемить вживую на USB-клавиатуре, квантизировать ноты в браузерном piano roll или собирать дубли на аудиотаймлайне, Suno Studio — подходящая среда. Safari сейчас не поддерживает Web MIDI, поэтому Suno рекомендует Google Chrome для аппаратных контроллеров в Studio[3]. Если тебе нужна пакетная обработка, интеграция в приложение или оплата за каждый запрос без регулярной подписки, автоматизировать Suno MIDI API намного проще.
Требования Suno MIDI и импорт файлов .mid через API
Standard MIDI File не содержит звука. Как отмечает Suno в анонсе от 4 ноября 2026 года, файл .mid или .midi хранит до 16 каналов событий высоты и времени, каждый из которых поддерживает до 120 дорожек контроллеров для таких параметров, как сустейн, громкость и модуляция[1]. Передача этого файла в Suno даёт модели точный тайминг нот и гармоническое движение, а твой промпт управляет тем, насколько строго результат следует партитуре: ты можешь попросить сыграть аккорды дословно струнным квартетом или позаимствовать короткий мотив и развить его в новом жанре[1].
На запуске импорт Suno MIDI работает в режиме Simple (вдохновение) на V6_WILD[1]. В reAPI это соответствует model: "suno-music" с custom_mode: false, version: "V6_WILD" и midi_urls, содержащим один публичный HTTP(S) URL[4]. Передача другой версии вместе с midi_urls переключает выполнение на V6_WILD на стороне апстрима[4]. Base64 и URI вида data: отклоняются на уровне всей платформы, поэтому размести файл .mid в публичном объектном хранилище (или загрузи через загрузчик suno-midi в playground) перед вызовом эндпоинта генерации[4].
Точные ограничения файлов и тела запроса
Каждый запрос импорта Suno MIDI должен пройти пять требований Suno MIDI, прежде чем модель начнёт рендерить аудио:
- Формат: стандартный бинарный файл
.midили.midi, начинающийся с заголовкаMThd[4]. - Размер файла: максимум 256 KB[4].
- Количество файлов: 1 MIDI URL на запрос (
midi_urlsпринимает не более одного элемента), а общее число ссылочных вложений (style,lyrics,image_urls,audio_urls,video_urlsиmidi_urls) не может превышать 10[4]. - Режим: только режим вдохновения (
custom_mode: false). Ты можешь сочетатьmidi_urlsс описательнымprompt(до 3 000 символов) или опуститьprompt, если присутствует другой не-custom ввод[4]. - Длительность: не менее 6 секунд музыкального таймлайна, подтверждено нашими боевыми тестами 19 ноября 2026 года[4].
Рабочий запрос Suno MIDI API для генерации песни
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"]
}'Эндпоинт сразу возвращает ID задачи. Опрашивай GET /api/v1/tasks/{id}, пока status не станет "completed" или "failed"[4]. Завершённая генерация Suno MIDI возвращает два аудиоварианта в output.audio_urls[] и две выровненные по индексу записи метаданных в output.tracks[], каждая из которых содержит пригодные для повторного использования id, url, title и duration[4].
Что реально не прошло в наших боевых тестах загрузки MIDI
Одна только документация редко объясняет, почему валидный файл .mid отклоняется. Когда 19 ноября 2026 года мы протестировали импорт Suno MIDI от начала до конца на реальных платных задачах генерации, сразу проявились два реалистичных случая сбоя:
- Короткие наброски длительностью менее 6 секунд отклоняются. В первом тесте мы загрузили валидный 58-байтный MIDI-файл Format 0 с четырьмя четвертными нотами при 120 BPM (всего 2 секунды). Задача завершилась ошибкой
"Your MIDI file is too short for us to check. Minimum duration is 6 seconds", а зарезервированные кредиты были возвращены (usage.credits: 0). Перед отправкой удлиняй короткие риффы минимум до 6 секунд. - Учебные гаммы могут сработать на проверке совпадения с известными записями. Во втором тесте мы увеличили длительность файла до 10 секунд простой восходящей и нисходящей гаммой до мажор. Хотя файл состоял из свежесинтезированных MIDI-байтов, задача завершилась ошибкой
"Our system matched this upload to a known recording"(снова с возвратом 0 кредитов). Продюсеры на r/SunoAI сообщали о похожих ложных срабатываниях на простых мелодиях и стандартных упражнениях. - Оригинальные полифонические прогрессии проходят чисто. Замена гаммы на оригинальную 12-секундную прогрессию аккордов и мелодии в ре лидийском размером 461 байт при 100 BPM завершилась за 54,2 секунды и вернула два воспроизводимых MP3-варианта (
HTTP 200на CDN reAPI).
Если ты строишь автоматизированный пайплайн вокруг загрузок Suno MIDI, перехватывай оба сценария сбоя заранее: проверяй длительность MIDI локально на клиенте до вызова API (блокируй всё короче 6 секунд) и предупреждай пользователей, что голые гаммы или узнаваемые мелодии каверов могут вызвать отклонение по аудиоотпечатку.
Экспорт Suno MIDI из песен и стемов
Преобразование аудио обратно в ноты — всегда двухэтапная задача. Ни Suno Studio, ни Suno MIDI API не транскрибируют плотный стереомастер напрямую в MIDI за один шаг.
В Suno Studio ты сначала делишь клип через панель Stems, чтобы выделить вокал, ударные, бас или другие слои. Когда отдельные стемы Suno MIDI получены, нажми на нужный стем и выбери Get MIDI в контекстном меню. Studio списывает 10 кредитов Suno и выдаёт файл Standard MIDI, готовый к перетаскиванию в DAW[2].
Через HTTP-интерфейс reAPI последовательность повторяет схему Studio, но с одним полезным преимуществом: исходный трек не обязан быть предварительно сгенерирован в Suno.
Шаг 1: раздели стемы с помощью suno-vocal-separation
suno-vocal-separation поддерживает два взаимоисключающих формата источника[4]:
- Существующий трек, сгенерированный на reAPI: передай
task_id(завершённый IDtask_...в reAPI) иaudio_id(полеidодной из записейoutput.tracks[]). - Своё загруженное аудио: передай только
audio_url(публичный HTTP(S) URL, до 20 MB;audio_idне требуется). Устаревшие клиенты, которые по-прежнему передаютaudio_idвместе сaudio_url, продолжают приниматься ради обратной совместимости[4].
Выбирай type разделения осознанно, потому что он влияет и на стоимость, и на точность последующего экспорта Suno MIDI:
separate_vocal(по умолчанию,0,05 $/ 50 кредитов): делит на 2 стема (VocalsиInstrumental)[4][5].split_stem_advanced(0,10 $/ 100 кредитов): выделяет один конкретный инструмент черезstem_name(98 поддерживаемых инструментов, напримерPiano,Bass,Electric Guitar,Drum KitилиLead Vocal)[4][5].split_stem(0,25 $/ 250 кредитов): делит до 12 стемов за один раз[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"
}'Когда GET /api/v1/tasks/{sep_task_id} завершится, output.tracks[] вернёт каждый выделенный стем с его label (например, Vocals или Instrumental) и собственным id дорожки[4].
Шаг 2: транскрибируй разделённые стемы с помощью suno-midi
Затем отправь model: "suno-midi", указав в task_id именно ID задачи разделения вокала, а не исходный ID задачи suno-music[4]. Передача обычного ID задачи генерации музыки будет отклонена. Укажи audio_id из output.tracks[].id задачи разделения, чтобы транскрибировать один стем, или опусти audio_id, чтобы транскрибировать все разделённые стемы[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"
}'В отличие от скачивания .mid в Studio, Suno MIDI API возвращает структурированные данные о нотах внутри 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 }
]
}
]
}
}
}
}Каждая запись ноты содержит стандартный MIDI pitch (0–127), время start и end в секундах и нормализованную velocity (0–1)[4]. Если твоему дальнейшему инструменту нужен бинарный файл .mid, а не JSON, конвертация output.result.midi в Node.js с @tonejs/midi занимает несколько строк:
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()));
}Реалистичные ожидания от качества экспорта Suno MIDI
Продюсеры на r/SunoAI, пробовавшие импортировать экспорт Suno MIDI напрямую в нотные редакторы вроде MuseScore, часто сообщают о случайных призрачных нотах, неровном ритме или полифоническом проникновении. Эта критика опирается на две технические реальности:
- Транскрибация аудио в MIDI наследует проникновение стемов. Любой хвост реверберации или перекрывающийся слой аккордов, оставшийся внутри стема, при определении высоты превращается в лишние короткие ноты. Запуск
split_stem_advancedдля одного чистого инструмента (например,PianoилиBass) или использованиеseparate_vocalперед вызовомsuno-midiобычно даёт более чистые массивы нот, чем транскрибация плотного полного микса. - 12-стемовый
split_stemможет вернуть пустые данные о нотах. Как указано в справочнике reAPI Suno, разделения, созданные сtype: "split_stem", могут вообще не выявить ни одной ноты на разрежённых или шумных стемах[4]. Если после транскрибации не остаётся никаких данных о нотах, reAPI помечает задачуsuno-midiкак неудавшуюся и возвращает кредит, а не отдаёт пустой результат[4].
Относись к извлечённому Suno MIDI как к редактируемому гармоническому и ритмическому эскизу в DAW, а не как к готовым к печати нотам. Выполни квантизацию (Shift+Q в Studio или по сетке твоей DAW), удали артефакты короче 50 ms с низкой велосити и назначь собственные виртуальные инструменты.
Цены и лимиты символов по всему пайплайну
reAPI тарифицирует запросы Suno по фиксированным ставкам за операцию, которые не зависят от длительности аудио или версии модели (V6, V6_MINI и V6_WILD стоят одинаково). Задачи, завершившиеся ошибкой или отклонённые, возмещаются автоматически. Указанные ниже тарифы проверены на /models/suno 19 ноября 2026 года; актуальные цены смотри на действующей странице модели Suno или странице Suno V6[5].
| Шаг пайплайна Suno MIDI | model reAPI + опция | Тариф (USD, проверено 19 нояб. 2026)[5] | Кредиты (1 кредит = 0,001 $)[5] |
|---|---|---|---|
| Генерация песни из MIDI (2 дорожки) | suno-music (V6_WILD + midi_urls) | 0,06 $[5] | 60 |
| Разделение вокала + инструментала | suno-vocal-separation (separate_vocal) | 0,05 $[5] | 50 |
| Выделение 1 из 98 инструментов | suno-vocal-separation (split_stem_advanced) | 0,10 $[5] | 100 |
| Разделение до 12 стемов | suno-vocal-separation (split_stem) | 0,25 $[5] | 250 |
| Извлечение MIDI JSON с нотами из стемов | suno-midi | 0,001 $[5] | 1 |
По приведённым выше тарифам на 19 ноября 2026 года полный цикл Suno MIDI туда и обратно (генерация трека из MIDI за 0,06 $, разделение вокала и инструментала за 0,05 $ и транскрибация MIDI JSON за 0,001 $) обходится в 0,111 $ (111 кредитов)[5]. Если ты загружаешь собственный аудиофайл и только извлекаешь изолированные партии фортепиано через split_stem_advanced (0,10 $) плюс suno-midi (0,001 $), этот процесс из двух вызовов стоит 0,101 $ (101 кредит)[5].
Поскольку разработчики также сталкиваются с ошибками валидации текста при сочетании промптов с запросами Suno MIDI, вот точные лимиты символов V6 для suno-music[4]:
prompt: до 3 000 символов в режиме вдохновения (custom_mode: false, который требуется дляmidi_urls), или до 5 000 символов в пользовательском режиме (custom_mode: true) на моделях V6.lyrics: до 5 000 символов (имеет приоритет надpromptкак текст для вокала).style: до 1 000 символов на моделях V6 (200 на устаревшей V4).title: до 80 символов наsuno-music(100 для операций V6 extend и mashup).
Часто задаваемые вопросы
Как экспортировать MIDI из Suno?
В Suno Studio сначала раздели клип на стемы через панель Stems, затем выбери стем и нажми Get MIDI (10 кредитов Suno), чтобы скачать файл Standard MIDI[2]. Через Suno MIDI API на reAPI сначала запусти suno-vocal-separation, а затем передай task_id этой завершённой задачи разделения в suno-midi, чтобы получить структурированный JSON с инструментами и нотами[4].
Можно ли загрузить несколько MIDI-файлов в одном промпте?
Нет. По текущим требованиям Suno MIDI для suno-music параметр midi_urls принимает не более одного URL .mid или .midi на запрос[4]. Если в твоей аранжировке фортепиано, бас и ударные разнесены по разным дорожкам DAW, экспортируй их перед загрузкой в один многоканальный Standard MIDI File (до 16 каналов, менее 256 KB)[1][4].
Почему Suno отклонила мой валидный файл .mid?
В наших боевых тестах 19 ноября 2026 года проявились две частые причины: MIDI-таймлайн был короче 6 секунд ("Minimum duration is 6 seconds"), либо простая гамма вызвала совпадение с известной записью ("Our system matched this upload to a known recording"). Также проверь, что файл начинается со стандартного бинарного заголовка MThd, не превышает 256 KB и отдаётся по публичному HTTP(S) URL, а не через data: URI[4].
Предоставляет ли Suno официальный доступ к API для MIDI?
Suno не публикует общий публичный REST API для разработчиков. Нативные возможности Suno MIDI находятся внутри веб-приложения Suno и Studio для подписчиков Pro и Premier[1][3]. Разработчики, строящие автоматизированные пайплайны, используют единые API-шлюзы, такие как Suno API от reAPI, предоставляющий midi_urls, suno-vocal-separation и suno-midi за одним Bearer-токеном и контрактом асинхронного опроса[4].
Сколько символов Suno допускает в промптах при использовании MIDI?
При передаче midi_urls в suno-music запрос выполняется в режиме вдохновения (custom_mode: false), где prompt допускает до 3 000 символов[4]. В пользовательском режиме без MIDI-вложений prompt и lyrics допускают до 5 000 символов на моделях V6, style — до 1 000, а title — до 80[4].
Можно ли использовать Suno MIDI в реальном процессе создания музыки в DAW?
Да, если использовать каждое направление согласно его сильным сторонам. Начало песни с собственного MIDI-файла из DAW даёт более точный гармонический и структурный контроль, чем одни только текстовые промпты[1]. Извлечение MIDI из аудио Suno хорошо подходит для снятия аккордовых расположений, басовых партий или мелодий с последующим воспроизведением через плагины DAW, при условии что ты сначала чисто разделишь стемы и заложишь несколько минут на квантизацию и очистку призрачных нот.
Выбор между Studio и API для работы с Suno MIDI
Выбирай Suno Studio, если ты сольный продюсер, который джемит с USB-клавиатурой в Chrome, редактирует ноты на браузерном таймлайне и время от времени вручную экспортирует WAV-стемы или файлы .mid[2][3]. Выбирай HTTP-процесс reAPI, когда нужно запускать midi_urls на V6_WILD без ежемесячной подписки, программно обрабатывать загруженное аудио через suno-vocal-separation и suno-midi или получать массивы нот напрямую в JSON. В любом случае надёжные результаты Suno MIDI сводятся к двум привычкам: на входе экспортировать оригинальные многоканальные .mid-файлы длиной не менее 6 секунд, а на выходе аккуратно выделять стемы перед транскрибацией.
Полную схему параметров читай в документации reAPI Suno API, либо протестируй запросы прямо в браузере на странице модели Suno.
Источники
- Suno. Start Songs with MIDI. Опубликовано 4 ноября 2026 года. Получено в ноябре 2026 года с suno.com/blog/MIDI-in-create
- Suno Help Center. Exporting from Studio. Получено в ноябре 2026 года с help.suno.com/en/articles/8128193
- Suno Help Center. MIDI in Studio. Получено в ноябре 2026 года с help.suno.com/en/articles/13670593
- reAPI. Документация Suno API. Получено в ноябре 2026 года с reapi.ai/docs/suno
- reAPI. Страница модели Suno и актуальные цены. Получено в ноябре 2026 года с reapi.ai/models/suno