VideoCaptioner－影片字幕工具 是做什麼的？
VideoCaptioner：轉錄 → 優化/翻譯 → 燒錄自訂樣式的硬字幕。免費的語音辨識路徑，適用於短影片。
功能
- 語音轉錄：從影片音軌自動辨識語音，生成時間軸對齊的文字。
- 優化與翻譯：可選用 AI 服務對轉錄文字進行校對、改寫或翻譯成其他語言。
- 燒錄硬字幕：將最終字幕以自訂樣式（字體、大小、顏色、位置）直接嵌入影片畫面。
- 免費 ASR 路徑：提供免費的語音辨識選項，適合短影片快速處理。
支援平台
- 本機執行：需要安裝 Python 3.8+ 與相關依賴（如 ffmpeg、whisper 等）。
- 雲端服務：可整合 OpenAI Whisper API、Google Cloud Speech-to-Text 等。
使用方式
安裝
pip install video-captioner
基本命令
video-captioner --input video.mp4 --output output.mp4 --lang zh-TW
設定選項
| 參數 | 說明 | 預設值 |
|---|---|---|
--input | 輸入影片路徑 | 必填 |
--output | 輸出影片路徑 | output.mp4 |
--lang | 轉錄語言代碼 | en |
--style | 字幕樣式檔案 | default.json |
--translate | 目標翻譯語言（如 zh-TW） | 無 |
環境變數
OPENAI_API_KEY：用於 Whisper API 或 GPT 優化/翻譯。GOOGLE_APPLICATION_CREDENTIALS：用於 Google Cloud 語音服務。
進階範例
video-captioner --input lecture.mp4 --output lecture_hardsub.mp4 --lang en --translate zh-TW --style subtitle_style.json
常見問答
問：免費 ASR 路徑的準確度如何？ 答：對於清晰的短影片（<5 分鐘），準確度可達 90% 以上。建議背景噪音較大時使用雲端付費服務。
問：如何自訂字幕樣式？ 答：建立 JSON 設定檔，可指定字體、大小、顏色、邊框、陰影與位置。詳細格式請參考文件。
授權條款
MIT License。詳見 LICENSE 檔案。
歡迎貢獻程式碼或回報問題至 GitHub 儲存庫。