Saltar al contenido
Transcript Dock
Iniciar sesiónEmpezar gratis

Menú del sitio

Transcript Dock
API de audio directo

API de transcripción de podcasts episodios completos con tiempos por palabra

Enlaces de audio públicos y archivos MP3 de podcasts, de hasta 2 horas por episodio, con transcripción con IA.

1.0Capacidades

Ventajas principales y los límites que traen

Transcribe episodios de podcasts a partir de enlaces de audio directos, incluidas las URL de enclosure de RSS, con segmentos con tiempos y tiempos por palabra.

  1. Episodios de hasta 2 horas

    Acepta audio largo de hasta 2 horas y 250 MB por archivo, transcrito como un solo trabajo con tiempos por segmento y por palabra.

  2. Descarga protegida contra SSRF

    Las URL de audio directo se validan con comprobaciones estrictas de IP y de redirecciones antes de que empiece la descarga.

  3. Notificaciones por webhook

    Recibe un webhook firmado con HMAC SHA256 cuando termina un episodio largo, en lugar de consultar su estado una y otra vez.

Límites operativos y transparencia

  • El tamaño máximo del archivo de audio es de 250 MB (262,144,000 bytes).
  • La duración máxima del episodio es de 7,200 segundos (2 horas).
  • Infraestructura de una sola región; la transcripción con IA se cobra a 2 créditos por minuto iniciado, con un mínimo de 60 segundos.
2.0Implementación

Solicitud y respuesta la solicitud exacta y lo que se devuelve

POST/v1/jobs

curl -X POST https://www.transcriptdock.com/v1/jobs \
-H "Authorization: Bearer td_live_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"source": {
"url": "https://media.example.com/podcasts/episode-104.mp3"
},
"mode": "transcribe"
}'

Resultado del trabajo

{
"id": "8e9f0a1b-2c3d-4e5f-6a7b-8c9d0e1f2a3b",
"status": "succeeded",
"stage": null,
"result_id": "1f2a3b4c-5d6e-7f8a-9b0c-1d2e3f4a5b6c",
"error": null,
"billing": {
"credits_reserved": 0,
"credits_charged": 80,
"kind": "ai_transcription"
},
"source": {
"platform": "direct",
"media_id": null,
"canonical_url": "https://media.example.com/podcasts/episode-104.mp3",
"title": null,
"upload_id": null
},
"options": {
"mode": "transcribe",
"language": null,
"caption_preference": "prefer_creator"
},
"created_at": "2026-09-12T17:20:00Z"
}
3.0Preguntas

Preguntas frecuentes

Qué pasa con los subtítulos, la transcripción con IA y los límites para esta fuente.

¿Puedo enviar URL de enclosure de RSS?

Sí. Se aceptan los enlaces HTTPS directos a archivos de audio MP3, M4A o WAV alojados en redes de distribución de contenido de podcasts.

¿Cómo funcionan los webhooks con episodios largos de podcast?

Puedes pasar webhook_endpoint_id en la solicitud del trabajo para recibir una notificación automática en cuanto termine la transcripción.