DeepScript

API Speech-to-Text

L'API speech-to-text che tiene i tuoi audio in Germania

Un'API REST con 20 endpoint, 99 lingue, separazione dei parlanti in tutti i piani e webhook firmati HMAC. Motori nostri su hardware nostro in Germania, nessun terzo nella pipeline vocale, da 0.18 € per ora di audio.

Base URL
https://api.deepscript.com/v1
Autenticazione
Bearer ds_live_…
Rate limit
100 richieste/min autenticato, 30 senza chiave
Sede dei dati
Germany

Tre chiamate per una trascrizione

L'upload risponde subito con un ID. Poi fai polling oppure attendi il 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

Formato degli errori: RFC 7807 Problem Details, application/problem+json.

Tutti gli endpoint

Percorsi, metodi e nomi sono in inglese, come nella specifica OpenAPI. Provali con la tua chiave nella reference.

Transcriptions

Il cuore dell'API: carica un file, controlla lo stato, scarica il risultato in quattro formati. L'upload risponde subito con un ID, l'elaborazione è asincrona.

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

Liste di parole personalizzate per nomi di prodotto, termini tecnici e nomi propri. Create una volta, richiamabili per ID in ogni trascrizione.

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

Invece del polling: registra un endpoint HTTPS e ricevi una consegna firmata HMAC-SHA256 a ogni evento, con tre tentativi di reinvio.

MethodPathSummary
GET/v1/webhooksList webhook endpoints
POST/v1/webhooksCreate webhook endpoint
DELETE/v1/webhooks/{id}Delete webhook endpoint

Account

Saldo, consumo e profilo del workspace. Utile per verificare che il credito basti prima di avviare un batch grande.

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

System

Richiamabili senza autenticazione. L'elenco delle lingue è la risposta attendibile su quali lingue sono davvero supportate.

MethodPathSummary
GET/v1/healthHealth check
GET/v1/languagesList supported languages

Eventi webhook

Ogni consegna porta una firma HMAC-SHA256 nell'header e viene ritentata tre volte con attesa crescente in caso di errore.

  • transcription.completedSent when a transcription completes
  • transcription.failedSent when a transcription fails
  • balance.lowSent when workspace balance drops below the configured threshold

Leggibile dalle macchine

La specifica OpenAPI 3.1 completa è replicata su questo dominio. Generatori di client, Postman e agenti IA possono leggerla direttamente.

Chiave API in due minuti

Crea un account, genera una chiave, parti. Le prime 3 trascrizioni sono gratuite, senza carta.