مفاتيح API ومقاطع MCP
إنشاء مفاتيح API، الاتصال بجميع نقاط النهاية العامة لREST، وربط خادم MCP الرسمي Speechdash.
استخدم الإعدادات → API لإنشاء المفاتيح وربط المساعدين. نفس المفتاح sh_live_… يصرح بالوصول إلى API REST العام وخادم MCP الرسمي . المقصود تحت الإعدادات → المتصلين هو ميزة مختلفة: فهو يربط خوادم MCP الخارجية مع محادثة داخل التطبيق.
إنشاء مفتاح
- افتح الإعدادات → API.
- انقر على مفتاح جديد، اسميه (على سبيل المثال
خادم الإنتاج) وقم بنسخه فورًا. فقط الجزء السابق مخزن؛ يظهر المفتاح الكامل مرة واحدة فقط. - أرسل
Authorization: Bearer sh_live_…من خادمك. لا تضع مفتاحًا في متصفح أو تطبيق هاتف أو مخزن عام.
يمكنك الاحتفاظ بـ 10 مفاتيح نشطة. إلغاء صلاحية مفتاح مفقود من نفس الصفحة.
تحقق من المفتاح باستخدام GET /v1/me (البريد الإلكتروني، الخطة، والمحفظة). عنوان URL الأساسي: https://api.speechdash.com/v1.
نقاط النهاية REST
كل طريق HTTP العام:
| طريقة | المسار | الغرض |
|---|---|---|
GET | /health | صحة الخدمة (لا يتطلب مفتاح API؛ ليس تحت /v1) |
GET | /v1/openapi.json | عقد OpenAPI 3.1 |
GET | /v1/me | الحساب، الخطة، والمحفظة |
GET | /v1/documents | قائمة المستندات في المكتبة، بما في ذلك النسخ النهائية للمقاطع |
POST | /v1/documents | إنشاء مستند نصي (source=api) |
GET | /v1/documents/{document_id} | قراءة المستند ونصه |
PUT | /v1/documents/{document_id} | تحديث العنوان، النص، اللغة، is_archived، أو visibility |
DELETE | /v1/documents/{document_id} | حذف مستند |
POST | /v1/documents/{document_id}/translate | نسخة مترجمة جديدة (نفس الائتمان مثل تصدير MP3) |
GET | /v1/documents/{document_id}/export | تحميل pdf، docx، txt، csv، srt، أو vtt |
POST | /v1/audio/speech | تصنيع حتى 5,000 حرف (JSON + صوت) |
POST | /v1/audio/stream | تدفق WAV، حتى 20,000 حرف |
POST | /v1/audio/stream/with-timestamps | SSE مع صوت لكل جملة ومarkers |
GET | /v1/voices | قتالوج الأصوات |
GET | /v1/voices/{voice_id} | إعداد صوت واحد (على سبيل المثال F1) |
لا يبدأ API العملية لتسجيل الصوت أو الفيديو. تظهر العمليات المكتملة في المكتبة كوثائق (source=transcription). صفحات تجربة مباشرة: الحساب، المستندات، الصوت، الأصوات.
أدوات MCP
يقدم الخادم الرسمي على https://mcp.speechdash.com/mcp أداة واحدة لكل مكتبة أو عمل صوت. يستخدم ChatGPT OAuth. يستخدم Cursor وClaude Desktop Streamable HTTP مع مفتاح API الخاص بك.
| أداة MCP | REST |
|---|---|
speechdash_get_account | GET /v1/me |
speechdash_list_documents | GET /v1/documents |
speechdash_get_document | GET /v1/documents/{document_id} |
speechdash_create_document | POST /v1/documents |
speechdash_update_document | PUT /v1/documents/{document_id} |
speechdash_translate_document | POST /v1/documents/{document_id}/translate |
speechdash_export_document | GET /v1/documents/{document_id}/export |
speechdash_delete_document | DELETE /v1/documents/{document_id} |
speechdash_list_voices | GET /v1/voices |
speechdash_get_voice | GET /v1/voices/{voice_id} |
speechdash_synthesize_speech | POST /v1/audio/speech |
الموارد: speechdash://openapi (JSON OpenAPI مباشر).
لا يوجد أداة MCP لتدفق الصوت (POST /v1/audio/stream و POST /v1/audio/stream/with-timestamps). استخدم REST لهذه المسارات و /health.
إعدادات: خادم MCP و مكتبة الوكالات.
الائتمان
تستهلك تصنيع الصوت (REST ومCP) 0.5 ائتمان لكل 30 ثانية من الصوت المولّد. تستخدم الترجمة نفس المعدل لتصدير MP3. إنشاء المستندات والتصدير لا يستهلك ائتمانًا. إنشاء المستندات يحسب ضمن حد المستندات اليومي لخطةك.
انظر ما يستهلك الائتمان.