DeepScript

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

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

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

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.

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

En lugar de hacer polling: registra una URL HTTPS y recibe una entrega firmada con HMAC-SHA256 en cada evento, con tres reintentos.

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

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

System

Se pueden llamar sin autenticación. La lista de idiomas es la respuesta fiable sobre qué idiomas se admiten realmente.

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

Clave de API en dos minutos

Crea una cuenta, genera una clave y empieza. Las primeras 3 transcripciones son gratis, sin tarjeta.