واجهة برمجة تطبيقات SpeakNotes، وخادم MCP، ومنصة OAuth

ثلاث طلبات للحصول على ملخصك الأول

ابدأ بمفتاح بيئة الاختبار (Sandbox) لفهم الأشكال، ثم استبدله بمفتاح فعلي عندما تبدو الاستجابات صحيحة.

1. 1

   إنشاء مفتاح

   افتح الإعدادات، ثم مفاتيح API وأنشئ مفتاحاً. اختر بيئة الاختبار لتجربة الأمور، أو اختر المفتاح الفعلي لمعالجة الصوت الحقيقي.

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

2. 2

   استدعاء واجهة برمجة التطبيقات

   أرسل المفتاح كـ bearer token. ستصلك الملخصات، والنصوص المفرغة، ومهام 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"

ما تقدمه لك المنصة

التسعير

يحصل كل حساب على منحة شهرية من الأرصدة التي يتم إعادة تعيينها. تحصل حسابات Pro على منحة أكبر بكثير. بخلاف ذلك، يتم الدفع مسبقاً للأرصدة، لذا لا يمكن لحلقة إعادة محاولة خارجة عن السيطرة أن ترفع الفاتورة.

المراجع

• دليل البدء السريعمن الصفر إلى ملخص يعمل، باستخدام curl.
• المصادقة والصلاحياتمفاتيح API، مفاتيح بيئة الاختبار، الصلاحيات، وحدود الاستخدام.
• OAuth 2.1كود التفويض مع PKCE، التسجيل الديناميكي للعملاء، التحديث، والإلغاء.
• رموز الخطأكل رمز يمكن أن تعيده واجهة برمجة التطبيقات وما يجب فعله تجاه كل منها.
• الأرصدة والتسعيرتكلفة كل عملية، وكيفية شحن الرصيد.
• مواصفات OpenAPI 3.1العقد القابل للقراءة آلياً لكل عملية.
• بيان MCPاسم الخادم، والنقل، وقائمة الأدوات في /.well-known/mcp.json.
• ملف مهارة الوكيلملف SKILL.md جاهز للاستخدام في بيئات تشغيل الوكلاء.

أسئلة يطرحها المطورون

هل استخدام SpeakNotes API مجاني؟

يحصل كل حساب على 60 رصيداً شهرياً مجاناً، ومفاتيح بيئة الاختبار (sandbox) مجانية وغير محدودة للأبد. تحصل حسابات Pro على 2,000 رصيد شهرياً. بعد استهلاك المنحة الشهرية، يمكنك شراء باقات رصيد مدفوعة مسبقاً.

كيف أحصل على مفتاح SpeakNotes API؟

سجل الدخول وافتح الإعدادات، ثم مفاتيح API. يمكنك إنشاء المفتاح بنفسك وسيعمل على الفور. لا توجد عملية تقديم طلبات ولا نموذج اتصال.

هل توفر SpeakNotes بيئة اختبار (sandbox)؟

نعم. أي مفتاح تنشئه بخيار sandbox يبدأ بـ sn_test_. يقوم هذا المفتاح بتجربة كل المسارات وإرجاع مخرجات ثابتة وواقعية دون استدعاء نموذج، أو استهلاك أرصدة، أو الكتابة في ملاحظاتك الحقيقية.

كيف أقوم بتوصيل SpeakNotes بـ Claude أو أي عميل MCP آخر؟

وجه العميل إلى https://api.speaknotes.io/mcp عبر Streamable HTTP. العملاء الذين يدعمون OAuth يقومون بتسجيل أنفسهم ويطلبون منك التفويض؛ أما العملاء الذين لا يدعمونه فيمكنهم إرسال مفتاح SpeakNotes API كرمز حامل (bearer token).

هل يدعم SpeakNotes API بروتوكول OAuth؟

نعم. تشغل SpeakNotes خادم تفويض OAuth 2.1 مع PKCE، وتدوير رموز التحديث، والتسجيل الديناميكي للعملاء، والإبطال. يتم نشر البيانات الوصفية على https://speaknotes.io/.well-known/oauth-authorization-server.

ما هي حدود معدل الاستخدام لـ SpeakNotes API؟

120 طلب قراءة، 30 طلب كتابة، و10 طلبات معالجة في الدقيقة، تُحسب لكل اعتماد. تحمل كل استجابة الميزانية المتبقية في ترويسات حدود المعدل، ويخبرك رمز الخطأ 429 بالضبط بالمدة التي يجب عليك الانتظار فيها.