प्रमाणीकरण

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

Suno-API के सभी अनुरोध API कुंजी से प्रमाणित होते हैं। यह पृष्ठ बताता है कि कुंजी कैसे बनाएँ, कैसे भेजें, त्रुटियों का क्या अर्थ है और कुंजी को सुरक्षित कैसे रखें।

API कुंजी क्या है

कुंजी आपके खाते से जुड़ा bearer टोकन है। यह बैलेंस लेकर चलती है, इसलिए जिसके पास कुंजी है वह बैलेंस खर्च कर सकता है। बनाते समय कुंजी केवल एक बार दिखती है: कॉपी करें और सुरक्षित जगह रखें।

कुंजी बनाना

https://www.suno-api.io पर रजिस्टर करें — केवल ईमेल, फ़ोन नंबर नहीं।
कंसोल में टोकन प्रबंधन खोलें।
नई कुंजी बनाएँ और कॉपी करें।

कुंजियाँ sk-… रूप में होती हैं। खोई कुंजी वापस नहीं मिलती: नई बनाएँ और पुरानी हटा दें।

कुंजी का उपयोग

हेडर का प्रारूप

हर अनुरोध में कुंजी Authorization हेडर में भेजें:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

उदाहरण

curl -X POST https://www.suno-api.io/api/music/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"description": "कैफ़े के लिए शांत पियानो रचना"}'

प्रमाणीकरण त्रुटियाँ

401 Unauthorized

हेडर मौजूद नहीं, गलत है, या कुंजी नहीं है।

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

जाँचें कि हेडर ठीक Bearer <कुंजी> है (यानी Bearer के बाद एक स्पेस) और कुंजी के अंत में कोई नई पंक्ति का अक्षर नहीं चला आया।

403 Forbidden

कुंजी मौजूद है पर इस अनुरोध की अनुमति नहीं है — ज़्यादातर मामलों में कुंजी निष्क्रिय कर दी गई है या अकाउंट निलंबित है। कंसोल में अकाउंट की स्थिति देखें, और कारण साफ़ न हो तो सपोर्ट से संपर्क करें।

सुरक्षा के सर्वोत्तम अभ्यास

कुंजी कभी क्लाइंट कोड में न रखें

कुंजी को वेब पेज, मोबाइल ऐप या डेस्कटॉप प्रोग्राम में न डालें। जो भी ब्राउज़र इंस्पेक्टर खोल सकता है, वह इसे पढ़कर आपका बैलेंस खर्च कर सकता है। API को अपने सर्वर से कॉल करें और उपयोगकर्ताओं को अपना एंडपॉइंट दें।

पर्यावरण चर इस्तेमाल करें

Linux / macOS

# ~/.bashrc या ~/.zshrc
export SUNO_API_KEY="sk-your-key-here"

# Python
import os
api_key = os.environ["SUNO_API_KEY"]

.env

# .env फ़ाइल — इसे .gitignore में डालें
SUNO_API_KEY=sk-your-key-here

Windows

setx SUNO_API_KEY "sk-your-key-here"

Node.js

require('dotenv').config();
const apiKey = process.env.SUNO_API_KEY;

ज़रूरत पड़ने पर कुंजी बदलें

कुंजियाँ हर 3-6 महीने में बदलें, और लीक का शक हो तो तुरंत बदलें। जो कुंजियाँ अब इस्तेमाल नहीं होतीं उन्हें हटा दें: बेकार कुंजी सिर्फ़ बेकार जोखिम है।

अनुरोध की सीमा

अनुरोध हर कुंजी पर सीमित हैं:

सीमा	मान	नोट
प्रति सेकंड अनुरोध	10	प्रति API कुंजी
प्रति मिनट अनुरोध	100	प्रति API कुंजी
एक साथ जनरेशन	5	एक समय में अधिकतम पाँच

429 Too Many Requests

सीमा पार करने पर API 429 लौटाता है और जवाब में retry_after (सेकंड में) हो सकता है। अगली कोशिश से पहले उतना इंतज़ार करें; अनुरोध की रफ़्तार घटाएँ, काम को कतार में डालें, या तंग लूप की जगह बढ़ती देरी (exponential backoff) के साथ दोबारा कोशिश करें।

दोबारा कोशिश की नीति

सिर्फ़ साफ़ विफलता पर दोबारा कोशिश करें। रीड या कनेक्शन टाइमआउट के बाद दोबारा कोशिश न करें: जनरेशन एंडपॉइंट सिंक्रोनस हैं, इसलिए टाइमआउट का मतलब यह भी हो सकता है कि ऑर्डर पहले ही स्वीकार हो चुका है और बन रहा है — दोबारा कोशिश से ऑर्डर दोहरा होगा और दो बार शुल्क लगेगा। क्लाइंट टाइमआउट 300 सेकंड या ज़्यादा रखें, और कनेक्शन टूटने पर दोबारा भेजने से पहले GET /api/music/songs से ऑर्डर की पुष्टि करें। नए API का अवलोकन में "प्रतीक्षा समय और टाइमआउट सेटिंग" देखें।

कसी हुई लूप की जगह एक्सपोनेंशियल बैकऑफ़ से दोबारा भेजें:

import time

delay = 1.0
for attempt in range(5):
    response = call_api()
    if response.status_code != 429:
        break
    time.sleep(delay)
    delay *= 2

अक्सर पूछे जाने वाले प्रश्न

कुंजी का प्रारूप क्या है?

यह sk- से शुरू होती है, फिर अक्षर और अंक आते हैं; कुल लंबाई लगभग 50-60 अक्षर।

क्या API सीधे ब्राउज़र से कॉल कर सकते हैं?

तकनीकी रूप से हाँ, पर प्रोडक्शन में न करें: कुंजी सभी आगंतुकों को दिखेगी। अपने बैकएंड से प्रॉक्सी करें।

पता कैसे चले कि कुंजी अब भी मान्य है?

कोई भी प्रमाणित अनुरोध भेजें। 200 यानी चल रही है; 401 यानी कुंजी अमान्य या हटाई गई है।

कुंजी खो गई, अब क्या?

कुंजियाँ वापस नहीं मिलतीं। कंसोल में नई बनाएँ और पुरानी हटाएँ।

एक खाते में कितनी कुंजियाँ हो सकती हैं?

कोई तय सीमा नहीं है। हर ऐप या एनवायरनमेंट के लिए अलग कुंजी रखें ताकि उन्हें अलग-अलग रद्द कर सकें, और जो इस्तेमाल न हों उन्हें हटा दें।

क्या कुंजियाँ समाप्त होती हैं?

जब तक आप हटाएँ या खाता बंद करें, वे मान्य रहती हैं। समय-समय पर बदलना अच्छा अभ्यास है।

खर्च कैसे देखें?

कंसोल में साइन इन करें: वहाँ हर कुंजी का उपयोग दिखता है — अनुरोधों की संख्या, खर्च और हाल के काम।