API Speech-to-Text
La API de voz a texto que mantiene tu audio en Alemania
Una API REST con 20 endpoints, 99 idiomas, separación de hablantes en todos los planes y webhooks firmados con HMAC. Motores propios en hardware propio en Alemania, sin terceros en la cadena de voz, desde 0.18 € por hora de audio.
- Base URL
- https://api.deepscript.com/v1
- Autenticación
- Bearer ds_live_…
- Límite de tasa
- 100 solicitudes/min autenticado, 30 sin clave
- Ubicación de los datos
- Germany
Tres llamadas hasta la transcripción
La subida responde de inmediato con un ID. Después haz polling o espera el 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 de errores: RFC 7807 Problem Details, application/problem+json.
Todos los endpoints
Rutas, métodos y nombres están en inglés, igual que en la especificación OpenAPI. Pruébalos con tu clave en la referencia.
Transcriptions
El núcleo de la API: sube un archivo, consulta el estado, descarga el resultado en cuatro formatos. La subida responde de inmediato con un ID y el procesamiento es asíncrono.
| 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
Listas de palabras propias para nombres de producto, términos técnicos y nombres propios. Se crean una vez y se referencian por ID en cualquier transcripción.
| 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
En lugar de hacer polling: registra una URL HTTPS y recibe una entrega firmada con HMAC-SHA256 en cada evento, con tres reintentos.
| 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 y perfil del espacio de trabajo. Útil para comprobar si el saldo cubre un lote grande antes de lanzarlo.
| 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
Se pueden llamar sin autenticación. La lista de idiomas es la respuesta fiable sobre qué idiomas se admiten realmente.
| Method | Path | Summary |
|---|---|---|
| GET | /v1/health | Health check |
| GET | /v1/languages | List supported languages |
Eventos de webhook
Cada entrega lleva una firma HMAC-SHA256 en la cabecera y se reintenta tres veces con espera creciente si falla.
transcription.completedSent when a transcription completestranscription.failedSent when a transcription failsbalance.lowSent when workspace balance drops below the configured threshold
Legible por máquinas
La especificación OpenAPI 3.1 completa está replicada en este dominio. Generadores de clientes, Postman y agentes de IA pueden leerla directamente.
Conectar sin código
La misma API con otro envoltorio: servidor MCP para agentes de IA, sin código con Zapier o Make, autoalojado con n8n.
Clave de API en dos minutos
Crea una cuenta, genera una clave y empieza. Las primeras 3 transcripciones son gratis, sin tarjeta.