स्रोत ऑडियो अपलोड API

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

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

स्रोत ऑडियो अपलोड करना किसी स्थानीय या दूरस्थ ऑडियो फ़ाइल को ऐसे स्रोत क्लिप में बदलता है जिसे आगे की क्षमताएँ इस्तेमाल कर सकती हैं: कवर, बढ़ाना, अनुभाग बदलना, अलग करना और अन्य।

एंडपॉइंट: POST /api/music/upload-source

बिलिंग: निःशुल्क। यह एंडपॉइंट केवल स्रोत ऑडियो अपलोड करता है; यह जनरेशन कार्य शुरू नहीं करता।

सुझाया गया उपयोग: यह «दो-चरणीय कवर» का चरण 1 है। पहले इस एंडपॉइंट से ऑडियो अपलोड करें (निःशुल्क, और विफल होने पर आप कभी भी दोबारा कोशिश कर सकते हैं) और मिला हुआ clip_id सहेजें; अपलोड सफल होने की पुष्टि करने के बाद (status पूर्ण स्थिति में), कवर शुरू करने के लिए स्रोत क्लिप से कवर API कॉल करें — उस चरण का अनुरोध बॉडी केवल कुछ सौ बाइट्स का होता है, इसलिए ऑडियो बड़ा होने के कारण वह ट्रांज़िट में कट नहीं सकता। एक-बार वाले अपलोड करके कवर API की तुलना में यह विभाजन तब ज़्यादा भरोसेमंद है जब ऑडियो बड़ा हो, नेटवर्क अस्थिर हो, या वही सामग्री कई बार दोबारा इस्तेमाल करनी हो (बढ़ाना / बदलना / अलग करना)।

बड़ी फ़ाइल अपलोड के सुझाव

अपलोड पूरा होने के बाद हमेशा पुष्टि करें कि जवाब में status पहले से पूर्ण स्थिति में है और चरण 2 पर जाने से पहले clip_id सहेजें; विफल अपलोड का शुल्क नहीं लगता और कोई जनरेशन कार्य नहीं बनता — बस दोबारा कोशिश करें।

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

Headers

JSON अनुरोधों के लिए:

multipart अनुरोधों में Content-Type हाथ से सेट न करें; क्लाइंट इसे अपने आप बनाता है।

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

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

curl -X POST https://www.suno-api.io/api/music/upload-source \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "file_url": "https://example.com/source.mp3",
    "file_name": "source.mp3",
    "upload_type": "file_upload"
  }'

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

curl -X POST https://www.suno-api.io/api/music/upload-source \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@source.mp3" \
  -F "file_name=source.mp3" \
  -F "upload_type=file_upload" \
  -F "model=suno-v6"

प्रतिक्रिया

{
  "clip_id": "uploaded_clip_id",
  "status": "complete",
  "title": "source.mp3",
  "image_url": "https://...",
  "audio_url": "https://...",
  "display_tags": "pop, vocal",
  "inferred_description": "uploaded source audio",
  "clip_metadata": {}
}