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.srtFormato 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.
| 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
Liste di parole personalizzate per nomi di prodotto, termini tecnici e nomi propri. Create una volta, richiamabili per ID in ogni trascrizione.
| 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
Invece del polling: registra un endpoint HTTPS e ricevi una consegna firmata HMAC-SHA256 a ogni evento, con tre tentativi di reinvio.
| Method | Path | Summary |
|---|---|---|
| GET | /v1/webhooks | List webhook endpoints |
| POST | /v1/webhooks | Create 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.
| 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
Richiamabili senza autenticazione. L'elenco delle lingue è la risposta attendibile su quali lingue sono davvero supportate.
| Method | Path | Summary |
|---|---|---|
| GET | /v1/health | Health check |
| GET | /v1/languages | List 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 completestranscription.failedSent when a transcription failsbalance.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.
Collegare senza codice
La stessa API con confezioni diverse: server MCP per agenti IA, no-code con Zapier o Make, self-hosted con n8n.
Chiave API in due minuti
Crea un account, genera una chiave, parti. Le prime 3 trascrizioni sono gratuite, senza carta.