API-nøkler og MCP
Opprett API-nøkler, bruk alle offentlige REST-endepunkter, og kobler til den offisielle Speechdash MCP-serveren.
Bruk Innstillinger → API for å opprette nøkler og koble til assistenter. Den samme sh_live_…-nøkkelen autoriserer den offentlige REST-API og den offisielle MCP-serveren. Tilkoblinger under Innstillinger → Tilkoblinger er en annen funksjon: de kobler til tredjeparts-MCP-serverer til chatten i appen.
Opprett en nøkkel
- Åpne Innstillinger → API.
- Klikk på Ny nøkkel, gi den et navn (for eksempel
Produksjonsserver), og kopier den umiddelbart. Bare forstørrelsen lagres; hele hemmeligheten vises bare en gang. - Send
Authorization: Bearer sh_live_…fra din server. Sett aldri en nøkkel i en nettleser, en mobilapp eller et offentlig repository.
Du kan beholde opp til 10 aktive nøkler. Avbryt en lekket nøkkel fra samme side.
Verifiser en nøkkel med GET /v1/me (epost, plan og lommebok). Base-URL: https://api.speechdash.com/v1.
REST-endepunkter
Alle offentlige HTTP-ruter:
| Metode | Sti | Formål |
|---|---|---|
GET | /health | Tjenestetilstand (ingen API-nøkkel; ikke under /v1) |
GET | /v1/openapi.json | OpenAPI 3.1-kontrakt |
GET | /v1/me | Konto, plan og lommebok |
GET | /v1/documents | Liste over biblioteksdokumenter, inkludert ferdige transkripsjoner |
POST | /v1/documents | Opprett et tekstdokument (source=api) |
GET | /v1/documents/{document_id} | Les et dokument og dets tekst |
PUT | /v1/documents/{document_id} | Oppdater tittel, tekst, språk, is_archived, eller visibility |
DELETE | /v1/documents/{document_id} | Slett et dokument |
POST | /v1/documents/{document_id}/translate | Ny oversatt versjon (bruker samme kreditter som MP3-eksport) |
GET | /v1/documents/{document_id}/export | Last ned pdf, docx, txt, csv, srt, eller vtt |
POST | /v1/audio/speech | Syntetiser opp til 5 000 tegn (JSON + lyd) |
POST | /v1/audio/stream | Strøm WAV, opp til 20 000 tegn |
POST | /v1/audio/stream/with-timestamps | SSE med per-setning lyd og merker |
GET | /v1/voices | Stemmekatalog |
GET | /v1/voices/{voice_id} | En stemmeforhåndsvisning (for eksempel F1) |
APIen starter ikke lyd- eller videotranskripsjonsoppdrag. Ferdige oppdrag vises som biblioteksdokumenter (source=transcription). Interaktive prøv-ut-på-sider: Konto, Dokumenter, Lyd, Stemmer.
MCP-verktøy
Den offisielle serveren på https://mcp.speechdash.com/mcp tilbyr ett verktøy per bibliotek eller talehandling. ChatGPT bruker OAuth. Cursor og Claude Desktop bruker Streamable HTTP med din personlige API-nøkkel.
| MCP-verktøy | 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 |
Ressurs: speechdash://openapi (levende OpenAPI JSON).
Strømmet tale (POST /v1/audio/stream og POST /v1/audio/stream/with-timestamps) har ingen MCP-verktøy. Bruk REST for disse ruter og for /health.
Oppsett: MCP-server og Agents-hubben.
Kreditter
Tale-syntese (REST og MCP) bruker 0.5 kreditter per startet 30 sekunder med generert lyd. Oversettelse bruker samme rate som MP3-eksport. Opprettelse av dokumenter og fil-eksport bruker ikke kreditter. Opprettelse av dokumenter teller mot din plans daglige dokumentgrense.