short-video-generator-AI全部CLI参数详解:--n、--ratio、--resolution、--no-hook一次讲清

原创2026-10-26 13:56:121,626 阅读

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 个参数变成表单,支持一次排队多个视频。

short-video-generator-AI Web 界面参数表单

启动方式(来自 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。

登录后查看全文
short-video-generator-AI