YouTube 影片轉錄
使用 OpenAI Whisper 與 yt-dlp 將 YouTube 影片轉錄為文字。
概述
此技能使用 yt-dlp 從 YouTube 影片下載音訊,再透過 OpenAI 的 Whisper 模型進行轉錄。支援多種輸出格式(txt、srt、vtt、json)以及不同大小的模型,以在準確度與速度之間取得平衡。
操作說明
1. 安裝相依套件
# 安裝 whisper 和 yt-dlp
pip install openai-whisper yt-dlp
# 確認 ffmpeg 已安裝(音訊處理必需)
ffmpeg -version
如果缺少 ffmpeg:
- macOS:
brew install ffmpeg - Ubuntu/Debian:
sudo apt install ffmpeg - Windows:從 https://ffmpeg.org/download.html 下載
2. 從 YouTube 下載音訊
# 以最佳音質下載為 WAV
yt-dlp -x --audio-format wav -o "%(title)s.%(ext)s" "YOUTUBE_URL"
# 下載為 MP3(檔案較小)
youtube-dl -x --audio-format mp3 -o "%(title)s.%(ext)s" "YOUTUBE_URL"
# 以影片 ID 作為檔名下載(避免特殊字元問題)
yt-dlp -x --audio-format wav -o "%(id)s.%(ext)s" "YOUTUBE_URL"
3. 選擇 Whisper 模型
| 模型 | 參數 | VRAM | 相對速度 | 使用情境 |
|---|---|---|---|---|
| tiny | 39M | ~1 GB | ~32x | 快速草稿、測試 |
| base | 74M | ~1 GB | ~16x | 快速轉錄 |
| small | 244M | ~2 GB | ~6x | 良好平衡 |
| medium | 769M | ~5 GB | ~2x | 高準確度 |
| large | 1550M | ~10 GB | 1x | 最佳準確度 |
純英文模型(tiny.en、base.en、small.en、medium.en)處理英文內容速度更快。
4. 執行轉錄
CLI 方式:
# 基本轉錄(自動偵測語言)
whisper audio.wav --model medium
# 指定語言以提升準確度
whisper audio.wav --model medium --language en
# 指定輸出格式
whisper audio.wav --model medium --output_format srt
# 一次輸出所有格式
whisper audio.wav --model medium --output_format all
# 指定輸出目錄
whisper audio.wav --model medium --output_dir ./transcripts
Python 方式:
import whisper
# 載入模型(初次執行時會下載)
model = whisper.load_model("medium")
# 轉錄
result = model.transcribe("audio.wav", language="en")
# 取得純文字
print(result["text"])
# 取得附帶時間戳記的區段
for segment in result["segments"]:
print(f"[{segment['start']:.2f} - {segment['end']:.2f}] {segment['text']}")
5. 單行管線
將下載與轉錄合併為一個指令:
# 下載並轉錄一行完成
yt-dlp -x --audio-format wav -o "audio.wav" "YOUTUBE_URL" && whisper audio.wav --model medium --output_format all
6. 替代方案:yt-whisper 工具
若想更簡潔,可使用專用的 yt-whisper 套件:
# 安裝
pip install git+https://github.com/m1guelpf/yt-whisper.git
# 直接從 URL 轉錄
yt_whisper "https://www.youtube.com/watch?v=VIDEO_ID"
# 加上選項
yt_whisper "YOUTUBE_URL" --model medium --language en --output_format srt
輸出格式
| 格式 | 副檔名 | 說明 |
|---|---|---|
| txt | .txt | 純文字轉錄稿 |
| srt | .srt | SubRip 字幕格式(含時間戳記) |
| vtt | .vtt | WebVTT 字幕格式 |
| tsv | .tsv | 定位點分隔值 |
| json | .json | 完整資料,含逐字時間戳記 |
範例
指南
- 如果知道影片的語言,請使用
--language標記,可顯著提升準確度 - 對於長影片(超過 1 小時),建議使用
small或medium模型以平衡速度與準確度 - 純英文模型(
.en後綴)處理英文內容更快、更準確 - 具備 CUDA 的 GPU 能大幅加快轉錄速度;使用 CPU 則慢 5-10 倍
- 如果轉錄失敗,請確認 ffmpeg 已正確安裝且位於 PATH 環境變數中
- 對於背景有音樂的影片,較大的模型(medium/large)處理效果更好
- 轉錄完成後請清理音訊檔案以節省磁碟空間
- 使用
--output_format all一次取得所有格式,再從中選擇所需