SpeakNotes API, MCP सर्वर और OAuth प्लेटफ़ॉर्म

आपके पहले सारांश के लिए तीन अनुरोध

आकृतियों को सीखने के लिए सैंडबॉक्स कुंजी से शुरुआत करें, फिर जब प्रतिक्रियाएँ सही दिखें तो लाइव कुंजी का उपयोग करें।

1. 1

   एक कुंजी बनाएँ

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

   # Any signed-in account can create one. Sandbox keys start sn_test_.
   open https://speaknotes.io/settings/api-keys

2. 2

   API को कॉल करें

   कुंजी को बेयरर टोकन के रूप में भेजें। सारांश, ट्रांसक्रिप्शन और YouTube जॉब्स इनलाइन उत्तर देते हैं।

   curl -X POST https://api.speaknotes.io/v1/summaries \
     -H "Authorization: Bearer $SPEAKNOTES_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"text": "...your transcript...", "styleId": "meeting-notes"}'

3. 3

   लंबी मीडिया अपलोड करें

   अपलोड बैकग्राउंड में चलते हैं: अपलोड बनाएँ, फ़ाइल को PUT करें, इसे पूरा करें, फिर नोट के पूरा होने तक पोल करें।

   # 1. create the upload
   curl -X POST https://api.speaknotes.io/v1/uploads \
     -H "Authorization: Bearer $SPEAKNOTES_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"fileName": "standup.m4a", "contentType": "audio/mp4"}'
   
   # 2. PUT the file to uploadUrl, then complete it
   curl -X POST https://api.speaknotes.io/v1/uploads/NOTE_ID/complete \
     -H "Authorization: Bearer $SPEAKNOTES_API_KEY"
   
   # 3. poll until status is Done
   curl https://api.speaknotes.io/v1/notes/NOTE_ID/status \
     -H "Authorization: Bearer $SPEAKNOTES_API_KEY"

प्लेटफ़ॉर्म आपको क्या देता है

मूल्य निर्धारण

प्रत्येक खाते को मासिक क्रेडिट मिलते हैं जो रीसेट हो जाते हैं। प्रो खातों को बहुत अधिक क्रेडिट मिलते हैं। इसके अलावा, क्रेडिट प्रीपेड होते हैं, इसलिए अनियंत्रित रिट्राई लूप कभी भी बिल नहीं बढ़ा सकते।

संदर्भ

• क्विकस्टार्टशून्य से एक कार्यशील सारांश तक, curl में।
• प्रमाणीकरण और स्कोपAPI कुंजियाँ, सैंडबॉक्स कुंजियाँ, स्कोप और रेट लिमिट्स।
• OAuth 2.1PKCE के साथ ऑथोराइजेशन कोड, डायनामिक क्लाइंट रजिस्ट्रेशन, रिफ्रेश और रिवोकेशन।
• त्रुटि कोडAPI द्वारा लौटाया जा सकने वाला प्रत्येक कोड और प्रत्येक के लिए क्या करना है।
• क्रेडिट और मूल्य निर्धारणप्रत्येक ऑपरेशन की लागत क्या है, और टॉप-अप कैसे करें।
• OpenAPI 3.1 विनिर्देशप्रत्येक ऑपरेशन के लिए मशीन-पठनीय अनुबंध।
• MCP मैनिफेस्ट/.well-known/mcp.json पर सर्वर का नाम, ट्रांसपोर्ट और टूल सूची।
• एजेंट स्किल फ़ाइलएजेंट रनटाइम्स के लिए एक ड्रॉप-इन SKILL.md।

डेवलपर्स द्वारा पूछे जाने वाले प्रश्न

क्या SpeakNotes API उपयोग करने के लिए निःशुल्क है?

प्रत्येक खाते को हर महीने 60 क्रेडिट निःशुल्क मिलते हैं, और सैंडबॉक्स कुंजियाँ हमेशा के लिए असीमित और निःशुल्क हैं। प्रो खातों को प्रति माह 2,000 क्रेडिट मिलते हैं। मासिक अनुदान से अधिक के लिए आप प्रीपेड क्रेडिट पैक खरीदते हैं।

मुझे SpeakNotes API कुंजी कैसे मिलेगी?

साइन इन करें और सेटिंग्स, API कुंजियाँ खोलें। आप स्वयं कुंजी बनाते हैं और यह तुरंत काम करती है। कोई आवेदन प्रक्रिया या संपर्क फ़ॉर्म नहीं है।

क्या SpeakNotes में सैंडबॉक्स वातावरण है?

हाँ। सैंडबॉक्स विकल्प के साथ आपके द्वारा बनाई गई कोई भी कुंजी sn_test_ से शुरू होती है। यह हर रूट का अभ्यास करती है और किसी मॉडल को कॉल किए बिना, क्रेडिट खर्च किए बिना, या आपके वास्तविक नोट्स में लिखे बिना निश्चित, यथार्थवादी आउटपुट लौटाती है।

मैं SpeakNotes को Claude या किसी अन्य MCP क्लाइंट से कैसे कनेक्ट करूँ?

क्लाइंट को Streamable HTTP पर https://api.speaknotes.io/mcp की ओर निर्देशित करें। जो क्लाइंट OAuth का समर्थन करते हैं वे खुद को रजिस्टर करते हैं और आपको अधिकृत करने के लिए प्रेरित करते हैं; जो क्लाइंट ऐसा नहीं करते वे SpeakNotes API कुंजी को बेयरर टोकन के रूप में भेज सकते हैं।

क्या SpeakNotes API OAuth का समर्थन करता है?

हाँ। SpeakNotes PKCE, रिफ्रेश टोकन रोटेशन, डायनामिक क्लाइंट रजिस्ट्रेशन और रिवोकेशन के साथ एक OAuth 2.1 ऑथोराइजेशन सर्वर चलाता है। मेटाडेटा https://speaknotes.io/.well-known/oauth-authorization-server पर प्रकाशित किया गया है।

SpeakNotes API की रेट लिमिट्स क्या हैं?

प्रति मिनट 120 रीड रिक्वेस्ट, 30 राइट रिक्वेस्ट और 10 प्रोसेसिंग रिक्वेस्ट, प्रति क्रेडेंशियल गिनी जाती हैं। प्रत्येक रिस्पॉन्स अपने रेट लिमिट हेडर में शेष बजट ले जाता है, और 429 आपको बताता है कि ठीक कितनी देर प्रतीक्षा करनी है।