MIDI प्राप्ति API

2026-09-18 को अद्यतन · Suno-API टीम

एंडपॉइंट विवरण

MIDI एंडपॉइंट उन ट्रैक को, जिनके stem पहले से हैं, मानक MIDI फ़ाइल में बदलता है — अरेंजमेंट, आगे के रचनात्मक काम या DAW में आयात के लिए।

Suno MIDI फ़ाइल के लिए डाउनलोड पता नहीं देता; वह केवल प्रत्येक ट्रैक का नोट डेटा (पिच, शुरुआत और अंत का समय, वेलोसिटी) देता है। यह एंडपॉइंट उस नोट डेटा को मानक MIDI फ़ाइल (SMF format 1) में बदलकर सीधे लौटाता है, इसलिए जो मिलता है वह हमेशा असली .mid फ़ाइल होती है जिसे DAW खोल सकता है।

एंडपॉइंट: POST /api/music/download-file

यह पृष्ठ MIDI के लिए विशेष उदाहरण है। डाउनलोड परिवार (मीडिया पते, एकल फ़ाइल, पैकिंग, बनते समय प्रीव्यू) का पूरा विवरण गाना मीडिया डाउनलोड और प्रीव्यू API में है।

बिलिंग: निःशुल्क। यह एंडपॉइंट मौजूदा stem का नोट डेटा पढ़ता है और कोटा नहीं काटता।

अनुरोध पैरामीटर

Headers

पैरामीटर	प्रकार	ज़रूरी	नोट
Authorization	string	हाँ	Bearer YOUR_API_KEY
Content-Type	string	हाँ	application/json

बॉडी पैरामीटर

पैरामीटर	प्रकार	ज़रूरी	डिफ़ॉल्ट	नोट
song_id	string	हाँ	-	अलग करने के बाद एक ट्रैक का ID (`/api/music/separate` द्वारा लौटाया गया हर clip id)
kind	string	हाँ	-	`midi` पर निश्चित

अनुरोध उदाहरण

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 नहीं।

प्रतिक्रिया हेडर	मान
Content-Type	`audio/midi`
Content-Disposition	`attachment; filename="<गाने का शीर्षक>.mid"`

डाउनलोड पता पाना

अगर पहले पता चाहिए और फिर डाउनलोड (जैसे कई फ़ाइलों को पैक करने के लिए), तो पहले यह कॉल करें:

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 फ़ाइल के बारे में

मद	मान	नोट
फ़ाइल फ़ॉर्मैट	SMF format 1	1 Tempo ट्रैक + प्रत्येक वाद्य के लिए 1 ट्रैक
समय रिज़ॉल्यूशन	480 PPQ	प्रति बीट 480 tick
टेम्पो	120 BPM	Suno केवल सेकंड देता है, BPM नहीं, इसलिए टाइमलाइन लिखने के लिए निश्चित टेम्पो इस्तेमाल होता है
टाइमलाइन	`1 सेकंड = 960 tick`	प्लेटफ़ॉर्म द्वारा लौटाए गए सेकंड से एक-से-एक मेल खाता है; DAW में ज़रूरत के अनुसार टेम्पो बदलें
वेलोसिटी	0–127	प्लेटफ़ॉर्म 0–1 फ़्लोट देता है; एंडपॉइंट ने उन्हें ×127 से बदल दिया है
ड्रम	MIDI चैनल 10	प्लेटफ़ॉर्म द्वारा ड्रम चिह्नित ट्रैक स्वतः पर्कशन चैनल पर रखे जाते हैं

नोट

केवल उन ट्रैक के लिए मान्य जिनके stem हैं: song_id वही ट्रैक ID होना चाहिए जो /api/music/separate लौटाता है, मूल गाने का ID नहीं।
बिना नोट वाला stem सामान्य परिणाम है: कुछ ट्रैक (जैसे FX) में बदलने योग्य नोट नहीं होते; ऐसी स्थिति में त्रुटि के बजाय बिना नोट वाली वैध MIDI फ़ाइल लौटाई जाती है।
MIDI में केवल नोट जानकारी होती है: वॉल्यूम, पैन और इफ़ेक्ट MIDI में नहीं होते; DAW में खुद टिम्बर सेट करें।
हर ट्रैक अलग से माँगें: एक अनुरोध एक ट्रैक की .mid लौटाता है; कई ट्रैक के लिए हर एक को कॉल करें या Create UI का बैच पैक डाउनलोड इस्तेमाल करें।

अगलागाने की मीडिया डाउनलोड और प्रीव्यू API

API कुंजी प्राप्त करें

रजिस्टर करने के बाद कंसोल में API कुंजी बनाएँ। प्रत्येक जनरेशन का खर्च 0.6 युआन है और 2 ट्रैक मिलते हैं, डाउनलोड असीमित हैं और फ़ोन नंबर की ज़रूरत नहीं है।

API कुंजी लें अवलोकन पर लौटें