Speed API (गति बदलें)
एंडपॉइंट विवरण
Speed किसी मौजूदा गाने की प्लेबैक गति बदलता है और वैकल्पिक रूप से पिच बनाए रखता है।
एंडपॉइंट: POST /api/music/speed
बिलिंग: सशुल्क, अनुरोध किए गए मॉडल के अनुसार; असल में कटने वाली रकम बैक-ऑफ़िस मूल्य कॉन्फ़िगरेशन के अनुसार होती है।
सुझाया गया मॉडल: suno-v6। suno-v6, suno-v6-wild और suno-v6-mini उपलब्ध हैं।
प्रतीक्षा समय और टाइमआउट (ज़रूरी): यह सिंक्रोनस एंडपॉइंट है — ऑर्डर तभी स्वीकार होता है और जनरेशन को सौंपा जाता है जब जवाब आ जाता है। मापन के अनुसार ज़्यादातर अनुरोध 1-3 सेकंड में जवाब देते हैं, लगभग 10% 30 सेकंड से ज़्यादा लेते हैं और सबसे लंबा लगभग 230 सेकंड का होता है। क्लाइंट टाइमआउट 300 सेकंड या ज़्यादा रखें; जवाब न आना इसका मतलब नहीं कि कुछ बना नहीं, और टाइमआउट के तुरंत बाद दोबारा कोशिश न करें (इससे ऑर्डर दोहरा होता है और दोबारा शुल्क लगता है)। अगर कनेक्शन टूट गया हो, तो बाद में
GET /api/music/songsसे जाँचें। नए API का अवलोकन में "प्रतीक्षा समय और टाइमआउट सेटिंग" देखें।
प्रमाणीकरण
| पैरामीटर | प्रकार | ज़रूरी | नोट |
|---|---|---|---|
| Authorization | string | हाँ | Bearer YOUR_API_KEY |
| Content-Type | string | हाँ | application/json |
अनुरोध पैरामीटर
| पैरामीटर | प्रकार | ज़रूरी | डिफ़ॉल्ट | नोट |
|---|---|---|---|---|
| model | string | हाँ | - | ग्राहक के लिए मॉडल नाम: suno-v6, suno-v6-wild या suno-v6-mini |
| source_clip_id | string | हाँ | - | स्रोत गाने का असली song_id; वह पूरा हो चुका होना चाहिए और मौजूदा API कुंजी से सुलभ होना चाहिए |
| speed_multiplier | number | हाँ | - | गति गुणक; धनात्मक होना चाहिए, अधिकतम चार दशमलव स्थान |
| keep_pitch | boolean | नहीं | false | क्या पिच बनाए रखनी है; true पर वोकल की पिच गति के साथ नहीं बदलती |
| song_title | string | नहीं | - | नतीजे का शीर्षक |
अनुरोध उदाहरण
curl -X POST https://www.suno-api.io/api/music/speed \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"source_clip_id": "source_song_id",
"speed_multiplier": 1.2,
"keep_pitch": true,
"song_title": "गति बदला संस्करण"
}'
प्रतिक्रिया
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "result_song_id",
"song_title": "गति बदला संस्करण",
"status": "processing"
}
]
}
}
एक कॉल 1 नतीजा लौटाती है (संपादन क्रियाएँ 2 गाने नहीं बनातीं)। clips[].song_id सहेजें और completed तक पहुँचने के लिए गाना क्वेरी API से पोल करें।
नोट
speed_multiplierधनात्मक होना चाहिए और अधिकतम चार दशमलव स्थान रखने चाहिए; इससे ज़्यादा पर किसी भी शुल्क से पहले HTTP 400 मिलता है।- नतीजे की अवधि लगभग मूल अवधि को गुणक से भाग देने के बराबर होती है।
API कुंजी प्राप्त करें
रजिस्टर करने के बाद कंसोल में API कुंजी बनाएँ। प्रत्येक जनरेशन का खर्च 0.6 युआन है और 2 ट्रैक मिलते हैं, डाउनलोड असीमित हैं और फ़ोन नंबर की ज़रूरत नहीं है।
API कुंजी लें अवलोकन पर लौटें