short-video-generator-AI完整CLI指南:5个参数玩转批量短视频剪辑(--n/--ratio/--no-hook)
short-video-generator-AI完整CLI指南:5个参数玩转批量短视频剪辑(--n/--ratio/--no-hook)
short-video-generator-AI 是一个免费的开源 AI 短视频生成工具:粘贴一条 YouTube 长视频链接(或直接指定本地视频文件),它就能自动检测高光片段、生成字幕、翻译并配音,一键产出 9:16 竖版爆款短视频,全程无水印、无额度限制。本文带你用 5 个核心 CLI 参数(--n / --ratio / --resolution / --language / --no-hook)玩转批量短视频剪辑。
快速上手:3 步安装与配置
环境要求:Python 3.10+,以及任意一家 LLM 的 API Key(OpenAI / Gemini / MuAPI)。
# 1. 克隆仓库
git clone https://gitcode.com/gh_mirrors/sh/short-video-generator-AI
cd short-video-generator-AI
# 2. 创建虚拟环境并安装依赖
python -m venv venv
# Windows: venv\Scripts\activate | Linux/MacOS: source venv/bin/activate
pip install -r requirements.txt
3. 配置 .env 文件(位于项目根目录):
# 选择 LLM 提供商:openai / gemini / MuAPI
LLM_PROVIDER=openai
OPENAI_API_KEY=your_openai_key_here
OPENAI_MODEL=gpt-4o-mini # 可选
# Whisper 本地转录设置
LOCAL_WHISPER_MODEL=base # tiny / base / small / medium / large-v3
LOCAL_WHISPER_DEVICE=auto # auto / cpu / cuda
💡 不确定选哪家?Gemini 提供每日免费额度;OpenAI 为付费订阅;MuAPI 按量付费、无需订阅。
5 个 CLI 参数一览表
所有渲染参数通过命令行传入 main.py,完整参数表定义在 README.md:
| 参数 | 默认值 | 作用 |
|---|---|---|
--n |
3 | 渲染几条短视频 |
--ratio |
9:16 | 画面比例(任意比例,如 1:1) |
--resolution |
720 | 源视频下载分辨率:360 / 480 / 720 / 1080 |
--language |
auto | 强制指定 Whisper 语言代码(如 zh、en) |
--no-hook |
- | 关闭视频开头 AI 生成的钩子(hook) |
逐个拆解:每个参数怎么用
--n:一次生成几条短视频
从一条长视频里自动挑出多少条高光片段。值越大,产出越多,耗时越长。日常运营建议从 --n 3 起步,多账号分发时可用 --n 4 甚至更高:
python main.py "https://www.youtube.com/watch?v=video_id" --n 4
--ratio:自由切换画面比例
默认 9:16 竖屏,最适合 TikTok、抖音、Shorts;发朋友圈或某些信息流可改 1:1 方形;也支持任意自定义比例:
python main.py "https://www.youtube.com/watch?v=video_id" --ratio 9:16
--resolution:控制下载清晰度
指定从 YouTube 下载源视频时的分辨率(360 / 480 / 720 / 1080)。带宽紧张选 480,追求成片画质选 1080:
python main.py "https://www.youtube.com/watch?v=video_id" --resolution 1080
--language:指定转录语言
默认 auto 自动检测。处理中文、日语等非英语内容时,显式指定语言能显著提升 faster-whisper 的转写准确率:
python main.py "/path/to/本地视频.mp4" --language zh
--no-hook:关闭 AI 开场钩子
默认情况下,每条短视频开头会自动加一段 AI 生成的"钩子"文案,用来在前 3 秒抓住观众。如果你已有自己的开场设计、或想保持原片原貌,加上 --no-hook 即可排除:
python main.py "https://www.youtube.com/watch?v=video_id" --no-hook
完整示例:组合参数批量出片
🎬 处理一条 YouTube 长视频,产出 3 条 1080p 竖版短视频:
python main.py "https://www.youtube.com/watch?v=video_id" \
--n 3 \
--ratio 9:16 \
--resolution 1080
处理本地视频文件(无需下载,直接剪辑),并强制中文转录:
python main.py "/Users/Admin/Folder/video.mp4" \
--n 4 \
--ratio 9:16 \
--resolution 720 \
--language zh
渲染完成的成片会自动保存到项目根目录的 output 文件夹。
幕后流程:高光检测是怎么做的
工具内部是一条自动化流水线(详见 README.md):
- 下载:从 YouTube 拉取源视频,或直接读取本地文件
- 转录:
faster-whisper在本地生成带时间戳的字幕 - 内容分类:LLM 判断视频类型(播客、访谈、教程、vlog)并匹配节奏
- 高光打分:LLM 按"病毒式传播框架"(钩子时刻、情绪峰值、观点冲突、金句等)给候选片段打 0–100 分
- 去重:按分数合并重叠片段
- Top-N 选择:取前
--n名 - 自动裁切:按
--ratio渲染成竖版短片,除非加了--no-hook
LLM 评分逻辑可参考 src/services/gemini.py,转录相关实现见 src/base/whisper.py。
不想敲命令?试试 Web 界面
项目还自带本地 Web 版,可一次性排队多个视频并可视化调整参数(LLM 提供商与 API Key 仍在 .env 中配置):
python3 server.py
# 另开一个终端,启动前端
cd web
python3 -m http.server 8000
# 浏览器打开 http://localhost:8000/shorts-generator-ui.html
前后端入口分别是 server.py 与 web/web.html。
总结
--n控制产出数量,--ratio控制画面比例,--resolution控制清晰度,--language提升非英语转录准确率,--no-hook一键关闭 AI 开场钩子- 5 个参数自由组合,一条命令即可完成"下载 → 转录 → 高光检测 → 裁切配音"全流程
- 免费开源、无水印,是 OpusClip / Vidyo.ai 等付费 SaaS 的实用替代方案 🚀