संगीत व्यावसायिक लाइसेंस प्रमाणपत्र API

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

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

संगीत व्यावसायिक लाइसेंस प्रमाणपत्र एंडपॉइंट का उपयोग उन गानों को सूचीबद्ध करने, PDF प्रमाणपत्र बनाने, प्रमाणपत्र इतिहास देखने और जारी की गई फ़ाइलें डाउनलोड करने के लिए किया जाता है जिनका लाइसेंस मौजूदा API Key का उपयोगकर्ता दे सकता है।

सभी एंडपॉइंट एक समान रूप से New API Key का उपयोग करते हैं:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

आधार पता:

https://www.suno-api.io

पूर्वापेक्षाएँ

• API Key वैध होना चाहिए और उस उपयोगकर्ता का होना चाहिए जिसे प्रमाणपत्र चाहिए।
• उपयोगकर्ता को पहले लाइसेंस पहचान जोड़नी होगी (नीचे "0. लाइसेंस पात्रता और पहचान" देखें); पुष्टि के बाद पहचान उत्पाद नियमों के अनुसार लॉक हो जाती है।
• उपयोगकर्ता को व्यक्तिगत या कंपनी के लिए संचयी रिचार्ज शर्त पूरी करनी होगी।
• सामान्य एंडपॉइंट केवल मास्क की गई पहचान जानकारी लौटाते हैं; वे पहचान संख्या, फ़ोन नंबर या एकीकृत सामाजिक क्रेडिट कोड को कभी सादे टेक्स्ट में नहीं लौटाते।
• प्रत्येक गाने के लिए केवल एक सफल प्रमाणपत्र जारी हो सकता है; जो प्रमाणपत्र बन नहीं पाता वह गाने की पात्रता नहीं खर्च करता।
• फ़िलहाल पूर्ण हो चुके, ऑडियो वाले और असली Suno Song ID वाले निर्दिष्ट जनरेशन प्रकार समर्थित हैं। गाना चुनने योग्य है या नहीं, यह गाना सूची में authorization.selectable से तय होता है।

0. लाइसेंस पात्रता और पहचान

प्रमाणपत्र जारी करने से पहले पात्रता देखनी और पहचान जोड़नी होती है। दोनों एंडपॉइंट निःशुल्क हैं।

0.1 पात्रता और पहचान जाँचें

एंडपॉइंट: GET /api/music/authorization/context

{
  "code": 200,
  "message": "success",
  "data": {
    "identity": {
      "exists": false
    },
    "eligibility": {
      "current_amount": 216.3,
      "personal_required_amount": 200,
      "company_required_amount": 500,
      "personal_eligible": true,
      "company_eligible": false
    },
    "stats": {
      "authorized_song_count": 0,
      "certificate_count": 0
    }
  }
}

0.2 लाइसेंस पहचान जोड़ें

एंडपॉइंट: POST /api/music/authorization/identity

{
  "identity_type": "personal",
  "legal_name": "राहुल शर्मा",
  "id_number": "110101199001010000",
  "contact_name": "राहुल शर्मा",
  "phone": "13800000000",
  "email": "user@example.com",
  "address": "12 एमजी रोड, बेंगलुरु",
  "confirm_locked": true
}

प्रतिक्रिया मास्क की गई पहचान जानकारी लौटाती है: {"identity": {...}}. सफल जोड़ने के बाद context एंडपॉइंट से पुष्टि करें कि identity.exists अब true है, फिर गाना सूची और जारी करने वाले एंडपॉइंट कॉल करें। पहचान जानकारी बदलनी हो तो ग्राहक सहायता से संपर्क करें।

1. लाइसेंस योग्य गानों की सूची

एंडपॉइंट: GET /api/music/authorization/songs

Query पैरामीटर

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

curl "https://www.suno-api.io/api/music/authorization/songs?p=1&page_size=20&status=selectable" \
  -H "Authorization: Bearer YOUR_API_KEY"

प्रतिक्रिया उदाहरण

{
  "success": true,
  "message": "",
  "data": {
    "page": 1,
    "page_size": 20,
    "total": 1,
    "items": [
      {
        "task_id": 10001,
        "suno_song_id": "suno-song-id-1",
        "title": "नमूना गाना",
        "generation_type": "generate",
        "completed_at": 1784000000,
        "created_at": 1783999000,
        "audio_url": "https://example.com/audio.mp3",
        "model_name": "suno-v6",
        "authorization": {
          "selectable": true
        }
      }
    ]
  }
}

जब authorization.selectable=false हो, प्रतिक्रिया reason_code और reason से कारण बताती है। जिन गानों का प्रमाणपत्र पहले जारी हो चुका है, वे certificate_id और certificate_no भी लौटाते हैं।

2. प्रमाणपत्र बनाएँ

एंडपॉइंट: POST /api/music/authorization/certificates

Body पैरामीटर

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

curl -X POST https://www.suno-api.io/api/music/authorization/certificates \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "song_ids": ["suno-song-id-1", "suno-song-id-2"],
    "confirm_risk_terms": true
  }'

प्रतिक्रिया उदाहरण

{
  "success": true,
  "message": "",
  "data": {
    "certificate": {
      "id": 101,
      "certificate_no": "CERTIFICATE-NO",
      "verification_code": "VERIFY-CODE",
      "status": "issued",
      "song_count": 2,
      "identity_type_snapshot": "personal",
      "licensee_name_masked": "र*",
      "document_no_masked_snapshot": "11**************34",
      "phone_masked_snapshot": "138****0000",
      "pdf_sha256": "PDF_SHA256",
      "issued_at": 1784000100,
      "created_at": 1784000000,
      "updated_at": 1784000100,
      "download_url": "/api/music/authorization/certificates/101/download",
      "songs": []
    }
  }
}

सफल प्रतिक्रिया में status का मान issued होता है। यदि PDF रेंडरिंग विफल हो, तो प्रमाणपत्र failed के रूप में चिह्नित होता है और संबंधित गाने समस्या ठीक होने पर फिर से भेजे जा सकते हैं।

3. प्रमाणपत्र इतिहास देखें

एंडपॉइंट: GET /api/music/authorization/certificates

Query पैरामीटर

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

curl "https://www.suno-api.io/api/music/authorization/certificates?p=1&page_size=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

प्रतिक्रिया संरचना

प्रतिक्रिया का data एक पेजिनेटेड ऑब्जेक्ट है जिसमें page, page_size, total और items होते हैं। items का प्रत्येक आइटम प्रमाणपत्र का सारांश है और उस प्रमाणपत्र के गानों का स्नैपशॉट भी शामिल करता है।

4. प्रमाणपत्र विवरण देखें

एंडपॉइंट: GET /api/music/authorization/certificates/:id

पथ पैरामीटर id प्रमाणपत्र की संख्यात्मक ID है। यह एंडपॉइंट केवल मौजूदा API Key के उपयोगकर्ता के प्रमाणपत्रों तक पहुँच देता है।

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

curl https://www.suno-api.io/api/music/authorization/certificates/101 \
  -H "Authorization: Bearer YOUR_API_KEY"

प्रतिक्रिया संरचना

सफल होने पर data.certificate लौटता है, जिसके फ़ील्ड में प्रमाणपत्र संख्या, स्थिति, मास्क की गई लाइसेंसधारी जानकारी, जारी करने का समय, PDF सत्यापन मान, डाउनलोड पता और लाइसेंस किए गानों का स्नैपशॉट शामिल हैं।

5. प्रमाणपत्र PDF डाउनलोड करें

एंडपॉइंट: GET /api/music/authorization/certificates/:id/download

केवल issued स्थिति वाले प्रमाणपत्र डाउनलोड हो सकते हैं। डाउनलोड अनुरोध के लिए भी वैध API Key चाहिए, और आप केवल अपने प्रमाणपत्र डाउनलोड कर सकते हैं।

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

curl https://www.suno-api.io/api/music/authorization/certificates/101/download \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --output authorization-certificate.pdf

सफल प्रतिक्रिया application/pdf फ़ाइल स्ट्रीम है; फ़ाइल नाम बैकएंड के Content-Disposition के अनुसार होता है।

सामान्य विफलता कारण

नोट

• गाना सूची द्वारा लौटाए suno_song_id का उपयोग करें; pending:* प्लेसहोल्डर ID या टास्क टेबल की ID का उपयोग न करें।
• डाउनलोड पता सार्वजनिक लिंक नहीं है; API Key प्रमाणीकरण हटाएँ नहीं।
• प्रमाणपत्र रिकॉर्ड API Key के संबंधित उपयोगकर्ता के हैं और उपयोगकर्ताओं के बीच देखे या डाउनलोड नहीं किए जा सकते।
• लाइसेंस का दायरा, प्रतिबंध शर्तें और अंतिम PDF सामग्री वास्तव में जारी प्रमाणपत्र के अनुसार होती हैं।