¿Qué hace Transcripción de Videos de YouTube?
Transcribe videos de YouTube a texto usando OpenAI Whisper y yt-dlp.
Resumen
Esta habilidad descarga el audio de videos de YouTube usando yt-dlp y lo transcribe utilizando el modelo Whisper de OpenAI. Soporta múltiples formatos de salida (txt, srt, vtt, json) y varios tamaños de modelo para diferentes compensaciones entre precisión y velocidad.
Instrucciones
1. Instalar dependencias
# Instalar whisper y yt-dlp
pip install openai-whisper yt-dlp
# Verificar que ffmpeg esté instalado (requerido para procesamiento de audio)
ffmpeg -version
Si ffmpeg falta:
- macOS:
brew install ffmpeg - Ubuntu/Debian:
sudo apt install ffmpeg - Windows: Descargar de https://ffmpeg.org/download.html
2. Descargar audio de YouTube
# Descargar la mejor calidad de audio como WAV
yt-dlp -x --audio-format wav -o "%(title)s.%(ext)s" "YOUTUBE_URL"
# Descargar como MP3 (archivo más pequeño)
yt-dlp -x --audio-format mp3 -o "%(title)s.%(ext)s" "YOUTUBE_URL"
# Descargar con ID de video como nombre de archivo (más seguro para caracteres especiales)
yt-dlp -x --audio-format wav -o "%(id)s.%(ext)s" "YOUTUBE_URL"
3. Elegir modelo Whisper
| Modelo | Parámetros | VRAM | Velocidad Relativa | Caso de Uso |
|---|---|---|---|---|
| tiny | 39M | ~1 GB | ~32x | Borradores rápidos, pruebas |
| base | 74M | ~1 GB | ~16x | Transcripción rápida |
| small | 244M | ~2 GB | ~6x | Buen equilibrio |
| medium | 769M | ~5 GB | ~2x | Alta precisión |
| large | 1550M | ~10 GB | 1x | Mejor precisión |
Los modelos solo inglés (tiny.en, base.en, small.en, medium.en) son más rápidos para contenido en inglés.
4. Ejecutar transcripción
Enfoque CLI:
# Transcripción básica (detección automática de idioma)
whisper audio.wav --model medium
# Especificar idioma para mayor precisión
whisper audio.wav --model medium --language en
# Formato de salida específico
whisper audio.wav --model medium --output_format srt
# Todos los formatos a la vez
whisper audio.wav --model medium --output_format all
# Especificar directorio de salida
whisper audio.wav --model medium --output_dir ./transcripts
Enfoque Python:
import whisper
# Cargar modelo (descarga en la primera ejecución)
model = whisper.load_model("medium")
# Transcribir
result = model.transcribe("audio.wav", language="en")
# Obtener texto plano
print(result["text"])
# Obtener segmentos con marcas de tiempo
for segment in result["segments"]:
print(f"[{segment['start']:.2f} - {segment['end']:.2f}] {segment['text']}")
5. Tubería de un solo comando
Combinar descarga y transcripción:
# Descargar y transcribir en un solo comando
yt-dlp -x --audio-format wav -o "audio.wav" "YOUTUBE_URL" && whisper audio.wav --model medium --output_format all
6. Alternativa: herramienta yt-whisper
Para un flujo de trabajo más simple, usa el paquete dedicado yt-whisper:
# Instalar
pip install git+https://github.com/m1guelpf/yt-whisper.git
# Transcribir directamente desde URL
yt_whisper "https://www.youtube.com/watch?v=VIDEO_ID"
# Con opciones
yt_whisper "YOUTUBE_URL" --model medium --language en --output_format srt
Formatos de Salida
| Formato | Extensión | Descripción |
|---|---|---|
| txt | .txt | Transcripción en texto plano |
| srt | .srt | Formato de subtítulos SubRip (con marcas de tiempo) |
| vtt | .vtt | Formato de subtítulos WebVTT |
| tsv | .tsv | Valores separados por tabulaciones |
| json | .json | Datos completos con marcas de tiempo a nivel de palabra |
Ejemplos
Buenas Prácticas
- Usa la bandera
--languagecuando sepas el idioma hablado para obtener una precisión significativamente mejor. - Para videos largos (>1 hora), usa el modelo
smallomediumpara equilibrar velocidad y precisión. - Los modelos solo inglés (sufijo
.en) son más rápidos y precisos para contenido en inglés. - Una GPU con CUDA acelera drásticamente la transcripción; la CPU funciona pero es 5-10 veces más lenta.
- Si la transcripción falla, asegúrate de que ffmpeg esté instalado correctamente y en el PATH.
- Para videos con música de fondo, los modelos más grandes (medium/large) manejan mejor la situación.
- Limpia los archivos de audio después de la transcripción para ahorrar espacio en disco.
- Usa
--output_format allpara obtener todos los formatos a la vez, luego elige el que necesites.