मॉडल API पेज
Suno Sounds API इंटीग्रेशन
Rivya Public API v1 के जरिए मॉडल id suno-sounds, समर्थित इनपुट, पैरामीटर, Files API नियम, क्रेडिट और रिस्पॉन्स उदाहरणों के साथ Suno Sounds का उपयोग करें।
API से उपलब्धटेक्स्ट इनपुट तैयारऑडियो
API मॉडल id
suno-sounds
इनपुट
text
Files API
न्यूनतम रिक्वेस्ट के लिए जरूरी नहीं
बेस क्रेडिट
3
क्षमता
ऑडियो
बिलिंग
FIXED
प्रॉम्प्ट सीमा
500 अक्षर
रिक्वेस्ट अनुबंध
मॉडल id को शीर्ष स्तर पर भेजें। मॉडल के लिए खास कंट्रोल params में रखें।
| Key | प्रकार | जरूरी | डिफॉल्ट | विवरण |
|---|---|---|---|---|
| model | string | हां | suno-sounds | suno-sounds API मॉडल id का उपयोग करें। |
| prompt | string | हां | - | इस मॉडल के लिए अधिकतम 500 अक्षर। |
| params | object | नहीं | - | मॉडल के लिए खास पैरामीटर ऑब्जेक्ट। अनुमत keys के लिए नीचे दी गई पंक्तियां देखें। |
| client_request_id | string | नहीं | - | अपने सिस्टम में रिक्वेस्ट ट्रेस करने के लिए वैकल्पिक client-side id। |
मॉडल पैरामीटर
| Key | प्रकार | जरूरी | डिफॉल्ट | सीमा | विकल्प | विवरण |
|---|---|---|---|---|---|---|
| model | select | नहीं | V5 | - | V5, V5_5 | कौन सी Suno generation family इस्तेमाल करनी है, यह चुनता है। Newer versions अक्सर style और detail बेहतर handle करते हैं, लेकिन cost और behavior में अलग हो सकते हैं। |
| soundLoop | select | नहीं | false | - | false, true | Loop playback मोड |
| soundTempo | number | नहीं | - | min 1 / max 300 / step 1 | - | Tempo को beats per minute में set करता है। Higher values आम तौर पर faster feel देती हैं और rhythmic sound design के लिए ज्यादा useful होती हैं। |
| soundKey | select | नहीं | Any | - | Any, Cm, C#m, Dm, D#m, Em, Fm, F#m, Gm, G#m, Am, A#m, Bm, C, C#, D, D#, E, F, F#, G, G#, A, A#, B | Musical key set करता है। इसे सिर्फ तब specify करें जब result को existing harmony या melody से match करना हो; वरना इसे broad छोड़ना आम तौर पर safer है। |
न्यूनतम रिक्वेस्ट
{
"model": "suno-sounds",
"prompt": "A polished audio concept for a short product story",
"params": {
"model": "V5",
"soundLoop": "false",
"soundTempo": 1,
"soundKey": "Any"
}
}रिस्पॉन्स बनाएं
Create एंडपॉइंट सार्वजनिक टास्क id लौटाता है। टास्क सफल या विफल होने तक स्टेटस एंडपॉइंट पोल करें।
{
"id": "task_suno_sounds_example",
"status": "queued",
"model": "suno-sounds",
"reserved_credits": 3,
"final_credits": 0,
"created_at": "2026-05-11T00:00:00.000Z",
"updated_at": "2026-05-11T00:00:00.000Z",
"result": null,
"error": null
}सामान्य त्रुटियां
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Create एंडपॉइंट सार्वजनिक टास्क id लौटाता है। टास्क सफल या विफल होने तक स्टेटस एंडपॉइंट पोल करें।