short-video-generator-AI全部CLI参数详解:--n、--ratio、--resolution、--no-hook一次讲清
short-video-generator-AI全部CLI参数详解:--n、--ratio、--resolution、--no-hook一次讲清
short-video-generator-AI 是一款免费的开源短视频生成工具,可以把 YouTube 长视频一键转成带字幕、配音和 AI 钩子的爆款竖屏短视频。它的命令行参数只有 5 个:--n、--ratio、--resolution、--language、--no-hook,本文就把这些 short-video-generator-AI CLI 参数的含义、默认值和最佳实践一次讲清楚,新手也能快速上手。
先搞懂:这些参数控制什么?
short-video-generator-AI 的工作流程是:下载视频 → 本地语音转写 → LLM 分析内容类型 → 按"病毒传播度"给高潮片段打分排序 → 渲染成竖版短视频。参数正是作用在最后两步:生成几条、什么画幅、什么清晰度、要不要开头钩子。
基础用法(参数全部省略时使用默认值):
python main.py "https://www.youtube.com/watch?v=video_id"
带参数的完整用法:
python main.py "https://www.youtube.com/watch?v=video_id" \
--n 3 \
--ratio 9:16 \
--resolution 1080
渲染好的片段会保存到 output 文件夹。支持本地视频文件作为输入,例如:
python main.py "/Users/Admin/Folder/video.mp4" \
--n 4 \
--ratio 9:16 \
--resolution 720 \
--language zh
5 个 CLI 参数逐个拆解
官方参数表来自 README.md:
| 参数 | 默认值 | 作用 |
|---|---|---|
--n |
3 |
渲染几条短视频片段 |
--ratio |
9:16 |
输出画幅:9:16 竖屏 / 1:1 方形 / 任意比例 |
--resolution |
720 |
源视频下载清晰度:360 / 480 / 720 / 1080 |
--language |
auto |
强制指定 Whisper 转写语言,如 en、zh |
--no-hook |
- | 开关参数:去掉片头 AI 生成的钩子 |
1. --n:生成几条片段
LLM 会先给候选高潮片段打 0–100 分并排序,--n 决定取前几名渲染。默认 3。
- 素材少、想多几条备选 →
--n 4或更大 - 视频很短、只想精剪 →
--n 1
2. --ratio:输出画幅
短视频平台(TikTok、Reels、Shorts)用 9:16 竖屏;需要发方形图版(如部分信息流广告位)可用 1:1。也支持任意比例,按需填写即可。
3. --resolution:源视频清晰度
它决定从 YouTube 下载源视频的分辨率,档位为 360 / 480 / 720 / 1080,默认 720。
- 网络慢、机器配置低 →
360或480,下载更快 - 追求成片画质 →
1080,但下载和渲染耗时明显增加
4. --language:指定转写语言
转写由 faster-whisper 在本地完成。留空即自动检测;如果自动检测不准(比如中英混杂),可以强制指定,如 --language zh。
5. --no-hook:关闭片头钩子
默认情况下,工具会在片段开头加一句"上下文感知"的 AI 钩子(hook),用来抓住观众前 3 秒的注意力。如果你的素材开头本身就很抓人,或想保持原片节奏,加上 --no-hook 即可去掉。
实战组合推荐
| 场景 | 命令要点 |
|---|---|
| 快速出片测试 | 不加参数,直接用默认值 |
| 正式发短视频平台 | --n 3 --ratio 9:16 --resolution 1080 |
| 中文视频、低配电脑 | --n 2 --resolution 720 --language zh |
| 只要原片高潮、不要 AI 钩子 | 加 --no-hook |
不想敲命令?用 Web 版可视化配置
除了 CLI,项目自带本地 Web 界面,可以把上面 5 个参数变成表单,支持一次排队多个视频。
启动方式(来自 README.md):
python3 server.py
cd web
python3 -m http.server 8000
然后浏览器打开 http://localhost:8000/web.html。
Web 表单和 CLI 参数是一一对应的,这个映射关系可以直接在 web/web.html 里看到:--n 对应 Clips 输入框、--ratio 对应 Ratio 输入框、--resolution 对应下拉框(360/480/720/1080)、勾选框取消时自动生成 --no-hook。前端还会实时把表单拼成 CLI 命令给你预览(web/web.html):
python main.py "<video>" --n 3 --ratio 9:16 --resolution 720 --no-hook
后端由 server.py 接收表单请求后,组装同样的命令行去调用 main.py,并对比 output 目录返回新生成的 .mp4 文件名。
常见问题
Q:参数放错位置会怎样?
参数写在视频链接后面,用反斜杠 \ 换行(Windows 的 CMD 可写在一行)。
Q:--no-hook 能传值吗?
不能,它是开关参数(flag),出现即生效,不带值。
Q:改了参数还是老样子?
检查 .env 里的 LLM_PROVIDER 和 API key 是否配置正确,这是参数生效的前提。
小结
short-video-generator-AI 的 CLI 设计很克制:--n 管数量、--ratio 管画幅、--resolution 管画质、--language 管转写、--no-hook 管钩子,记住这 5 个就能覆盖绝大多数创作场景。更多细节可参考 README.md,项目依赖见 requirements.txt。
