Suno API: एक एंडपॉइंट के माध्यम से प्रॉम्प्ट और स्क्रिप्ट
एक OpenAI-संगत एंडपॉइंट का उपयोग करके अपनी क्रिएटिव पाइपलाइन के लिए बिना सेंसर प्रॉम्प्ट, स्क्रिप्ट और मेटाडेटा जनरेट करें। हमारा टेक्स्ट API बिना कंटेंट फ़िल्टर के आपके मौजूदा SDK वर्कफ़्लो में सीधे इंटीग्रेट होता है।
प्रमाणीकरण और बेस URL
हमारा API मानक OpenAI प्रमाणीकरण का उपयोग करता है। आपको केवल एक API कुंजी की आवश्यकता है, जिसे आप API कुंजी प्राप्त करें पृष्ठ पर उत्पन्न कर सकते हैं। शुरू करने के लिए फ़ोन नंबर या क्रेडिट कार्ड की आवश्यकता नहीं है; हर नए खाते को 7 दिनों के लिए वैध $0.50 का ट्रायल क्रेडिट प्राप्त होता है।
अपने क्लाइंट कॉन्फ़िगरेशन में बेस URL को https://api.sunoapis.com/v1 पर सेट करें। हर अनुरोध में आपको भेजने वाला मॉडल पहचानकर्ता uncensored है। यह एक ओपन-वेट मॉडल है जो हमारे अपने GPU सर्वर पर होस्ट किया गया है, जो प्रमुख प्रदाताओं की अस्वीकार प्रथाओं के बिना कानूनी वयस्क और रचनात्मक उपयोग के लिए ट्यून्ड है।
- बेस URL: https://api.sunoapis.com/v1
- मॉडल ID: uncensored
- Auth Header: Authorization: Bearer YOUR_API_KEY
पहला अनुरोध
मानक चैट कंप्लीशन अनुरोध के साथ तुरंत शुरू करें। एंडपॉइंट आपके सिस्टम प्रॉम्प्ट, उपयोगकर्ता निर्देशों और आपके टेक्स्ट-टू-वीडियो या AI म्यूजिक पाइपलाइन के लिए आवश्यक किसी भी मेटाडेटा वाले JSON पेलोड्स स्वीकार करता है।
यह एक टेक्स्ट-ओनली API है। यह ऑडियो, वीडियो या इमेजेज जनरेट नहीं करता है; यह उन टूल्स को चलाने वाले टेक्स्ट निर्देश जनरेट करता है। अपनी क्रिएटिव संपत्तियों से दृश्य लिखें, बोल लिखें या संरचित डेटा निकालने के लिए इस एंडपॉइंट का उपयोग करें।
curl https://api.sunoapis.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
Python SDK
आधिकारिक OpenAI SDK का उपयोग करके अपने Python एप्लिकेशन में API इंटीग्रेट करें। चूंकि हम OpenAI-संगत हैं, आप अपने मौजूदा कोड को केवल बेस URL और API कुंजी बदलकर पुन: उपयोग कर सकते हैं।
यह दृश्य जनरेशन टूल्स के लिए स्क्रिप्ट जनरेट करने या म्यूजिक APIs के लिए मेटाडेटा लिखने के लिए काम आता है। सुनिश्चित करें कि आपका SDK वर्जन अपडेटेड है ताकि अगले अनुभागों में वर्णित स्ट्रीमिंग और फ़ंक्शन कॉलिंग सुविधाओं का समर्थन किया जा सके।
from openai import OpenAI
client = OpenAI(base_url="https://api.sunoapis.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
Node SDK
JavaScript/TypeScript डेवलपर्स के लिए, @anthropic-ai/sdk या आधिकारिक openai पैकेज मामूली कॉन्फ़िगरेशन समायोजन के साथ काम करता है। अपने क्लाइंट को हमारे बेस URL पर पॉइंट करें और uncensored मॉडल ID का उपयोग करें।
इससे आप अपनी क्रिएटिव ऐप्स के लिए सर्वर-साइड टेक्स्ट जनरेशन बना सकते हैं। आप उपयोगकर्ता इनपुट को प्रीप्रोसेस करने या उन्हें अपने ऑडियो या वीडियो जनरेशन एंडपॉइंट्स को भेजने से पहले जनरेट की गई स्क्रिप्ट को पोस्ट-प्रोसेस करने के लिए इसका उपयोग कर सकते हैं। API आधुनिक वेब फ्रेमवर्क्स के साथ संगत मानक JSON रिस्पॉन्स लौटाता है।
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.sunoapis.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);
स्ट्रीमिंग रिस्पॉन्स
लंबे स्क्रिप्ट या विस्तृत मेटाडेटा के लिए, रियल-टाइम में टोकन प्राप्त करने के लिए Server-Sent Events (SSE) का उपयोग करें। अपने अनुरोध बॉडी में stream: true सेट करें। API एक श्रृंखला में चंक भेजेगा, जिससे आप टेक्स्ट को जनरेट होते हुए प्रदर्शित कर सकें।
यह विशेष रूप से इंटरैक्टिव क्रिएटिव टूल्स के लिए उपयोगी है जहां उपयोगकर्ता देखना चाहते हैं कि प्रॉम्प्ट लिखते समय कैसे विकसित हो रहा है। प्रत्येक चंक में केवल डेल्टा टेक्स्ट होता है, इसलिए आपको पूर्ण रिस्पॉन्स को पुनर्स्थापित करने के लिए टुकड़ों को जोड़ना होगा।
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
सीमाएँ, त्रुटियाँ और कॉन्टेक्स्ट
प्रत्येक खाते के लिए एक API कुंजी तक सीमित है, जिसे किसी भी समय पुनः जनरेट किया जा सकता है (पुरानी कुंजी को रद्द करके)। प्रति कुंजी प्रति मिनट 300 अनुरोध की अनुमति है, अधिकतम अनुरोध बॉडी आकार 8 MB है।
सामान्य त्रुटियों में अमान्य कुंजियों के लिए 401, अपर्याप्त प्रीपेड क्रेडिट होने पर 402, और रेट लिमिट के लिए 429 शामिल हैं। मॉडल इनपुट और आउटपुट दोनों के संयुक्त उपयोग के लिए 100,000-टोकन की कॉन्टेक्स्ट विंडो का समर्थन करता है।
सामग्री नोट: मॉडल विवादास्पद या वयस्क विषयों को अस्वीकार नहीं करता है, लेकिन यह सभी अनुरोधों में किशोरों से संबंधित यौन सामग्री को कठोरता से ब्लॉक करता है।
तकनीकी विवरण
API की सभी असली सीमाएँ और सुविधाएँ एक जगह — क्रेडिट जोड़ने से पहले इन्हें देख लें।
| मद | मान |
|---|---|
| API फ़ॉर्मेट | OpenAI के अनुकूल: कोई भी OpenAI SDK चलेगा — बस base URL और कुंजी बदलें |
| Base URL | https://api.sunoapis.com/v1 |
| मॉडल ID | uncensored |
| एंडपॉइंट | POST /v1/chat/completions · GET /v1/models |
| प्रमाणीकरण | Authorization: Bearer YOUR_KEY |
| कॉन्टेक्स्ट विंडो | 100,000 टोकन (इनपुट + आउटपुट मिलाकर) |
| JSON मोड | response_format: {"type": "json_object"} |
| फ़ंक्शन कॉलिंग | हाँ — tools, tool_choice; जवाब में tool_calls, स्ट्रीमिंग में भी; नतीजे role: tool संदेश से भेजें |
| स्ट्रीमिंग | हाँ — server-sent events; आख़िरी हिस्से में टोकन उपयोग |
| पैरामीटर | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| अधिकतम आउटपुट | 100,000-टोकन विंडो के शेष हिस्से तक; max_tokens वैकल्पिक (अलग सीमा नहीं) |
| रेट लिमिट | प्रति कुंजी प्रति मिनट 300 अनुरोध |
| समानांतर अनुरोध | प्रति कुंजी एक साथ 8 तक |
| अनुरोध का आकार | 8 MB तक |
| रिस्पॉन्स हेडर | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| वैधता | भुगतान किया क्रेडिट कभी समाप्त नहीं होता, कोई सदस्यता नहीं |
| टॉप-अप | USDT (TRC20) या USDC (Base), $10 से $500 तक कोई भी पूरी राशि |
| मुफ़्त ट्रायल क्रेडिट | $0.50, 7 दिन, कार्ड की ज़रूरत नहीं · ट्रायल कुंजी: 2 समानांतर अनुरोध, 60 प्रति मिनट; पहले टॉप-अप के बाद पूरी सीमाएँ (8 और 300) |
| कीमत | प्रति 10 लाख इनपुट टोकन $0.25 · प्रति 10 लाख आउटपुट टोकन $1.00 |
| बोनस | $50 से +5%, $100 से +10% |
| बिलिंग | प्रीपेड क्रेडिट, असली उपयोग के अनुसार; त्रुटियाँ और अस्वीकृतियाँ मुफ़्त |
| सामग्री | वयस्क सामग्री की अनुमति; नाबालिगों से जुड़ी यौन सामग्री अस्वीकार |
| साइन इन | Google या ईमेल और पासवर्ड |
| कुंजियाँ | हर खाते में एक सक्रिय कुंजी; नई कुंजी पुरानी की जगह लेती है |
त्रुटि कोड
त्रुटियाँ JSON में स्थिर type के साथ आती हैं; विफल या अस्वीकृत अनुरोधों का शुल्क नहीं लगता।
| कोड | प्रकार | अर्थ |
|---|---|---|
400 | bad_request | अमान्य JSON, खाली संदेश, गलत पैरामीटर या कॉन्टेक्स्ट विंडो से अधिक |
401 | missing_key · invalid_key · key_revoked | कुंजी नहीं, गलत कुंजी या नई कुंजी से बदली गई |
402 | no_credit | क्रेडिट ख़त्म — टॉप-अप करें, तुरंत चालू |
403 | content_blocked | नाबालिगों से जुड़ी यौन सामग्री — अस्वीकार, कोई शुल्क नहीं |
404 | not_found | अज्ञात एंडपॉइंट |
413 | request_too_large | बॉडी 8 MB से बड़ी |
429 | rate_limited · concurrency | 300/मिनट या 8 समानांतर से अधिक — रुककर फिर कोशिश करें |
503 | upstream_busy | मॉडल व्यस्त — कुछ सेकंड बाद फिर कोशिश करें |
प्रश्न और उत्तर
क्या यह API ऑडियो या वीडियो जनरेट करता है?
नहीं। यह एक टेक्स्ट-ओनली API है। यह प्रॉम्प्ट, स्क्रिप्ट और मेटाडेटा जनरेट करता है जिन्हें आप ऑडियो या वीडियो जनरेशन टूल्स को भेज सकते हैं। यह स्वयं मीडिया फ़ाइलें नहीं बनाता है।
इसकी लागत कितनी है?
आप प्रीपेड क्रेडिट के साथ उपयोग के अनुसार भुगतान करते हैं। कीमत 1 मिलियन इनपुट टोकन के लिए $0.25 और 1 मिलियन आउटपुट टोकन के लिए $1.00 है। कोई मासिक शुल्क या सदस्यता नहीं है, और शेष क्रेडिट कभी समाप्त नहीं होता।
क्या मॉडल GPT-4 या किसी अन्य विक्रेता का मॉडल है?
नहीं। मॉडल ID <code>uncensored</code> है। यह एक ओपन-वेट मॉडल है जिसे हमारे अपने GPU सर्वरों पर प्रशिक्षित और होस्ट किया गया है, जो OpenAI, Anthropic या अन्य विक्रेताओं से स्वतंत्र है।
आपकी कुंजी बस एक फ़ॉर्म दूर है
एक खाता बनाएं, कुंजी कॉपी करें, बेस URL बदलें। सेटअप यही है।