Saltar al contenido
Transcript Dock
Iniciar sesiónEmpezar gratis

Menú del sitio

Transcript Dock
API de YouTube

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.

1.0Capacidades

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.

  1. Primero los subtítulos del creador

    Cuando un video tiene subtítulos publicados, se lee directamente la pista del creador, sin descargar audio y sin cargo de transcripción con IA.

  2. Enlaces de watch, para compartir y de Shorts

    Los enlaces watch estándar, los enlaces para compartir youtu.be y los enlaces de Shorts apuntan al mismo video, así que una sola forma de solicitud los cubre.

  3. Tiempos por segmento y por palabra

    Las pistas de subtítulos tienen tiempos por bloque. La transcripción con IA devuelve los tiempos de cada palabra, para que puedas cortar clips y sincronizar líneas de tiempo.

  4. Exportaciones estructuradas en varios formatos

    Exporta resultados JSON unificados o descarga archivos de subtítulos SRT y WebVTT estándar con formato consistente.

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).
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://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"
}
3.0Preguntas

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.