DeepScript

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.srt

Format 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.

MethodPathSummary
POST/v1/transcriptionsCreate transcription (file upload)
GET/v1/transcriptionsList transcriptions
GET/v1/transcriptions/{id}Get transcription detail
DELETE/v1/transcriptions/{id}Delete transcription
GET/v1/transcriptions/{id}/statusGet transcription status (lightweight polling)
GET/v1/transcriptions/{id}/eventsSSE stream for real-time status updates
GET/v1/transcriptions/{id}/exportExport 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.

MethodPathSummary
GET/v1/vocabulariesList vocabularies
POST/v1/vocabulariesCreate 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.

MethodPathSummary
GET/v1/webhooksList webhook endpoints
POST/v1/webhooksCreate 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ą.

MethodPathSummary
GET/v1/account/balanceGet current balance
GET/v1/account/usageGet usage analytics
GET/v1/account/profileGet account profile

System

Dostępne bez uwierzytelniania. Lista języków to wiarygodna odpowiedź na pytanie, które języki są naprawdę obsługiwane.

MethodPathSummary
GET/v1/healthHealth check
GET/v1/languagesList 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 completes
  • transcription.failedSent when a transcription fails
  • balance.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.

Klucz API w dwie minuty

Utwórz konto, wygeneruj klucz, zaczynaj. Pierwsze 3 transkrypcje są bezpłatne, bez karty.