API получения MIDI

Обновлено 2026-09-18 · команда Suno-API

Описание эндпоинта

Эндпоинт MIDI преобразует дорожки, для которых уже сделано разделение на стемы, в стандартный MIDI-файл — для аранжировки, дальнейшего творчества или импорта в DAW.

Suno не предоставляет адрес для скачивания MIDI-файлов, а отдаёт только данные нот каждой дорожки (высота, время начала и конца, сила нажатия). Этот эндпоинт преобразует эти данные в стандартный MIDI-файл (SMF format 1) и возвращает его напрямую, поэтому вы всегда получаете настоящий .mid, который открывается в DAW.

Эндпоинт: POST /api/music/download-file

Эта страница — пример именно для MIDI. Полное описание семейства загрузок (адреса медиа, отдельные файлы, упаковка, прослушивание во время генерации) — в API скачивания и прослушивания медиа песен.

Оплата: Бесплатно. Этот эндпоинт читает данные нот существующих стемов и не списывает квоту.

Параметры запроса

Headers

Параметры тела запроса

Пример запроса

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

Ответ

Тело ответа — бинарное содержимое MIDI-файла, а не JSON.

Получение адреса для скачивания

Если сначала нужен адрес, а скачивание потом (например, для упаковки нескольких файлов), вызовите сначала:

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

Этот адрес также требует заголовок Authorization; без ключа API возвращается 401.

О MIDI-файле

Примечания

• Работает только для дорожек, уже разделённых на стемы: song_id должен быть идентификатором дорожки из /api/music/separate, а не идентификатором исходной песни.
• Стем без нот — нормальный результат: у некоторых дорожек (например, FX) нет расшифровываемых нот; в этом случае вместо ошибки возвращается корректный MIDI-файл без нот.
• MIDI содержит только информацию о нотах: громкость, панорама и эффекты в MIDI не входят; тембр нужно задавать в DAW самостоятельно.
• Каждую дорожку запрашивайте отдельно: один запрос возвращает .mid одной дорожки; для нескольких дорожек вызывайте каждую по отдельности или используйте пакетное скачивание в Create UI.