API-sleutels en MCP
Maak API-sleutels aan, roep elke openbare REST-endpoint aan, en verbind de officiële Speechdash MCP-server.
Gebruik Instellingen → API om sleutels te maken en assistenten te verbinden. Dezelfde sh_live_…-sleutel autoriseert zowel de openbare REST API als de officiële MCP-server. Connectors onder Instellingen → Connectors zijn een ander feature: ze koppelen derde-onderdeel MCP-servers aan de in-app chat.
Een sleutel maken
- Open Instellingen → API.
- Klik op Nieuwe sleutel, geef deze een naam (bijvoorbeeld
Productieserver), en kopieer deze direct. Alleen het voorvoegsel wordt opgeslagen; het volledige geheim wordt slechts één keer getoond. - Stuur
Authorization: Bearer sh_live_…vanaf je server. Plaats een sleutel nooit in een browser, een mobiele app, of een openbare repository.
Je kunt tot 10 actieve sleutels behouden. Ontzeg een gelekte sleutel op dezelfde pagina.
Verifieer een sleutel met GET /v1/me (e-mail, abonnement, en portemonnee). Basis-URL: https://api.speechdash.com/v1.
REST-endpoints
Elke openbare HTTP-route:
| Methode | Pad | Doel |
|---|---|---|
GET | /health | Dienstgezondheid (geen API-sleutel; niet onder /v1) |
GET | /v1/openapi.json | OpenAPI 3.1 contract |
GET | /v1/me | Account, abonnement, en portemonnee |
GET | /v1/documents | Lijst met bibliotheekdocumenten, inclusief afgeronde transcripties |
POST | /v1/documents | Maak een tekstdocument (source=api) |
GET | /v1/documents/{document_id} | Lees een document en zijn tekst |
PUT | /v1/documents/{document_id} | Bijwerk titel, tekst, taal, is_archived, of visibility |
DELETE | /v1/documents/{document_id} | Verwijder een document |
POST | /v1/documents/{document_id}/translate | Nieuwe vertaalde versie (zelfde punten als MP3-export) |
GET | /v1/documents/{document_id}/export | Download pdf, docx, txt, csv, srt, of vtt |
POST | /v1/audio/speech | Synthese van maximaal 5.000 tekens (JSON + audio) |
POST | /v1/audio/stream | Stream WAV, maximaal 20.000 tekens |
POST | /v1/audio/stream/with-timestamps | SSE met per-zin audio en markeringen |
GET | /v1/voices | Stemmenkatalog |
GET | /v1/voices/{voice_id} | Een stemvoorkeur (bijvoorbeeld F1) |
De API start geen audio- of videotranscriptieopdrachten. Afgeronde opdrachten verschijnen als bibliotheekdocumenten (source=transcriptie). Interactieve proefpagina's: Account, Documenten, Audio, Stemmen.
MCP-tools
De officiële server op https://mcp.speechdash.com/mcp biedt één tool per bibliotheek of spraakactie. ChatGPT gebruikt OAuth. Cursor en Claude Desktop gebruiken Streamable HTTP met je persoonlijke API-sleutel.
| MCP-tool | 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 |
Bron: speechdash://openapi (live OpenAPI JSON).
Streaming-spraak (POST /v1/audio/stream en POST /v1/audio/stream/with-timestamps) heeft geen MCP-tool. Gebruik REST voor deze routes en voor /health.
Opstelling: MCP-server en de Agents hub.
Punten
Spraaksynthese (REST en MCP) verbruikt 0,5 punten per gestarte 30 seconden van gegenereerde audio. Vertalen gebruikt dezelfde tarieven als MP3-export. Documenten maken en bestandsexport verbruiken geen punten. Documenten maken telt mee voor de dagelijkse documentenlimiet van je abonnement.
Zie Wat verbruikt punten.