API Speech-to-Text
API mowa-na-tekst, które trzyma Twoje audio w Niemczech
REST API z 20 endpointami, 99 językami, rozdzielaniem mówców w każdym planie i webhookami podpisanymi HMAC. Własne silniki na własnym sprzęcie w Niemczech, bez firm trzecich w torze mowy, od 0.18 € za godzinę audio.
- Base URL
- https://api.deepscript.com/v1
- Uwierzytelnianie
- Bearer ds_live_…
- Limit zapytań
- 100 zapytań/min z kluczem, 30 bez klucza
- Lokalizacja danych
- Germany
Trzy wywołania do transkryptu
Upload od razu zwraca ID. Potem polling albo czekanie na webhook.
# 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.srtFormat błędów: RFC 7807 Problem Details, application/problem+json.
Wszystkie endpointy
Ścieżki, metody i nazwy są po angielsku, tak jak w specyfikacji OpenAPI. Interaktywne testy z własnym kluczem w referencji.
Transcriptions
Rdzeń API: wyślij plik, sprawdzaj status, odbierz wynik w czterech formatach. Upload od razu zwraca identyfikator, przetwarzanie działa asynchronicznie.
| 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
Własne listy słów dla nazw produktów, terminów branżowych i nazw własnych. Tworzone raz, wskazywane przez ID w każdej transkrypcji.
| 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
Zamiast pollingu: zarejestruj adres HTTPS i otrzymuj dostawy podpisane HMAC-SHA256 przy każdym zdarzeniu, z trzema ponowieniami.
| Method | Path | Summary |
|---|---|---|
| GET | /v1/webhooks | List webhook endpoints |
| POST | /v1/webhooks | Create webhook endpoint |
| DELETE | /v1/webhooks/{id} | Delete webhook endpoint |
Account
Saldo, zużycie i profil workspace'u. Przydatne, by przed dużą partią sprawdzić, czy środki wystarczą.
| 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
Dostępne bez uwierzytelniania. Lista języków to wiarygodna odpowiedź na pytanie, które języki są naprawdę obsługiwane.
| Method | Path | Summary |
|---|---|---|
| GET | /v1/health | Health check |
| GET | /v1/languages | List supported languages |
Zdarzenia webhook
Każda dostawa ma podpis HMAC-SHA256 w nagłówku i przy błędzie jest ponawiana trzy razy z rosnącym odstępem.
transcription.completedSent when a transcription completestranscription.failedSent when a transcription failsbalance.lowSent when workspace balance drops below the configured threshold
Czytelne dla maszyn
Pełna specyfikacja OpenAPI 3.1 jest zduplikowana na tej domenie. Generatory klientów, Postman i agenci AI mogą ją czytać bezpośrednio.
Podłącz bez kodu
To samo API w innym opakowaniu: serwer MCP dla agentów AI, no-code przez Zapier lub Make, self-hosted przez n8n.
Klucz API w dwie minuty
Utwórz konto, wygeneruj klucz, zaczynaj. Pierwsze 3 transkrypcje są bezpłatne, bez karty.