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