API-Schlüssel und MCP
Erstellen Sie API-Schlüssel, rufen Sie jeden öffentlichen REST-Endpoint auf und verbinden Sie den offiziellen Speechdash-MCP-Server.
Verwenden Sie Einstellungen → API, um Schlüssel zu erstellen und Assistenten zu verbinden. Der gleiche sh_live_…-Schlüssel autorisiert die öffentliche REST-API und den offiziellen MCP-Server. Verbinder unter Einstellungen → Verbinder sind eine andere Funktion: Sie fügen dritte MCP-Server an die Chat-In-App an.
Einen Schlüssel erstellen
- Öffnen Sie Einstellungen → API.
- Klicken Sie auf Neuer Schlüssel, benennen Sie ihn (z. B.
Produktionsserver) und kopieren Sie ihn sofort. Nur der Präfix wird gespeichert; das vollständige Geheimnis wird nur einmal angezeigt. - Senden Sie
Authorization: Bearer sh_live_…von Ihrem Server. Legen Sie niemals einen Schlüssel in einen Browser, eine Mobile-App oder ein öffentliches Repository ab.
Sie können bis zu 10 aktive Schlüssel behalten. Widerrufen Sie einen kompromittierten Schlüssel von derselben Seite.
Überprüfen Sie einen Schlüssel mit GET /v1/me (E-Mail, Plan und Wallet). Basierend auf der URL: https://api.speechdash.com/v1.
REST-Endpunkte
Jede öffentliche HTTP-Route:
| Methode | Pfad | Zweck |
|---|---|---|
GET | /health | Dienstgesundheit (kein API-Schlüssel; nicht unter /v1) |
GET | /v1/openapi.json | OpenAPI 3.1-Vertrag |
GET | /v1/me | Konto, Plan und Wallet |
GET | /v1/documents | Liste der Bibliotheksdokumente, einschließlich abgeschlossener Transkriptionen |
POST | /v1/documents | Erstellen eines Textdokuments (source=api) |
GET | /v1/documents/{document_id} | Lesen eines Dokuments und seines Textes |
PUT | /v1/documents/{document_id} | Aktualisieren von Titel, Text, Sprache, is_archived oder visibility |
DELETE | /v1/documents/{document_id} | Löschen eines Dokuments |
POST | /v1/documents/{document_id}/translate | Neue übersetzte Version (gleiche Gutschriften wie MP3-Export) |
GET | /v1/documents/{document_id}/export | Herunterladen von pdf, docx, txt, csv, srt oder vtt |
POST | /v1/audio/speech | Synthese von bis zu 5.000 Zeichen (JSON + Audio) |
POST | /v1/audio/stream | Streaming von WAV, bis zu 20.000 Zeichen |
POST | /v1/audio/stream/with-timestamps | SSE mit Audio pro Satz und Markierungen |
GET | /v1/voices | Sprachkatalog |
GET | /v1/voices/{voice_id} | Ein Sprachvoreinstellung (z. B. F1) |
Die API startet keine Audio- oder Video-Transkriptionsaufträge. Abgeschlossene Aufträge erscheinen als Bibliotheksdokumente (source=transcription). Interaktive Testseiten: Konto, Dokumente, Audio, Stimmen.
MCP-Werkzeuge
Der offizielle Server unter https://mcp.speechdash.com/mcp bietet ein Werkzeug pro Bibliotheks- oder Sprachaktion. ChatGPT verwendet OAuth. Cursor und Claude Desktop verwenden Streamable HTTP mit Ihrem persönlichen API-Schlüssel.
| MCP-Werkzeug | 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 (Live-OpenAPI JSON).
Streaming-Sprache (POST /v1/audio/stream und POST /v1/audio/stream/with-timestamps) hat kein MCP-Werkzeug. Verwenden Sie REST für diese Routen und für /health.
Einrichtung: MCP-Server und der Agents-Hub.
Gutschriften
Spracherzeugung (REST und MCP) verbraucht 0,5 Gutschriften pro gestarteten 30 Sekunden generierten Audios. Übersetzen verwendet denselben Satz wie MP3-Export. Das Erstellen von Dokumenten und das Herunterladen von Dateien verbrauchen keine Gutschriften. Das Erstellen von Dokumenten zählt auf die tägliche Dokumentenobergrenze Ihres Plans.
Siehe Was verbraucht Gutschriften.