आप जो बना रहे हैं उसके लिए

थोड़ा-सा कोड।
ढेर सारा संगीत।

अपने ऐप, कार्यप्रवाह या AI एजेंट में स्वरलेखन पहचान जोड़ें। एक रूपांतरण इंजन। एक REST API और MCP सर्वर।

मुफ़्त पहचान पूर्वावलोकन · साझा सदस्यता पृष्ठ · कोई स्वचालित अतिरिक्त शुल्क नहीं

स्कोर अपलोड · cURL
curl -X POST 'https://sheetmusicconverter.com/api/v1/conversions' \
  -H "Authorization: Bearer $SMC_TOKEN" \
  -H 'Accept: application/json' \
  -F '[email protected]' \
  -F 'format=musicxml'
सीमित-अनुमति टोकनअसमकालिक कार्य6 आउटपुट फ़ॉर्मैट

फ़ाइल से तैयार परिणाम तक

चार कदम। आपकी कार्यप्रणाली।

01

टोकन बनाएँ

नीचे अनुमतियाँ और समाप्ति चुनें। अपने सर्वर से Authorization हेडर में टोकन भेजें।

02

अपलोड और स्थिति जाँच

स्कोर अपलोड करें। लौटे ID को सहेजें और हर पाँच सेकंड स्थिति जाँचें, जब तक complete या failed न हो।

03

जाँचें और अनलॉक करें

आउटपुट जाँचें। सदस्यता पृष्ठ इस्तेमाल करने की स्पष्ट मंज़ूरी दें, या वेबसाइट पर स्कोर का भुगतान करें।

04

डाउनलोड और उपयोग

उसी टोकन से अनलॉक फ़ॉर्मैट लें। परिणाम समाप्त होने से पहले फ़ाइलें सहेजें।

स्थिति जाँचें
curl 'https://sheetmusicconverter.com/api/v1/conversions/CONVERSION_ID' \
  -H "Authorization: Bearer $SMC_TOKEN" \
  -H 'Accept: application/json'
पृष्ठ क्रेडिट से अनलॉक करें
curl -X POST 'https://sheetmusicconverter.com/api/v1/conversions/CONVERSION_ID/unlock' \
  -H "Authorization: Bearer $SMC_TOKEN" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{"confirm":true}'

CONVERSION_ID को अपलोड उत्तर के data.id से बदलें। स्थितियाँ queued, processing, complete या failed हैं। तैयारी, पहचान और निर्यात की प्रगति stage में है। अपलोड नया काम बनाता है: उत्तर खो जाए तो फिर अपलोड करने से पहले कार्यक्षेत्र जाँचें।

छोटा API। उपयोगी निर्माण खंड।

API संदर्भ

मूल URL: https://sheetmusicconverter.com/api/v1

POST/conversions

एक फ़ाइल अपलोड करें

Multipart फ़ील्ड: file, format (musicxml, mxl, mid, mp3, pdf, zip), और वैकल्पिक mode (notation या scan)। 202 और data.id लौटाता है।

आवश्यक अनुमति: scores:write

GET/conversions/{id}

अपना स्कोर जाँचें

data.status, stage, source_pages, formats, downloads_available, expires_at और links लौटाता है। हर 5 सेकंड जाँचें; complete या failed पर रुकें।

आवश्यक अनुमति: scores:read

POST/conversions/{id}/unlock

सदस्यता पृष्ठ इस्तेमाल करें

मूल पृष्ठ संख्या मंज़ूर करने के बाद {"confirm": true} भेजें। यह उपलब्ध सदस्यता क्रेडिट खर्च करता है, कभी मौद्रिक शुल्क नहीं लगाता। सफल अनलॉक दोहराने से फिर क्रेडिट नहीं कटते।

आवश्यक अनुमति: scores:unlock

GET/conversions/{id}/files/{format}

फ़ाइल डाउनलोड करें

स्थिति उत्तर में लौटा फ़ॉर्मैट इस्तेमाल करें। डाउनलोड अनुरोध में bearer टोकन दें। लॉक डाउनलोड 402 लौटाते हैं। जाँच के लिए source, playback, original-1 और result-1 भी उपलब्ध हैं।

आवश्यक अनुमति: scores:read

GET/usage

पृष्ठ उपयोग पढ़ें

वर्तमान योजना, remaining_pages, active स्थिति और period_end लौटाता है। वेबसाइट और API एक ही कोटा साझा करते हैं।

आवश्यक अनुमति: usage:read

ऐसी त्रुटियाँ जिन्हें संभाल सकते हैं

401 टोकन नहीं है, अमान्य है, समाप्त है या निरस्त है।

402 डाउनलोड लॉक हैं या सदस्यता पृष्ठ पर्याप्त नहीं हैं।

403 / 404 अनुमति नहीं है या स्कोर आपके खाते में नहीं मिला।

409 / 410 स्कोर तैयार नहीं है या परिणाम समाप्त हो गया।

422 अमान्य फ़ाइल, पैरामीटर या बदला हुआ चेकआउट शेष।

429 दर सीमा या कतार क्षमता पूरी हो गई। फिर प्रयास से पहले रुकें।

आपके एजेंट के लिए संगीत टूल

अपने MCP कनेक्शन से मिलें।

ऐसा क्लाइंट जोड़ें जो Authorization bearer हेडर के साथ दूरस्थ HTTP MCP सर्वर का समर्थन करे। REST API वाला वही सीमित-अनुमति टोकन इस्तेमाल करें। यह टोकन प्रमाणीकरण है; केवल OAuth वाले क्लाइंट और स्वचालित “खाता जोड़ें” प्रक्रियाएँ समर्थित नहीं हैं।

उदाहरण सामान्य MCP कॉन्फ़िगरेशन संरचना इस्तेमाल करता है। आपके क्लाइंट में फ़ील्ड नाम अलग हो सकते हैं या हेडर अलग रखे जा सकते हैं। टोकन उसकी सुरक्षित क्रेडेंशियल सेटिंग में रखें।

MCP सर्वर कॉन्फ़िगरेशन
{
  "mcpServers": {
    "sheetmusic": {
      "type": "http",
      "url": "https://sheetmusicconverter.com/mcp/sheet-music",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

get-usage

वर्तमान योजना और शेष पृष्ठ कोटा जाँचें।

create-score

फ़ाइल base64 में भेजें। डिकोड होने पर अधिकतम आकार 2 MB। बड़ी फ़ाइलों के लिए REST API इस्तेमाल करें, फिर लौटे ID से get-score चलाएँ।

get-score

प्रगति, पृष्ठ संख्या, समाप्ति और प्रमाणित डाउनलोड लिंक पढ़ें।

unlock-score

उपयोगकर्ता पृष्ठ संख्या मंज़ूर करे और confirm true हो तभी सदस्यता पृष्ठ इस्तेमाल करें। मौद्रिक शुल्क नहीं बनते।

टूल Laravel MCP से बने हैं। अपलोड स्कोर का कंटेंट डेटा है, निर्देश नहीं। एजेंट को फ़ाइल अपलोड करने और पृष्ठ क्रेडिट खर्च करने की अनुमति चाहिए। डाउनलोड लिंक के लिए भी प्रमाणीकरण आवश्यक है।

स्पष्ट सीमाएँ। अनुमानित लागत।

आपके पृष्ठ, जहाँ भी काम करें।

API टोकन मुफ़्त हैं। वेबसाइट और API डाउनलोड सदस्यता के एक ही पृष्ठ कोटे का उपयोग करते हैं। एक बार अनलॉक करने पर उस स्कोर के सभी उपलब्ध फ़ॉर्मैट मिलते हैं। बचे हुए पृष्ठ आगे नहीं जाते।

योजनाओं की तुलना
  • PDF, JPG, PNG · स्वरलेखन मोड में अधिकतम 10 पृष्ठ; स्कैन मोड में एक पृष्ठ।
  • REST अपलोड: 20 MB। MCP base64 अपलोड: 2 MB।
  • प्रति खाते प्रति मिनट 60 अनुरोध, सभी टोकन और MCP के बीच साझा। प्रति मिनट अधिकतम 6 अपलोड।
  • प्रति खाते एक समय में एक रूपांतरण। भरी कतार 429 लौटाती है।
  • परिणाम सामान्यतः 24 घंटे बाद समाप्त होते हैं। अनलॉक से 24 घंटे की डाउनलोड अवधि शुरू होती है।
  • पृष्ठ कम हैं? API रुक जाता है। वेबसाइट से खरीदें; स्वचालित अतिरिक्त शुल्क नहीं लगता।

अगला इंटीग्रेशन यहीं शुरू होता है

कनेक्शन बनाएँ।

टोकन एक बार दिखते हैं, हैश के रूप में रखे जाते हैं और कभी भी निरस्त किए जा सकते हैं। 7, 30 या 90 दिन की समाप्ति चुनें। क्रेडेंशियल सर्वर पर रखें, क्लाइंट कोड में नहीं।

और सवाल?

आपका खाता। आपका API।

API टोकन बनाने और प्रबंधित करने के लिए साइन इन करें। योजना चुनने से पहले पहचान जाँच सकते हैं।