Klíče API a MCP
Vytvořte klíče API, volajte každý veřejný REST endpoint a připojte oficiální MCP server Speechdash.
Použijte Nastavení → API, abyste vytvořili klíče a připojili asistenty. Stejný klíč sh_live_… autorizuje veřejnou REST API a oficiální MCP server. Připojení pod Nastavení → Připojení jsou jiná funkce: připojují externí MCP servery k chatu v aplikaci.
Vytvoření klíče
- Otevřete Nastavení → API.
- Klikněte na Nový klíč, pojmenujte jej (například
Produkční server) a ihned jej zkopírujte. Uloženo je pouze předpona; celý tajný klíč se zobrazí jednou. - Odešlete
Authorization: Bearer sh_live_…ze svého serveru. Nikdy neumisťujte klíč do prohlížeče, mobilní aplikace nebo veřejného repozitáře.
Můžete mít až 10 aktivních klíčů. Revokujte zneužitý klíč ze stejné stránky.
Ověřte klíč pomocí GET /v1/me (e-mail, plán a peněženka). Základní URL: https://api.speechdash.com/v1.
REST koncové body
Každý veřejný HTTP cesta:
| Metoda | Cesta | Účel |
|---|---|---|
GET | /health | Zdraví služby (žádný klíč API; není pod /v1) |
GET | /v1/openapi.json | Smlouva OpenAPI 3.1 |
GET | /v1/me | Účet, plán a peněženka |
GET | /v1/documents | Seznam dokumentů z knihovny, včetně dokončených přepisů |
POST | /v1/documents | Vytvoření textového dokumentu (source=api) |
GET | /v1/documents/{document_id} | Čtení dokumentu a jeho textu |
PUT | /v1/documents/{document_id} | Aktualizace názvu, textu, jazyka, is_archived, nebo visibility |
DELETE | /v1/documents/{document_id} | Smazání dokumentu |
POST | /v1/documents/{document_id}/translate | Nová přeložená verze (stejný počet bodů jako export MP3) |
GET | /v1/documents/{document_id}/export | Stáhněte pdf, docx, txt, csv, srt, nebo vtt |
POST | /v1/audio/speech | Syntéza až 5 000 znaků (JSON + audio) |
POST | /v1/audio/stream | Stream WAV, až 20 000 znaků |
POST | /v1/audio/stream/with-timestamps | SSE s audio za větu a značkami |
GET | /v1/voices | Katalog hlasů |
GET | /v1/voices/{voice_id} | Jedno nastavení hlasu (například F1) |
API nezačíná úkoly přepisování audio nebo video. Dokončené úkoly se zobrazí jako dokumenty v knihovně (source=transcription). Interaktivní stránky pro vyzkoušení: Účet, Dokumenty, Audio, Hlasy.
MCP nástroje
Oficiální server na https://mcp.speechdash.com/mcp nabízí jeden nástroj na knihovnu nebo akci řeči. ChatGPT používá OAuth. Cursor a Claude Desktop používají Streamable HTTP s vaším osobním klíčem API.
| MCP nástroj | 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 |
Zdroj: speechdash://openapi (živý OpenAPI JSON).
Streamování řeči (POST /v1/audio/stream a POST /v1/audio/stream/with-timestamps) nemá MCP nástroj. Pro tyto cesty a /health používejte REST.
Nastavení: MCP server a Agents hub.
Body
Syntéza řeči (REST a MCP) spotřebovává 0,5 body za každých 30 sekund generovaného audio. Překlad používá stejnou sazbu jako export MP3. Vytváření dokumentů a export souborů nevyžaduje body. Vytváření dokumentů se počítá do denního limitu dokumentů vašeho plánu.
Podívejte se na Co spotřebovává body.