AI-Youtube-Shorts-Generator

AI-Youtube-Shorts-Generator 概覽

這是什麼

AI-Youtube-Shorts-Generator 是 Opus Clip、Vidyo.ai、Klap、SubMagic 與 2short.ai 的開源替代方案。它能將長篇 YouTube 影片轉換為適合病毒式傳播的 9:16 短影音，使用 LLM 亮點偵測、Whisper 語音轉文字與自動垂直裁切。此工具完全免費、無浮水印、無需按片段計費，採用 MIT 授權，可自行託管或透過 API 模式使用。

主要功能

• YouTube 輸入、垂直輸出：提供任何 YouTube 網址，即可獲得多個具病毒傳播潛力的 9:16 MP4 片段。
• 兩種模式：API 模式（快速，使用 MuAPI 進行下載、轉錄與裁切）或本機模式（離線，使用 yt-dlp、faster-whisper、ffmpeg/OpenCV，並可選擇 OpenAI 或 Gemini 進行亮點排名）。
• 病毒性感知亮點選擇：根據鉤子、情緒高峰、意見炸彈、啟示時刻、衝突、可引用台詞、故事高峰與實用價值對片段進行排名。
• 每個亮點附有分數、鉤子與原因：包含病毒傳播分數、開場鉤子句與一句話解釋。
• 智慧垂直裁切：API 模式使用 MuAPI 自動裁切；本機模式使用 OpenCV 人臉追蹤與動態平滑。
• 命令列與 Python 函式庫：可從終端機使用，或將 generate_shorts(...) 匯入自己的流程。
• JSON 輸出：使用 --output-json 旗標可輸出完整結果（逐字稿、候選亮點、片段網址/路徑），便於後續自動化處理。

使用情境

• 創作者、代理商與開發者，希望免費開源替代 Opus Clip 或 Vidyo.ai 等付費剪輯工具。
• 使用本儲存庫提供的相同 API 建立自有的 Opus Clip 風格 SaaS 服務。
• 透過 xargs 批次處理多個 YouTube 網址，高效進行內容再利用。
• 自行託管以完全掌控亮點演算法、輸出格式與資料隱私。

快速開始

1. 複製儲存庫： bash git clone https://github.com/SamurAIGPT/AI-Youtube-Shorts-Generator.git cd AI-Youtube-Shorts-Generator 2. 建立並啟動虛擬環境： bash python3.10 -m venv venv source venv/bin/activate 3. 安裝 Python 相依套件： bash pip install -r requirements.txt # 僅當您打算使用 --mode local 時： pip install -r requirements-local.txt 4. 在 .env 檔案中設定環境變數： bash # API 模式（預設） MUAPI_API_KEY=your_muapi_key_here # 本機模式（--mode local） LLM_PROVIDER=openai OPENAI_API_KEY=your_openai_key_here OPENAI_MODEL=gpt-4o-mini GEMINI_API_KEY=your_gemini_key_here GEMINI_MODEL=gemini-2.5-flash LOCAL_WHISPER_MODEL=base LOCAL_WHISPER_DEVICE=auto LOCAL_OUTPUT_DIR=output 完整使用說明請參閱儲存庫的 README。

授權與價格

本專案採用 MIT 授權，為開源且免費使用。若選擇 API 模式（需 MuAPI 金鑰），使用者僅需支付 API 使用費用。無按片段計費，也無浮水印。

內容整理自該專案公開的 README 與儲存庫資訊。