Colafornia/short-video-generator-AI

short-video-generator-AI

簡介 – 一個開源Python工具，可將完整長度的YouTube（或本機）影片轉換為一個或多個直式短影片片段（9:16、1:1等）。它結合了自動轉錄、AI驅動的亮點選擇、可選的AI生成鉤子和簡單的影片渲染。整個流程在本機執行，除了LLM呼叫，可使用OpenAI、Gemini或MuAPI。

主要功能

• 單行CLI – python main.py <YouTube-URL> 產生可直接發布的短影片。
• Web UI – 一個小型本機網頁（shorts-generator-ui.html），可排隊多個影片並直觀調整選項。
• 亮點偵測 – 轉錄文字由語言模型根據「病毒式傳播」線索（如情感高峰、金句、實用技巧）進行評分（0-100）。
• AI生成鉤子 – 由同一LLM建立的可選短開場，以吸引注意力。
• 多供應商LLM支援 – OpenAI、Gemini或MuAPI；只需在.env檔案中設定LLM_PROVIDER和相應的API金鑰。
• 本機Whisper轉錄 – 使用faster-whisper模型（tiny → large-v3），支援CPU或CUDA。
• 可設定輸出 – 片段數量（--n）、寬高比、解析度、語言以及是否包含鉤子。

運作方式

1. 下載 – 取得來源影片（YouTube或本機路徑）。
2. 轉錄 – 使用faster-whisper產生帶時間戳的文字檔案。
3. 內容類型分類 – 透過所選LLM（播客、訪談、教學等）調整亮點提示。
4. 轉錄片段評分 – 使用「病毒式框架」（鉤子、情感高峰、揭示等）傳回排名候選。
5. 去重 – 移除重疊候選，保留得分最高的。
6. 選擇前N個片段 – 按--n指定的數量選擇。
7. 渲染 – 將每個片段垂直渲染，可選地在開頭新增AI生成的鉤子，並儲存到output/資料夾。

典型工作流程

# 複製並設定
git clone https://github.com/Colafornia/short-video-generator-AI.git
cd short-video-generator-AI
python -m venv venv && source venv/bin/activate
pip install -r requirements.txt

# 建立包含LLM金鑰的.env
cat > .env <<EOF
LLM_PROVIDER=openai
OPENAI_API_KEY=sk-…
LOCAL_WHISPER_MODEL=base
EOF

# 從YouTube影片產生3個短影片
python main.py "https://www.youtube.com/watch?v=abc123" --n 3 --ratio 9:16

若要使用Web UI，請執行python3 server.py並提供web/資料夾，然後開啟http://localhost:8000/shorts-generator-ui.html。

適用對象

• 希望免費替代商業短影片產生器（如OpusClip、Vidyo.ai）的內容創作者。
• 需要將現有長影片批次處理為TikTok/YouTube-Shorts格式的小型團隊。
• 希望以API優先方式將短影片產生嵌入自有管道的開發者。

限制

• 依賴外部LLM API進行亮點評分和鉤子產生；OpenAI或MuAPI需要付費金鑰，而Gemini的免費額度有限。
• 亮點品質在很大程度上取決於倉庫內的提示設計；可能會錯過小眾的「病毒式」時刻。
• 影片渲染在底層使用ffmpeg風格命令，因此效能受限於硬體。
• 沒有內建的來源影片浮水印移除功能；該工具僅裁剪原始素材。

授權 – MIT（免費使用、修改和再散布）。