מפתחות API ומגדיר MCP
יצירת מפתחות API, קריאה לכל נקודות סיום REST הציבוריות, וקישור לשרת מגדיר MCP הרשמי של Speechdash.
השתמשו ב-תפריטים → API כדי ליצור מפתחות ולקשר עוזרים. המפתח sh_live_… מאשר את ה-API הציבורי REST (/api/api-overview) והשרת MCP הרשמי (/api/mcp-server). הקישורים בתפריטים תפריטים → קישורים הם תכונה שונה: הם מחברים שרתי MCP של גופים שלישיים לדיאלוג בתוך האפליקציה.
יצירת מפתח
- פתחו תפריטים → API.
- לחצו על מפתח חדש, קראו לו (לדוגמה
שרת ייצור), וקופו אותו מיד. רק הסיומת נשמרת; המפתח המלא מוצג פעם אחת בלבד. - שלחו
Authorization: Bearer sh_live_…משרתכם. לא תניחו מפתח בדפדפן, באפליקציה ניידת, או במרפד ציבורי.
ניתן לשמור עד 10 מפתחות פעילים. ביטלו מפתח שנגלה מהדף הזה.
אישרו מפתח עם GET /v1/me (אימייל, תוכנית, ומטבעת). כתובת הבסיס: 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 עם אודיו לסעיף ולסימנים |
GET | /v1/voices | קטלוג קולות |
GET | /v1/voices/{voice_id} | הגדרות קול יחיד (לדוגמה F1) |
השירות לא מתחיל משימות תרגום אודיו או וידאו. משימות מוגמרות מופיעות כמסמכי ספרייה (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 חי).
הזרמת דיבור (POST /v1/audio/stream ו-POST /v1/audio/stream/with-timestamps) לא כוללת כלי MCP. השתמשו ב-REST לדרישות אלה ול-/health.
התקנה: שרת MCP והעוגן של העוזרים.
קרדיטים
סינתזת דיבור (REST ומגדיר MCP) משתמשת ב-0.5 קרדיט לכל 30 שניות של אודיו שנוצר. תרגום משתמש באותו קצב כמו הורדת MP3. יצירת מסמכים והורדת קבצים לא משתמשים בקרדיטים. יצירת מסמכים נחשבת לתקרת המסמכים היומית של תוכניתכם.
ראו מה משתמש בקרדיטים.