Anil-matcha/AI-Youtube-Shorts-Generator

解决的问题

此项目提供付费 AI 剪辑工具的开源替代方案。它允许使用者将长篇 YouTube 影片转换为适合 TikTok、Reels 和 YouTube Shorts 的短版病毒式垂直短影音 (9:16)，无需支付昂贵的月费或受限于单次剪辑的点数限制。

运作原理

该工具透过多步骤流程处理影片：

1. 撷取 (Ingestion)：透过 YouTube URL 或本地档案下载影片。
2. 转录 (Transcription)：使用 Whisper (透过 MuAPI 或本地端 faster-whisper) 建立带有时间戳记的逐字稿。
3. 分析 (Analysis)：LLM (GPT 或 Gemini) 使用特定的“病毒式传播框架”分析逐字稿，根据钩子 (hooks)、情绪高峰和实用价值来识别高影响力的时刻。
4. 处理 (Processing)：将长影片分段以确保不会遗漏任何精彩片段，并对重叠的片段进行去重。
5. 渲染 (Rendering)：将选定的精彩片段进行垂直裁切。在 API 模式下，由 MuAPI 处理；在本地模式下，使用 OpenCV 人脸追踪和 FFmpeg 进行动态平滑处理。

适用对象

• 内容创作者：希望免费将长篇内容重新利用为短影音的人。
• 代理商：需要处理大量影片且不想负担高额 SaaS 成本的人。
• 开发者：希望透过提供的 Python 函数库或 CLI 将 AI 剪辑流程整合到自己应用程序中的人。

特色亮点

• 双重运作模式：提供快速的 API 驱动模式 (MuAPI) 以及用于离线处理的本地模式 (LLM 调用除外)。
• 病毒式传播感知排名：根据“观点炸弹”和“揭露时刻”等特定讯号对片段进行排名，而非仅基于一般兴趣。
• 智慧垂直裁切：在本地模式下使用人脸追踪，确保主体保持在 9:16 画面的中心。
• 自动化友善：支援透过 xargs 进行批次处理，并可将结果汇出为 JSON 以供后续工作流程使用。