स्टाइल बूस्ट API
एंडपॉइंट विवरण
स्टाइल बूस्ट छोटे स्टाइल टैग को अधिक पूर्ण और Suno जनरेशन के लिए अधिक उपयुक्त स्टाइल विवरण में बदलता है, और पूरे बोल से स्टाइल अंश भी बना सकता है।
एंडपॉइंट: POST /api/music/boost-style
बिलिंग: कोटा के भीतर मुफ़्त (प्रति उपयोगकर्ता प्रति मिनट अधिकतम 10 कॉल और प्रति दिन 300); मुफ़्त कोटा पार करने पर प्रति कॉल 0.1 युआन।
सीमा पार होने की पहचान: मुफ़्त कोटा पार होने पर भी अनुरोध सामान्य रूप से चलता है, और प्रतिक्रिया हेडर में X-Suno-Helper-Free: false तथा X-Suno-Helper-Over-Limit: minute (या day) आते हैं, जिससे क्लाइंट बता सकता है कि इस कॉल पर शुल्क लगा है।
सुझाया गया मॉडल: suno-v6। suno-v6, suno-v6-wild और suno-v6-mini उपलब्ध हैं।
चीनी आउटपुट: जब अनुरोध की सामग्री (originalTags/lyrics/user_guidance) में चीनी हो और भाषा घोषित न हो, तो सेवा original_tags के बाद स्वतः （请用中文描述） जोड़ देती है और user_guidance=语言：简体中文；乐器名也用中文 भी जोड़ देती है, ताकि चीनी स्टाइल विवरण मिलने की संभावना बढ़े। वास्तव में भेजे गए मान प्रतिक्रिया में appliedOriginalTags और appliedUserGuidance के रूप में लौटते हैं। अगर भेजी गई सामग्री में भाषा पहले से स्पष्ट है (जैसे "सरल चीनी में लिखें"), तो सेवा कोई बदलाव नहीं करती।
प्रमाणीकरण
| पैरामीटर | प्रकार | ज़रूरी | नोट |
|---|---|---|---|
| Authorization | string | हाँ | Bearer YOUR_API_KEY |
| Content-Type | string | हाँ | application/json |
अनुरोध पैरामीटर
| पैरामीटर | प्रकार | ज़रूरी | डिफ़ॉल्ट | नोट |
|---|---|---|---|---|
| model | string | हाँ | - | ग्राहक के लिए मॉडल नाम: suno-v6, suno-v6-wild या suno-v6-mini |
| originalTags | string | नहीं | - | मूल स्टाइल टैग |
| original_tags | string | नहीं | - | originalTags का संगत उपनाम |
| style | string | नहीं | - | मूल स्टाइल टैग; originalTags के साथ इनमें से एक |
| instrumental | boolean | नहीं | false | क्या वाद्य दिशा में बूस्ट करना है |
| lyrics | string | नहीं | - | पूरे बोल; भेजने पर उनकी सामग्री से स्टाइल विवरण बनता है |
| user_guidance | string | नहीं | - | उपयोगकर्ता का सामान्य-भाषा अनुरोध, जैसे "सुओना और एर्हू जोड़ें, पुरुष स्वर, तेज़ लय"; प्लेटफ़ॉर्म पर इसी नाम का फ़ील्ड है और यह जैसा है वैसा ही भेजा जाता है |
अनुरोध उदाहरण
curl -X POST https://www.suno-api.io/api/music/boost-style \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"originalTags": "pop, piano, male vocal",
"lyrics": "[Verse]\nखिड़की के बाहर रात उतरती है\n[Chorus]\nहम रोशनी की ओर चलते हैं",
"user_guidance": "सुओना और एर्हू जोड़ें, पुरुष स्वर, तेज़ लय",
"instrumental": false
}'
प्रतिक्रिया
{
"code": 200,
"message": "success",
"data": {
"originalTags": "pop, piano, male vocal",
"instrumental": false,
"upsampledStyle": "Mandopop, expressive male vocal, warm piano ballad...",
"requestId": "request_id"
}
}
upsampledStyle वह पूरा स्टाइल विवरण है जिसे Style फ़ील्ड में वापस लिखा जाना चाहिए।
API कुंजी प्राप्त करें
रजिस्टर करने के बाद कंसोल में API कुंजी बनाएँ। प्रत्येक जनरेशन का खर्च 0.6 युआन है और 2 ट्रैक मिलते हैं, डाउनलोड असीमित हैं और फ़ोन नंबर की ज़रूरत नहीं है।
API कुंजी लें अवलोकन पर लौटें