API отримання MIDI

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

Опис кінцевої точки

Кінцева точка MIDI перетворює доріжки, які вже мають stems, у стандартний MIDI-файл — для аранжування, подальшої творчої роботи чи імпорту в DAW.

Suno не надає адреси для завантаження MIDI-файлів; він дає лише дані нот кожної доріжки (висота, час початку й завершення, сила натискання). Ця кінцева точка перетворює ці дані на стандартний MIDI-файл (SMF format 1) і повертає його напряму, тож ви завжди отримуєте справжній .mid, який відкривається в DAW.

Кінцева точка: POST /api/music/download-file

Ця сторінка — приклад саме для MIDI. Повний опис родини завантажень (адреси медіа, окремі файли, пакування, прослуховування під час генерації) — у API завантаження та прослуховування медіа пісень.

Оплата: Безкоштовно. Ця кінцева точка читає дані нот наявних stems і не списує баланс.

Параметри запиту

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-файл

Примітки

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