Cómo publicar transcripciones accesibles para cada vídeo de un curso

El problema que resuelve

Los centros educativos y los creadores de cursos suelen tener cientos de vídeos sin transcripción, o solo con subtítulos automáticos que no se pueden leer como un documento. Los servicios de accesibilidad reciben las solicitudes de adaptación de una en una. Publicar transcripciones legibles para todo elimina el trabajo acumulado y beneficia a todos los estudiantes.

Qué incluir en tu primera versión

• ■Transcripciones para todos los vídeos de un curso o canal
• ■Reconocimiento de voz por IA para vídeos sin subtítulos
• ■Párrafos y etiquetas de orador para facilitar la lectura
• ■Páginas de transcripción en HTML fáciles de navegar con lectores de pantalla
• ■Archivos de texto y de subtítulos descargables

Cómo construirlo, paso a paso

1. 01

   Haz inventario de los vídeos

   Resuelve cada lista de reproducción o canal del curso para listar todos los vídeos que necesitan transcripción.

2. 02

   Transcribe en bloque

   Envía los IDs a /batch con format.paragraphs. Activa allow_asr con un webhook para que los vídeos sin subtítulos se transcriban con reconocimiento de voz por IA.

3. 03

   Mejora la legibilidad

   En las clases con varios oradores, usa las etiquetas de orador de ASR. Mantén los saltos de párrafo y los encabezados para que las transcripciones se lean como documentos.

4. 04

   Publica

   Muestra cada transcripción como una página HTML o una sección desplegable bajo el vídeo, con un enlace de descarga.

Código de inicio

Esta idea se basa en el patrón "Receta 3: carga en bloque una lista de reproducción en una base de conocimiento". Usa tus propios canales, prompts y almacenamiento.

import requests

API = "https://www.youtubetranscript.dev/api/v2"
HEADERS = {"Authorization": "Bearer yt_sk_live_YOUR_KEY"}

playlist = requests.post(f"{API}/playlists/resolve", headers=HEADERS,
                         json={"playlist_url": "https://www.youtube.com/playlist?list=PLAYLIST_ID",
                               "limit": 100}).json()

ids = [v["video_id"] for v in playlist["items"]]
batch = requests.post(f"{API}/batch", headers=HEADERS, json={
    "video_ids": ids,
    "format": {"timestamp": True, "paragraphs": True},
}).json()

# Large batches run async: poll GET /batch/{batch_id} until status is "completed"
for r in batch.get("results", []):
    if r["status"] == "completed":
        for p in r["data"]["transcript"].get("paragraphs") or []:
            store(video_id=r["video_id"], start=p["start"], text=p["text"])  # your vector DB

Por qué vale la pena construirlo

Para las instituciones, el retorno es cumplir antes sus obligaciones de accesibilidad y hacer que el contenido de los cursos sea más útil y fácil de encontrar. Las agencias y plataformas pueden vender la publicación de transcripciones como servicio a los centros educativos.

Errores que debes evitar

• ✕Publicar subtítulos automáticos como un único bloque de texto continuo: dales formato con párrafos y oradores.
• ✕Ofrecer las transcripciones solo como descarga: pon el texto en la página para que sea legible e indexable.
• ✕Dar por hecho que el resultado de la IA es perfecto: haz que alguien revise términos técnicos y nombres, sobre todo en adaptaciones obligatorias.

Preguntas sobre esta idea