Speech-to-Text API
Die Speech-to-Text API, die deine Audiodateien in Deutschland lässt
REST-API mit 20 Endpunkten, 99 Sprachen, Sprechertrennung in allen Tarifen und HMAC-signierten Webhooks. Eigene Engines auf eigener Hardware in Deutschland, kein Drittanbieter für die Spracherkennung, ab 0.18 € pro Stunde Audio.
- Base URL
- https://api.deepscript.com/v1
- Authentifizierung
- Bearer ds_live_…
- Rate Limit
- 100 Anfragen/Min. authentifiziert, 30 ohne Key
- Serverstandort
- Deutschland
In drei Aufrufen zum Transkript
Upload antwortet sofort mit einer ID. Danach entweder pollen oder auf den Webhook warten.
# 1. Upload
curl -X POST https://api.deepscript.com/v1/transcriptions \
-H "Authorization: Bearer ds_live_YOUR_KEY" \
-F "file=@meeting.mp3" -F "model=standard" -F "language=auto"
# 2. Poll
curl https://api.deepscript.com/v1/transcriptions/{id}/status \
-H "Authorization: Bearer ds_live_YOUR_KEY"
# 3. Export
curl "https://api.deepscript.com/v1/transcriptions/{id}/export?format=srt" \
-H "Authorization: Bearer ds_live_YOUR_KEY" -o result.srtFehlerformat: RFC 7807 Problem Details, application/problem+json.
Alle Endpunkte
Pfade, Methoden und Bezeichnungen stehen englisch, wie in der OpenAPI-Spezifikation. Interaktives Ausprobieren mit eigenem Key in der Referenz.
Transcriptions
Der Kern der API: Datei hochladen, Status abfragen, Ergebnis in vier Formaten abholen. Der Upload antwortet sofort mit einer ID, die Verarbeitung läuft asynchron.
| Method | Path | Summary |
|---|---|---|
| POST | /v1/transcriptions | Create transcription (file upload) |
| GET | /v1/transcriptions | List transcriptions |
| GET | /v1/transcriptions/{id} | Get transcription detail |
| DELETE | /v1/transcriptions/{id} | Delete transcription |
| GET | /v1/transcriptions/{id}/status | Get transcription status (lightweight polling) |
| GET | /v1/transcriptions/{id}/events | SSE stream for real-time status updates |
| GET | /v1/transcriptions/{id}/export | Export transcription |
Vocabularies
Eigene Wortlisten für Produktnamen, Fachbegriffe und Eigennamen. Einmal angelegt, per ID bei jeder Transkription referenzierbar.
| Method | Path | Summary |
|---|---|---|
| GET | /v1/vocabularies | List vocabularies |
| POST | /v1/vocabularies | Create vocabulary |
| GET | /v1/vocabularies/{id} | Get vocabulary |
| PUT | /v1/vocabularies/{id} | Update vocabulary |
| DELETE | /v1/vocabularies/{id} | Delete vocabulary |
Webhooks
Statt zu pollen: eine HTTPS-Adresse registrieren und bei jedem Ereignis eine HMAC-SHA256-signierte Zustellung erhalten, mit drei Wiederholungsversuchen.
| Method | Path | Summary |
|---|---|---|
| GET | /v1/webhooks | List webhook endpoints |
| POST | /v1/webhooks | Create webhook endpoint |
| DELETE | /v1/webhooks/{id} | Delete webhook endpoint |
Account
Guthaben, Verbrauch und Profil des Workspace. Nützlich, um vor einem großen Batch zu prüfen, ob das Guthaben reicht.
| Method | Path | Summary |
|---|---|---|
| GET | /v1/account/balance | Get current balance |
| GET | /v1/account/usage | Get usage analytics |
| GET | /v1/account/profile | Get account profile |
System
Ohne Authentifizierung abrufbar. Die Sprachliste ist die belastbare Antwort auf die Frage, welche Sprachen wirklich unterstützt werden.
| Method | Path | Summary |
|---|---|---|
| GET | /v1/health | Health check |
| GET | /v1/languages | List supported languages |
Webhook-Events
Jede Zustellung trägt eine HMAC-SHA256-Signatur im Header und wird bei einem Fehler dreimal mit steigendem Abstand wiederholt.
transcription.completedSent when a transcription completestranscription.failedSent when a transcription failsbalance.lowSent when workspace balance drops below the configured threshold
Maschinenlesbar
Die vollständige OpenAPI-3.1-Spezifikation liegt gespiegelt auf dieser Domain. Client-Generatoren, Postman und KI-Agenten können sie direkt lesen.
Ohne Code anbinden
Dieselbe API, andere Verpackung: MCP-Server für KI-Agenten, no-code über Zapier oder Make, self-hosted über n8n.
API-Key in zwei Minuten
Konto anlegen, Key erzeugen, loslegen. 3 Transkriptionen sind kostenlos, ohne Kreditkarte.