रीमास्टर API (Remaster)
एंडपॉइंट विवरण
रीमास्टर किसी पूरे हो चुके गाने को बेहतर ऑडियो गुणवत्ता वाले "रीमास्टर संस्करण" के रूप में दोबारा बनाता है। यह एक बार में 2 वर्ज़न लौटाता है, और upstream शीर्षक में स्वतः (Remastered) जोड़ देता है।
एंडपॉइंट: POST /api/music/remaster
बिलिंग: सशुल्क, अनुरोध किए गए मॉडल के अनुसार (डिफ़ॉल्ट suno-v6, प्रति कॉल 0.6 CNY); असल में कटने वाली रकम बैक-ऑफ़िस मूल्य कॉन्फ़िगरेशन के अनुसार होती है।
मॉडल के बारे में: रीमास्टर upstream के एक समर्पित एंडपॉइंट और समर्पित रीमास्टर मॉडल का उपयोग करता है, जिसे प्लेटफ़ॉर्म ने तय किया है और जो model से नहीं बदलता; अनुरोध में model केवल कीमत और चैनल के लिए है, इसलिए suno-v6 स्पष्ट रूप से भेजने की सलाह दी जाती है।
प्रतीक्षा समय और टाइमआउट (ज़रूरी): यह सिंक्रोनस एंडपॉइंट है — ऑर्डर तभी स्वीकार होता है और रीमास्टर को सौंपा जाता है जब जवाब आ जाता है। क्लाइंट टाइमआउट 300 सेकंड या ज़्यादा रखें; जवाब न आना इसका मतलब नहीं कि रीमास्टर नहीं हुआ, और टाइमआउट के तुरंत बाद दोबारा कोशिश न करें (इससे ऑर्डर दोहरा होता है और दोबारा शुल्क लगता है)। अगर कनेक्शन टूट गया हो, तो बाद में
GET /api/music/songsसे जाँचें।
प्रमाणीकरण
| पैरामीटर | प्रकार | ज़रूरी | नोट |
|---|---|---|---|
| Authorization | string | हाँ | Bearer YOUR_API_KEY |
| Content-Type | string | हाँ | application/json |
अनुरोध पैरामीटर
| पैरामीटर | प्रकार | ज़रूरी | डिफ़ॉल्ट | नोट |
|---|---|---|---|---|
| song_id | string | हाँ | - | रीमास्टर किए जाने वाले स्रोत गाने का ID; वह पूरा हो चुका होना चाहिए और मौजूदा API कुंजी से सुलभ होना चाहिए |
| model | string | नहीं | suno-v6 | ग्राहक के लिए मॉडल नाम: suno-v6, suno-v6-wild या suno-v6-mini; केवल कीमत और चैनल के लिए |
| variation_category | string | नहीं | normal | भिन्नता की तीव्रता: subtle, normal, high (पुराना मान low = subtle) |
| style_profile | string | नहीं | boost | टिम्बर स्टाइल: natural, boost, clarity |
| tags | string | नहीं | - | आरक्षित फ़ील्ड; खाली न हो तो upstream को भेजा जाता है |
| source_audio_url | string | नहीं | - | स्रोत ऑडियो का पता, जब स्रोत गाना किसी बाहरी खाते से आया हो |
| source_file_name | string | नहीं | - | स्रोत फ़ाइल का नाम, जब स्रोत गाना किसी बाहरी खाते से आया हो |
| source_title | string | नहीं | - | स्रोत शीर्षक, जब स्रोत गाना किसी बाहरी खाते से आया हो |
audio_id, source_clip_id और sourceClipId — song_id के समान अर्थ वाले रूप हैं; इनमें से कोई एक इस्तेमाल करें।
अनुरोध उदाहरण
curl -X POST https://www.suno-api.io/api/music/remaster \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"song_id": "source_song_id",
"variation_category": "high",
"style_profile": "clarity"
}'
अगर डिफ़ॉल्ट मान काफ़ी हैं, तो केवल स्रोत गाना भेजें — यह variation_category: normal + style_profile: boost के बराबर है:
{ "model": "suno-v6", "song_id": "source_song_id" }
प्रतिक्रिया
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "remastered_clip_id_1",
"song_title": "स्रोत गाने का शीर्षक (Remastered)",
"status": "processing"
},
{
"song_id": "remastered_clip_id_2",
"song_title": "स्रोत गाने का शीर्षक (Remastered)",
"status": "processing"
}
]
}
}
एक कॉल 2 रीमास्टर वर्ज़न लौटाती है। दोनों clips[].song_id सहेजें, फिर ऑडियो लेने से पहले गाना क्वेरी और इतिहास API से complete तक पोल करें।
नोट
- स्रोत गाना पूरा हो चुका हो और मौजूदा API कुंजी की पहुँच सीमा में हो; बाहरी स्रोत सामग्री स्वतः निष्पादक खाते में समन्वयित हो जाती है।
- रीमास्टर केवल ऑडियो गुणवत्ता दोबारा बनाता है: स्टाइल, अरेंजमेंट या वोकल बदलने के लिए स्टाइल गहरा करना, अपलोड करके कवर या Remix एंडपॉइंट इस्तेमाल करें।
variation_categoryजितना बड़ा होगा, रीमास्टर वर्ज़न स्रोत गाने से उतना ही अलग होगा; असली डिलीवरी से पहलेnormalसे आज़माएँ, फिर बढ़ाएँ।
API कुंजी प्राप्त करें
रजिस्टर करने के बाद कंसोल में API कुंजी बनाएँ। प्रत्येक जनरेशन का खर्च 0.6 युआन है और 2 ट्रैक मिलते हैं, डाउनलोड असीमित हैं और फ़ोन नंबर की ज़रूरत नहीं है।
API कुंजी लें अवलोकन पर लौटें