API de transcripciones de YouTube primero los subtítulos del creador, con tiempos por bloque
Un solo endpoint para videos y Shorts de YouTube. Primero los subtítulos del creador, con tiempos por bloque.
Ventajas principales y los límites que traen
Obtén los subtítulos de los creadores de videos y Shorts de YouTube como segmentos con tiempos, con transcripción con IA en los planes de pago para videos sin subtítulos.
Límites operativos y transparencia
- Infraestructura de una sola región, desplegada en el este de EE. UU.
- Precios: 1 crédito por transcripción de subtítulos y 2 créditos por minuto iniciado de transcripción con IA, desde un solo saldo.
- La duración máxima por fuente es de 2 horas (7,200 segundos).
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://www.youtube.com/watch?v=dQw4w9WgXcQ"},"mode": "captions_only","caption_preference": "prefer_creator"}'
Resultado del trabajo
{"id": "7b8f9e0a-4c2d-4e6f-8a1b-3c5d7e9f1a2b","status": "succeeded","stage": null,"result_id": "9c1d3e5f-7a9b-4c2d-8e0f-1a3b5c7d9e2f","error": null,"billing": {"credits_reserved": 0,"credits_charged": 1,"kind": "captions"},"source": {"platform": "youtube","media_id": "dQw4w9WgXcQ","canonical_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ","title": "Sample YouTube Video","upload_id": null},"options": {"mode": "captions_only","language": null,"caption_preference": "prefer_creator"},"created_at": "2026-09-12T14:32:00Z"}
Preguntas frecuentes
Qué pasa con los subtítulos, la transcripción con IA y los límites para esta fuente.
¿Cómo trata la API los videos sin subtítulos?
Cuando mode está en auto, el sistema busca primero los subtítulos del creador. Si no existen, obtiene el audio de forma segura y ejecuta la transcripción con IA para producir una transcripción con marcas de tiempo.
¿Puedo pedir solo subtítulos para evitar cargos de transcripción con IA?
Sí. Si estableces mode en captions_only, se garantiza que no se ejecute ningún proceso de transcripción con IA, así que el costo de extracción es predecible y bajo.
¿Se admiten los Shorts de YouTube?
Sí. Tanto los enlaces watch estándar de youtube.com como las URL de youtube.com/shorts se normalizan y se transcriben.
