leamsigc/ShortsGenerator

ShortsGenerator – 自动化 YouTube Shorts 生成器

功能简介

• 根据文本提示生成短视频，包括 AI 撰写的脚本、库存视频、文本转语音、字幕、背景音乐以及可选的图像拼接。
• 提供与 Flask 后端通信的 Web UI（Nuxt 3）。后端运行整个流水线并暴露一组 REST 端点。
• 视频生成后，您可以通过 MagicSync 集成将其安排到多个社交平台（Instagram、TikTok、Facebook、LinkedIn、YouTube）。

主要组件

层	技术 / 角色
后端	Python 3.11、Flask、ffmpeg、Torch（用于 Qwen-3 TTS），g4f/Gemini 用于脚本生成。处理库存视频搜索（Pexels API）、TTS（Supertonic、TikTok、KittenTTS、Qwen-3）、字幕渲染、视频拼接以及 MagicSync API 调用。
前端	Nuxt 3（Vue）UI，运行在 localhost:3000。允许您输入主题、编辑生成的脚本、选择语音、字幕、宽高比、音乐等，然后通过文档化的 API 触发后端。
AI 模型	• 脚本：免费的 g4f（基于浏览器 cookie）或 Gemini（通过 GOOGLE_API_KEY）。
• TTS：本地 Supertonic（10 种声音，33 种语言）、TikTok TTS（回退）、KittenTTS、Qwen-3-TTS（本地模型，9 种预设音色、语音设计、语音克隆）。
媒体来源	来自 Pexels 的库存剪辑、用户提供的音乐文件、视频开头可选的图像拼接。
调度	MagicSync – 您可以存储多个业务账户（API URL + 令牌），并在发布时选择使用哪一个。

使用方法

1. 克隆仓库，将 .env.example 复制为 .env，并至少填写 PEXELS_API_KEY 和 IMAGEMAGICK_BINARY。
2. 运行后端（python Backend/main.py）和 Nuxt UI（cd UI && pnpm i && npx nuxt dev --tunnel）。 还支持通过 docker compose up -d 使用 Docker。
3. 在 Web UI 中，输入视频主题，生成脚本，调整脚本，选择声音和字幕样式，添加可选图像或音乐，然后点击 生成。
4. 视频生成完成后，您可以提取缩略图、预览视频，并通过 MagicSync 安排上传。

显著特点

• 多语音 TTS，支持本地高质量模型（Qwen-3）和回退方案。
• 字幕模板（10 种视觉样式）自动生成。
• 宽高比灵活性，适用于垂直 Shorts（9:16）或其他格式。
• 硬件加速 – 检测 GPU 并将其传递给 ffmpeg/Torch 以加快编码。
• 多业务 MagicSync – 为每个客户存储单独的 API 凭据，并在调度时选择正确的凭据。

适用人群

• 希望批量制作 YouTube Shorts 而无需手动编辑视频的内容创作者。
• 管理多个品牌账户并需要可重复流水线的小型代理机构。
• 希望寻找端到端短视频生成堆栈的开源参考实现的开发者。

局限性

• 需要 Python 3.11 和相当重的依赖堆栈（Torch、Qwen-3 权重约 3 GB）。
• 某些 AI 服务（Gemini、OpenAI）需要 API 密钥；免费的 g4f 路径依赖于浏览器 cookie。
• 调度仅适用于专有的 MagicSync 服务；仓库未提供通用的社交媒体 API。

许可证

• 该项目根据 LICENSE 文件中的许可证发布（此处未复制）。