API kulcsok és MCP
Létrehoz API kulcsokat, hívd meg minden nyilvános REST végpontot, és kapcsolódj az hivatalos Speechdash MCP szerverhez.
Használj a Beállítások → API menüt API kulcsok létrehozásához és asszisztensek kapcsolódtatásához. Az ugyanaz a sh_live_… kulcs határozza meg a nyilvános REST API-t és az hivatalos MCP szervert. A Beállítások → Kapcsolók alatt található kapcsolók egy másik funkció: ezek kapcsolják a harmadik fél MCP szerveket a belépőbeszélgetéshez.
API kulcs létrehozása
- Nyisd meg a Beállítások → API menüt.
- Kattints Új kulcsra, adj neki nevet (például
Gyártás szerver), és másold azonnal le. Csak a prefix tárolódik; a teljes titkos kulcs csak egyszer látható. - Küldd
Authorization: Bearer sh_live_…a szerveredről. Sohasem helyezd egy böngészőbe, mobil alkalmazásba, vagy nyilvános repoba egy kulcsot.
Tartalmazhatod 10 aktív kulcsot. Revokálhatod egy szivárgó kulcsot ugyanabban a lapban.
Ellenőrizd egy kulcsot GET /v1/me (email, terv, és pénztár) segítségével. Alap URL: https://api.speechdash.com/v1.
REST végpontok
Minden nyilvános HTTP útvonal:
| Metódus | Útvonal | Cél |
|---|---|---|
GET | /health | Szolgáltatási egészség (nincs API kulcs; nincs /v1 alatt) |
GET | /v1/openapi.json | OpenAPI 3.1 szerződés |
GET | /v1/me | Fiók, terv, és pénztár |
GET | /v1/documents | Dokumentumok listázása a könyvtárból, beleértve a befejezett feljegyzéseket |
POST | /v1/documents | Szöveges dokumentum létrehozása (source=api) |
GET | /v1/documents/{document_id} | Dokumentum olvasása és szövege |
PUT | /v1/documents/{document_id} | Cím, szöveg, nyelv, is_archived, vagy visibility frissítése |
DELETE | /v1/documents/{document_id} | Dokumentum törlése |
POST | /v1/documents/{document_id}/translate | Új fordított verzió (azonos hitel, mint MP3 export) |
GET | /v1/documents/{document_id}/export | pdf, docx, txt, csv, srt, vagy vtt letöltése |
POST | /v1/audio/speech | Szintetizálás 5000 karakterig (JSON + hang) |
POST | /v1/audio/stream | WAV stream, 20 000 karakterig |
POST | /v1/audio/stream/with-timestamps | SSE per-szöveg hanggal és jelölőkkel |
GET | /v1/voices | Hangkatalógus |
GET | /v1/voices/{voice_id} | Egy hang beállítása (például F1) |
Az API nem indít hang- vagy videó feljegyzési feladatokat. Befejezett feladatok megjelennek könyvtári dokumentumokként (source=transcription). Interaktív próbálj ki oldalak: Fiók, Dokumentumok, Hang, Hangok.
MCP eszközök
Az hivatalos szerver https://mcp.speechdash.com/mcp egy eszközt kínál könyvtár vagy beszéd akció per. ChatGPT használja a OAuth-ot. Cursor és Claude Desktop használja Streamable HTTP-t a személyes API kulccsal.
| MCP eszköz | 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 |
Erőforrás: speechdash://openapi (élő OpenAPI JSON).
Streaming beszéd (POST /v1/audio/stream és POST /v1/audio/stream/with-timestamps) nincs MCP eszköze. Használd a REST-et ezekhez az útvonalakhoz és a /healthhez.
Beállítás: MCP szerver és az Agensek hubja.
Hitel
A beszédszintetizálás (REST és MCP) 0.5 hitelt fogyaszt elkezdett 30 másodperces generált hang per. A fordítás ugyanazt a ráta használja, mint az MP3 export. Dokumentumok létrehozása és fájl export nem fogyaszt hitelt. Dokumentumok létrehozása számít a napilag dokumentum korlátozásodhoz.
Lásd a Milyen használ hitelt.