API-nøgler og MCP
Opret API-nøgler, kald alle offentlige REST-endpoints, og forbind til den officielle Speechdash MCP-server.
Brug Indstillinger → API til at oprette nøgler og forbinde assistenter. Den samme sh_live_…-nøgle autoriserer den offentlige REST-API og den officielle MCP-server. Forbindelser under Indstillinger → Forbindelser er en anden funktion: de knytter tredjeparts-MCP-servere til chatten i appen.
Opret en nøgle
- Åbn Indstillinger → API.
- Klik på Ny nøgle, navngiv den (for eksempel
Produktionsserver) og kopier den straks. Kun præfikset gemmes; det fulde hemmelige nøgleværdi vises kun én gang. - Send
Authorization: Bearer sh_live_…fra din server. Placer aldrig en nøgle i en browser, en mobilapp eller et offentligt repository.
Du kan holde op til 10 aktive nøgler. Ophæv en kompromitteret nøgle på samme side.
Verificer en nøgle med GET /v1/me (e-mail, plan og wallet). Base URL: https://api.speechdash.com/v1.
REST-endpoints
Alle offentlige HTTP-ruter:
| Metode | Sti | Formål |
|---|---|---|
GET | /health | Tjenestens sundhed (ingen API-nøgle; ikke under /v1) |
GET | /v1/openapi.json | OpenAPI 3.1-kontrakt |
GET | /v1/me | Konto, plan og wallet |
GET | /v1/documents | Liste over biblioteksdokumenter, inklusive færdige transskriptioner |
POST | /v1/documents | Opret et tekstdokument (source=api) |
GET | /v1/documents/{document_id} | Læs et dokument og dets tekst |
PUT | /v1/documents/{document_id} | Opdater titel, tekst, sprog, is_archived, eller visibility |
DELETE | /v1/documents/{document_id} | Slet et dokument |
POST | /v1/documents/{document_id}/translate | Ny oversat version (bruger samme kreditter som MP3-eksport) |
GET | /v1/documents/{document_id}/export | Download pdf, docx, txt, csv, srt, eller vtt |
POST | /v1/audio/speech | Syntetiser op til 5.000 tegn (JSON + audio) |
POST | /v1/audio/stream | Stream WAV, op til 20.000 tegn |
POST | /v1/audio/stream/with-timestamps | SSE med per-sætning audio og mærker |
GET | /v1/voices | Stemmekatalog |
GET | /v1/voices/{voice_id} | En stemmeindstilling (for eksempel F1) |
API'en starter ikke audio- eller videotransskriptionsopgaver. Færdige opgaver vises som biblioteksdokumenter (source=transcription). Interaktive prøv-ud-og-se sider: Konto, Dokumenter, Audio, Stemmer.
MCP-værktøjer
Den officielle server på https://mcp.speechdash.com/mcp udsætter et værktøj pr. bibliotek eller talehandling. ChatGPT bruger OAuth. Cursor og Claude Desktop bruger Streamable HTTP med din personlige API-nøgle.
| MCP-værktøj | 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 |
Ressource: speechdash://openapi (levende OpenAPI JSON).
Streaming af tale (POST /v1/audio/stream og POST /v1/audio/stream/with-timestamps) har ingen MCP-værktøj. Brug REST for disse ruter og for /health.
Indstillinger: MCP-server og Agents-hubben.
Kreditter
Tale-syntese (REST og MCP) bruger 0.5 kreditter pr. startede 30 sekunder af genereret audio. Oversættelse bruger samme rate som MP3-eksport. Oprettelse af dokumenter og fil-eksport bruger ikke kreditter. Oprettelse af dokumenter tæller med i din plans daglige dokumentgrænse.