Necesitas una transcripción limpia de un video de YouTube que puedas indexar, resumir, subtitular o alimentar en tu flujo de trabajo esta semana. Al final de esta guía, llamarás a un endpoint real que devuelve líneas de texto con código de tiempo para un ID de video dado, y tendrás código que puedes copiar y pegar en tu aplicación o automatización.
Lo que construirás con la API de YouTube Sub Extractor
Zyla API Hub alberga la API de YouTube Sub Extractor, que devuelve la transcripción de texto de un video de YouTube como una secuencia de entradas de subtítulos. Cada entrada incluye el texto más los metadatos de tiempo que puedes usar para renderizar subtítulos, alinear resúmenes o anclar resultados de búsqueda a un momento en el video.
Los usos típicos incluyen:
- Generación automática de subtítulos y subtítulos cerrados con alineación temporal.
- Creación de índices buscables de contenido de video de formato largo.
- Alimentar transcripciones a resumidores, pipelines de incrustación o herramientas de moderación.
- Construir enlaces de “salto a” en tu aplicación basados en desplazamientos de transcripción.
Todo funciona con una sola clave de API y suscripción dentro de Zyla API Hub, que agrega más de 10,000 APIs públicas en diversas categorías. Hay una cuenta, una clave de API y un modelo de suscripción + cuota—no pago por llamada—para que puedas iterar sin tener que manejar credenciales separadas por proveedor.
Comenzando en Zyla API Hub
Para probar esta API rápidamente:
- Abre la lista de APIs: Inicia prueba de 7 días en la API de YouTube Sub Extractor.
- Haz clic en Suscribirse o Iniciar Prueba Gratuita cuando esté disponible. Para tu primera API en Zyla, normalmente obtienes una prueba de 7 días o 50 solicitudes; verifica la página de la API para las opciones de acceso y precios actuales. No hay Plan Gratuito.
- Copiar tu clave de API desde el panel de control.
- Llama al endpoint que se muestra a continuación con Authorization: Bearer YOUR_API_KEY.
Descripción general del endpoint
La API de YouTube Sub Extractor actualmente expone un único endpoint enfocado para obtener una transcripción:
- Endpoint: Obtener Transcripción de Video
- Método: GET
- URL: https://zylalabs.com/api/5216/youtube-sub-extractor-api/6681/get-video-transcript
- Parámetro requerido: videoId (cadena)
Envía el videoId del video de YouTube que deseas transcribir. La API responde con una carga útil JSON que incluye un indicador de éxito y un arreglo de transcripciones de entradas de subtítulos. Cada entrada contiene los campos de texto y tiempo que puedes usar en tu aplicación.
Inicio rápido: cURL que puedes pegar
A continuación se muestra una solicitud completa y funcional. Reemplaza YOUR_API_KEY con tu clave. El parámetro videoId es obligatorio, y el ejemplo utiliza un ID específico para demostrar la forma de la respuesta.
curl -s -X GET "https://zylalabs.com/api/5216/youtube-sub-extractor-api/6681/get-video-transcript?videoId=eCBABjPcNyo"
-H "Authorization: Bearer YOUR_API_KEY"
Respuesta de ejemplo oficial
Este es el JSON de ejemplo real devuelto por la API para la solicitud anterior. Úsalo para estructurar tu lógica de análisis.
{"success":true,"transcript":[{"text":"o que a gente tem no diante","duration":3.24,"offset":0,"lang":"en"},{"text":"dos nossos olhos não dá muita esperança","duration":3.24,"offset":3.24,"lang":"en"},{"text":"no futuro daqui eu vejo a polícia","duration":3.24,"offset":6.48,"lang":"en"},{"text":"atirando a dignidade de pais de família","duration":3.24,"offset":9.72,"lang":"en"},{"text":"daqui eu vejo o estado transformando pessoas","duration":3.24,"offset":12.96,"lang":"en"},{"text":"que poderiam dar bons frutos carregado em","duration":3.24,"offset":16.200000000000003,"lang":"en"},{"text":"pessoas frustradas eu não julgo entendeu monstro","duration":3.24,"offset":19.44,"lang":"en"},{"text":"não precisa ser nenhum expert title superlotado","duration":3.24,"offset":22.68,"lang":"en"},{"text":"estudado formada uma coisa pra saber que","duration":3.24,"offset":25.92,"lang":"en"},{"text":"está tudo errado para saber qual a","duration":3.24,"offset":29.160000000000004,"lang":"en"},{"text":"posição da gente isso tem que acabar","duration":3.24,"offset":32.400000000000006,"lang":"en"},{"text":"com os palestinos abete paz [Música] gino","duration":3.24,"offset":35.64,"lang":"en"},{"text":"problema queria só paz mas não viu","duration":3.24,"offset":38.88,"lang":"en"},{"text":"o veículo agora sem proteção da vida","duration":3.24,"offset":42.120000000000005,"lang":"en"},{"text":"e arrojado mas ainda era o então","duration":3.24,"offset":45.36,"lang":"en"},{"text":"ainda disparava e agora o que eu","duration":3.24,"offset":48.6,"lang":"en"},{"text":"faço me fala na maturidade na sala","duration":3.24,"offset":51.84,"lang":"en"},{"text":"tem pesadelo é época de eleição nosso","duration":3.24,"offset":55.080000000000005,"lang":"en"},{"text":"descabelo progresso sem previsão no chão torço","duration":3.24,"offset":58.32000000000001,"lang":"en"},{"text":"pro meu filho também não vira lata","duration":3.24,"offset":61.56,"lang":"en"},{"text":"é um opção tem vaca tem sempre","duration":3.24,"offset":64.80000000000001,"lang":"en"},{"text":"cid piada pode justificar nada eu entrei","duration":3.24,"offset":68.04,"lang":"en"},{"text":"político claro que foi pra vencer nelson","duration":3.24,"offset":71.28,"lang":"en"},{"text":"é um nojo esgoto exposto é alguém","duration":3.24,"offset":74.52000000000001,"lang":"en"},{"text":"é tanta injustiça em sangue nas suas","duration":3.24,"offset":77.76,"lang":"en"},{"text":"mãos por não fazer nada a troca","duration":3.24,"offset":81…
Campos clave que usarás:
- success: booleano que indica si la solicitud tuvo éxito.
- transcript: arreglo de elementos de subtítulos. Cada elemento incluye:
- text: el texto del subtítulo para ese fragmento.
- duration: longitud numérica del fragmento.
- offset: posición de inicio numérica desde el comienzo del video.
- lang: un código de idioma asociado con el fragmento.
Ejemplo en Python: obtener y unir una transcripción simple
Este fragmento llama al mismo endpoint y une las líneas de subtítulos en una sola cadena mientras preserva el tiempo para su uso posterior. Utiliza el encabezado de Autorización con tu clave de API y el mismo videoId que el ejemplo de cURL para que puedas comparar salidas.
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
VIDEO_ID = "eCBABjPcNyo"
URL = "https://zylalabs.com/api/5216/youtube-sub-extractor-api/6681/get-video-transcript"
resp = requests.get(
URL,
params={"videoId": VIDEO_ID},
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=30
)
resp.raise_for_status()
data = resp.json()
if not data.get("success"):
raise RuntimeError("La solicitud de transcripción no tuvo éxito")
entries = data.get("transcript", [])
# Mantener una transcripción de texto simple y un índice de anclajes de tiempo
full_text = " ".join([e.get("text", "") for e in entries if isinstance(e, dict)])
time_index = [{"offset": e.get("offset"), "duration": e.get("duration"), "text": e.get("text")} for e in entries]
print("Primeros 200 caracteres de la transcripción:")
print(full_text[:200])
print("\nPrimeros 3 anclajes de tiempo:")
for anchor in time_index[:3]:
print(anchor)
Detalles de implementación que ahorran tiempo
- Autenticación: pasa tu clave a través de Authorization: Bearer YOUR_API_KEY en cada solicitud.
- Cacheo: las transcripciones para un videoId dado son buenos candidatos para ser almacenados en caché en tu capa para evitar llamadas repetidas en páginas calientes o trabajos por lotes.
- Paginación: la respuesta de ejemplo devuelve el arreglo completo de transcripciones en una carga útil. No se requieren parámetros de paginación para este endpoint.
- Matemáticas de tiempo: duración y desplazamiento son valores numéricos. Mantenlos tal como están si planeas renderizar subtítulos o calcular enlaces de salto.
- Idioma: un código de idioma se incluye por fragmento. Úsalo al dirigir a traducción o pipelines de TTS.
- Manejo de errores: verifica el indicador de éxito antes de usar los datos de la transcripción.
Construyendo características reales sobre la transcripción
Crear SRT o WebVTT
Convierte cada elemento de la transcripción en un bloque de subtítulos formateando desplazamiento y desplazamiento+duración en códigos de tiempo. Ya sea que produzcas SRT o VTT, mantén el orden original de las entradas. Dado que la API ya divide la transcripción, solo necesitas lógica de formateo.
Buscar con anclajes de tiempo
Indexa fragmentos de texto con sus desplazamientos. Cuando un usuario busca, muestra líneas coincidentes con un enlace de “Saltar a 01:23” basado en el desplazamiento. Esto reduce la fricción en comparación con buscar en todo el bloque de texto.
Resumir o extraer momentos destacados
Agrupa entradas adyacentes en trozos de un tamaño objetivo (por ejemplo, por número de caracteres o duración total). Alimenta esos trozos a tu resumidor y adjunta enlaces al desplazamiento inicial de cada trozo.
Revisión de seguridad de contenido
Si realizas verificaciones de seguridad o cumplimiento, realízalas primero en fragmentos individuales. Esto facilita localizar y redactar tramos problemáticos, ya que ya tienes desplazamientos y duraciones.
Llamando a la API desde un agente de IA (MCP)
Cada API de Zyla puede ser invocada desde herramientas de codificación de IA que soportan el Protocolo de Contexto de Modelo. Apunta tu cliente compatible con MCP a este endpoint: MCP.
- Proporciona tu clave de API de Zyla a través de la configuración del cliente MCP (el endpoint acepta apikey en la URL que configuras para el host de la herramienta).
- Desde agentes como Claude Code, Cursor o Windsurf, puedes conectar una herramienta que acceda a la misma URL GET utilizada en este post con el parámetro videoId.
- El agente recibe la carga útil JSON y puede procesar la transcripción—por ejemplo, resumiendo, generando notas o insertando referencias vinculadas al tiempo en los comentarios del código.
Si eres nuevo en las herramientas MCP de Zyla, comienza con una definición de herramienta simple que envuelva el único endpoint que se muestra aquí y devuelva el arreglo de transcripciones al agente para un razonamiento posterior.
Notas operativas sobre el uso de Zyla
- Modelo de acceso: suscripción + cuota, no pago por llamada. Para tu primera API en Zyla normalmente obtienes una prueba de 7 días o 50 solicitudes. Siempre verifica la lista para los límites y facturación actuales.
- Una clave, muchos servicios: tu clave de Zyla funciona en todas las APIs suscritas, lo que simplifica la gestión de CI/CD y secretos.
- Flujos de trabajo en equipo: almacena el encabezado de Autorización en tu gestor de secretos y compártelo a través de variables de entorno en tu repositorio o plataforma de despliegue.
Si aún no tienes una cuenta, puedes crear una en minutos en Zyla API Hub y comenzar a llamar APIs inmediatamente después de suscribirte en la página de listado.
Lista de verificación de solución de problemas
- Errores 401/403: confirma que el encabezado de Autorización esté configurado como Bearer YOUR_API_KEY, y que la clave sea válida para tu suscripción.
- Transcripción vacía: verifica la cadena videoId y asegúrate de que el video tenga datos de subtítulos disponibles.
- Códigos de idioma inesperados: registra el campo lang por fragmento y enruta a través de tu pila de traducción si es necesario.
- Timeouts en tu cliente: establece un timeout razonable (por ejemplo, 30s) y reintenta una vez. Almacena en caché las respuestas exitosas por videoId.
Referencia: Endpoint y parámetros
Obtener Transcripción de Video
- Método: GET
- URL: https://zylalabs.com/api/5216/youtube-sub-extractor-api/6681/get-video-transcript
- Parámetro de consulta requerido:
- videoId: la cadena ID del video de YouTube (por ejemplo, eCBABjPcNyo)
- Autenticación: Authorization: Bearer YOUR_API_KEY
FAQ
¿Qué necesito para autenticar solicitudes?
Incluye Authorization: Bearer YOUR_API_KEY en los encabezados de la solicitud. Obtienes la clave después de suscribirte en la página de listado de la API.
¿Qué parámetros son requeridos?
Solo videoId es requerido para el endpoint Obtener Transcripción de Video.
¿La API devuelve información de tiempo?
Sí, cada elemento de la transcripción incluye campos numéricos de duración y desplazamiento que puedes usar para el tiempo de subtítulos y enlaces de salto.
¿Hay un plan gratuito?
No hay Plan Gratuito. Para tu primera API en Zyla, normalmente obtienes una prueba de 7 días o 50 solicitudes. Verifica la página de la API para el acceso y límites actuales.
¿Puedo llamar a esto desde un agente de IA?
Sí. Usa el endpoint MCP y configura tu herramienta para acceder a la misma URL GET con el parámetro videoId. Consulta el enlace MCP anterior para más detalles.
¿Listo para implementar tu integración de transcripción? Suscríbete en la página de listado y obtén tu clave ahora: Inicia prueba de 7 días en la API de YouTube Sub Extractor.