साउंड इफ़ेक्ट जनरेशन API
एंडपॉइंट विवरण
साउंड इफ़ेक्ट जनरेशन कुछ सेकंड की ऑडियो बनाता है, कोई गाना नहीं। यह गड़गड़ाहट, बारिश की बूँदें या टकराव जैसी छोटी आवाज़ों के लिए उपयुक्त है, और ट्रांज़िशन इफ़ेक्ट, एम्बिएंस तथा ड्रम लूप के लिए भी काम करता है; ज़्यादातर 5 सेकंड से कम और सबसे लंबा लगभग 20 सेकंड का होता है। एक बार और लूप दोनों मोड समर्थित हैं।
एंडपॉइंट: POST /api/music/sounds
बिलिंग: सशुल्क, फ़िलहाल डिफ़ॉल्ट रूप से 0.6 CNY प्रति कॉल। असल में कटने वाली रकम मौजूदा बैक-ऑफ़िस मूल्य कॉन्फ़िगरेशन के अनुसार होती है।
प्रतीक्षा समय और टाइमआउट (ज़रूरी): यह सिंक्रोनस एंडपॉइंट है — ऑर्डर तभी स्वीकार होता है और जनरेशन को सौंपा जाता है जब जवाब आ जाता है। मापन के अनुसार ज़्यादातर अनुरोध 1-3 सेकंड में जवाब देते हैं, लगभग 10% 30 सेकंड से ज़्यादा लेते हैं और सबसे लंबा लगभग 230 सेकंड का होता है। क्लाइंट टाइमआउट 300 सेकंड या ज़्यादा रखें; जवाब न आना इसका मतलब नहीं कि कुछ बना नहीं, और टाइमआउट के तुरंत बाद दोबारा कोशिश न करें (इससे ऑर्डर दोहरा होता है और दोबारा शुल्क लगता है)। अगर कनेक्शन टूट गया हो, तो बाद में
GET /api/music/songsसे जाँचें। नए API का अवलोकन में "प्रतीक्षा समय और टाइमआउट सेटिंग" देखें।
अनुरोध पैरामीटर
Headers
| पैरामीटर | प्रकार | ज़रूरी | नोट |
|---|---|---|---|
| Authorization | string | हाँ | Bearer YOUR_API_KEY |
| Content-Type | string | हाँ | application/json |
बॉडी पैरामीटर
| पैरामीटर | प्रकार | ज़रूरी | डिफ़ॉल्ट | नोट |
|---|---|---|---|---|
| model | string | नहीं | suno-v6 | ग्राहक के लिए मॉडल नाम: suno-v6, suno-v6-wild या suno-v6-mini |
| description | string | हाँ | - | जो आवाज़ चाहिए उसका वर्णन करें; छोटे अंग्रेज़ी वाक्यांश सबसे भरोसेमंद रहते हैं, जैसे cinematic whoosh transition, bright impact |
| title | string | नहीं | - | शीर्षक; न भेजने पर यह विवरण से बनाया जा सकता है |
| type | string | नहीं | one_shot | प्रकार: one_shot (एक बार) या loop (लूप) |
| loop | boolean | नहीं | false | लूप में चलेगा या नहीं; type को loop करने के बराबर |
| bpm | number | नहीं | - | BPM; 0 से बड़ी संख्या होनी चाहिए। ग़लत मान चुपचाप नज़रअंदाज़ होने के बजाय 400 (invalid_sound_bpm) लौटाता है |
| key | string | नहीं | - | की/स्केल, नोट नाम (C-B) + वैकल्पिक #/b + वैकल्पिक Major/Minor के रूप में, जैसे C Major, C#m, Bb; खाली या any का मतलब कोई सीमा नहीं। ग़लत मान 400 (invalid_sound_key) लौटाता है |
अनुरोध उदाहरण
curl -X POST https://www.suno-api.io/api/music/sounds \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"description": "cinematic whoosh transition, bright impact",
"title": "cinematic whoosh",
"type": "one_shot",
"loop": false,
"bpm": 120,
"key": "C"
}'
प्रतिक्रिया
गानों की सरणी लौटाई जाती है; फ़ील्ड नए API का अवलोकन के सामान्य गाना प्रतिक्रिया फ़ील्ड जैसे ही हैं।
API कुंजी प्राप्त करें
रजिस्टर करने के बाद कंसोल में API कुंजी बनाएँ। प्रत्येक जनरेशन का खर्च 0.6 युआन है और 2 ट्रैक मिलते हैं, डाउनलोड असीमित हैं और फ़ोन नंबर की ज़रूरत नहीं है।
API कुंजी लें अवलोकन पर लौटें