WAV जनरेशन/प्राप्ति API

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

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

WAV एंडपॉइंट किसी मौजूदा गाने के लिए लॉसलेस WAV ऑडियो पता बनाता या लाता है।

एंडपॉइंट: POST /api/music/wav

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

प्रतीक्षा समय और टाइमआउट (ज़रूरी): यह सिंक्रोनस एंडपॉइंट है — ऑर्डर तभी स्वीकार होता है जब जवाब आ जाता है। मापन के अनुसार ज़्यादातर अनुरोध 1-3 सेकंड में जवाब देते हैं, लगभग 10% 30 सेकंड से ज़्यादा लेते हैं और सबसे लंबा लगभग 230 सेकंड का होता है। क्लाइंट टाइमआउट 300 सेकंड या ज़्यादा रखें; जवाब न आना इसका मतलब नहीं कि कुछ बना नहीं, और टाइमआउट के तुरंत बाद दोबारा कोशिश न करें। अगर कनेक्शन टूट गया हो, तो बाद में GET /api/music/songs से जाँचें। नए API का अवलोकन में "प्रतीक्षा समय और टाइमआउट सेटिंग" देखें।

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

Headers

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

maxAttempts और intervalSeconds दोनों JSON संख्याएँ हैं; intervalSeconds सेकंड में है, मिलीसेकंड में नहीं, और आम तौर पर डिफ़ॉल्ट मान ही काफ़ी हैं। ये केवल यह नियंत्रित करते हैं कि यह एंडपॉइंट अंदर से WAV तैयार होने का कितनी बार और कितने अंतराल पर इंतज़ार करता है; ये जनरेशन कार्य की स्थिति नहीं बदलते।

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

curl -X POST https://www.suno-api.io/api/music/wav \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "audioId": "clip_id",
    "maxAttempts": 24,
    "intervalSeconds": 5
  }'

प्रतिक्रिया

{
  "code": 200,
  "message": "success",
  "data": {
    "audioId": "clip_id",
    "status": "complete",
    "wavUrl": "https://media.code-go.com/assets/example.wav"
  }
}

नोट

WAV का जनरेशन और पता लगाना सर्वर गाने के रिकॉर्ड से अपने आप चुनता है; ग्राहक को कोई खाता जानकारी देने की ज़रूरत नहीं।

सामान्य गाने और अलग किए गए ट्रैक एक ही नियंत्रित मीडिया डिलीवरी मार्ग का उपयोग करते हैं। WAV पहले CN2 द्वारा डाउनलोड करके डिस्क पर लिखा जाता है, और सफल प्रतिक्रिया में data.wavUrl केवल एक नियंत्रित CDN पता लौटाता है — कभी भी Suno या S3 का अस्थायी स्रोत पता नहीं।

अगर ready स्थिति वाली WAV एसेट पहले से मौजूद है तो वही दोबारा इस्तेमाल होती है, Suno से दोबारा अनुरोध नहीं होता और फ़ाइलें दोबारा नहीं हटाई जातीं। जो WAV अभी तैयार नहीं हुआ, वह /api/music/query से Suno/S3 पते के रूप में उजागर नहीं होता; वह इस एंडपॉइंट या एकीकृत डाउनलोड एंडपॉइंट को कॉल करने के बाद ही ज़रूरत पर तैयार किया जाता है।

⚠️ WAV पते की वैधता: 7 दिन — समय रहते सहेजें। लौटाया गया data.wavUrl प्लेटफ़ॉर्म के ऑब्जेक्ट स्टोरेज से मिलता है और डिफ़ॉल्ट रूप से 7 दिन बाद समाप्त हो जाता है (फ़ाइल वापस ले ली जाती है और पुराना पता 404 लौटाता है)। WAV को इस अवधि में अपने स्टोरेज में सहेजें; समाप्त होने के बाद नया वैध पता पाने के लिए इस एंडपॉइंट को दोबारा कॉल करें।

अगर गाने का संसाधन अस्थायी रूप से उपलब्ध न हो, तो एंडपॉइंट 409 लौटाता है। बाद में दोबारा कोशिश करें; सर्वर अस्थिर अस्थायी पते नहीं लौटाता।