API lấy MIDI

Cập nhật 2026-09-18 · nhóm Suno-API

Mô tả endpoint

Endpoint MIDI chuyển các track đã tách stem thành tệp MIDI chuẩn, để phối khí, sáng tác tiếp hoặc nhập vào DAW.

Suno không cung cấp địa chỉ tải tệp MIDI; chỉ cung cấp dữ liệu nốt của từng track (cao độ, thời điểm bắt đầu và kết thúc, lực nhấn). Endpoint này chuyển dữ liệu nốt đó thành tệp MIDI chuẩn (SMF format 1) rồi trả về trực tiếp, nên thứ bạn nhận luôn là một tệp .mid thật mà DAW mở được.

Endpoint: POST /api/music/download-file

Trang này là ví dụ riêng cho MIDI. Mô tả đầy đủ về nhóm tải xuống (địa chỉ media, tệp đơn, đóng gói, nghe thử khi đang tạo) nằm trong API tải và nghe thử media của bài hát.

Tính phí: Miễn phí. Endpoint này đọc dữ liệu nốt của các stem đã có và không trừ hạn mức.

Tham số yêu cầu

Headers

Tham số body

Ví dụ yêu cầu

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

Phản hồi

Phần thân phản hồi là nội dung nhị phân của tệp MIDI, không phải JSON.

Lấy địa chỉ tải xuống

Nếu cần lấy địa chỉ trước rồi mới tải (ví dụ để đóng gói nhiều tệp), hãy gọi trước:

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

Địa chỉ đó cũng cần header Authorization mới truy cập được; không có khóa API sẽ trả về 401.

Về tệp MIDI

Lưu ý

• Chỉ hiệu lực với track đã tách stem: song_id phải là ID track do /api/music/separate trả về, không phải ID bài hát gốc.
• Stem không có nốt vẫn là kết quả bình thường: một số track (ví dụ FX) không có nốt để chuyển thành bản phổ; khi đó hệ thống trả về tệp MIDI hợp lệ không có nốt thay vì báo lỗi.
• MIDI chỉ chứa thông tin nốt: âm lượng, pan và hiệu ứng không nằm trong MIDI; hãy tự đặt âm sắc trong DAW.
• Mỗi track yêu cầu riêng: một yêu cầu trả về .mid của một track; với nhiều track, hãy gọi từng track hoặc dùng tính năng tải gói hàng loạt của Create UI.