API-nycklar och MCP
Skapa API-nycklar, anropa alla offentliga REST-ändpunkter och anslut till den officiella Speechdash MCP-servern.
Använd Inställningar → API för att skapa nycklar och ansluta till assistenter. Den samma sh_live_…-nyckeln godkänner den offentliga REST-API:n och den officiella MCP-servern. Kopplare under Inställningar → Kopplare är en annan funktion: de ansluter tredjeparts-MCP-server till chatt inom appen.
Skapa en nyckel
- Öppna Inställningar → API.
- Klicka på Ny nyckel, ge den ett namn (t.ex.
Produktionsserver) och kopiera den omedelbart. Endast prefixet sparas; hela hemligheten visas bara en gång. - Skicka
Authorization: Bearer sh_live_…från din server. Placera aldrig en nyckel i en webbläsare, en mobilapp eller ett offentligt repository.
Du kan ha upp till 10 aktiva nycklar. Återkalla en läckt nyckel från samma sida.
Verifiera en nyckel med GET /v1/me (e-post, plan och plånbok). Bas-URL: https://api.speechdash.com/v1.
REST-ändpunkter
Alla offentliga HTTP-rutter:
| Metod | Sökväg | Syfte |
|---|---|---|
GET | /health | Tjänstens hälsa (ingen API-nyckel; inte under /v1) |
GET | /v1/openapi.json | OpenAPI 3.1-kontrakt |
GET | /v1/me | Konto, plan och plånbok |
GET | /v1/documents | Lista biblioteksdokument, inklusive färdiga transkriptioner |
POST | /v1/documents | Skapa ett textdokument (source=api) |
GET | /v1/documents/{document_id} | Läsa ett dokument och dess text |
PUT | /v1/documents/{document_id} | Uppdatera titel, text, språk, is_archived eller visibility |
DELETE | /v1/documents/{document_id} | Ta bort ett dokument |
POST | /v1/documents/{document_id}/translate | Ny översatt version (samma poäng som MP3-export) |
GET | /v1/documents/{document_id}/export | Ladda ner pdf, docx, txt, csv, srt eller vtt |
POST | /v1/audio/speech | Synthesera upp till 5 000 tecken (JSON + ljud) |
POST | /v1/audio/stream | Strömma WAV, upp till 20 000 tecken |
POST | /v1/audio/stream/with-timestamps | SSE med per-sats ljud och märken |
GET | /v1/voices | Röstkatalog |
GET | /v1/voices/{voice_id} | En röstinställning (t.ex. F1) |
API:n startar inte ljud- eller videotranskriptionsuppgifter. Färdiga uppgifter visas som biblioteksdokument (source=transcription). Interaktiva försök-sida: Konto, Dokument, Ljud, Röster.
MCP-värktøy
Den officiella servern på https://mcp.speechdash.com/mcp exponerar ett verktyg per bibliotek eller talhandling. ChatGPT använder OAuth. Cursor och Claude Desktop använder Streamable HTTP med din personliga API-nyckel.
| MCP-verktyg | 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 |
Resurs: speechdash://openapi (levande OpenAPI JSON).
Strömmande tal (POST /v1/audio/stream och POST /v1/audio/stream/with-timestamps) har inget MCP-verktyg. Använd REST för dessa rutter och för /health.
Inställning: MCP-server och Agents hub.
Poäng
Talgenerering (REST och MCP) kostar 0.5 poäng per startad 30 sekund av genererat ljud. Översättning använder samma takt som MP3-export. Skapande av dokument och filexport kostar inga poäng. Skapande av dokument räknas mot din plans dagliga dokumentgräns.