
JJYB_AI_VideoAutoCut
导入素材自动切片配音,批量出解说短视频
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-11-22 · 当前星标 ★ 1262
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Windows 系统(启动脚本与命令均为 PowerShell 写法)
- Python 3.10–3.13,命令以 py -3 调用
- FFmpeg 与 ffprobe 已安装并加入系统 PATH
- 可选:Python 3.10 独立解释器,用于本地 IndexTTS2 声音复刻 worker
安装与启动步骤
-
1获取项目源码
从项目主页克隆仓库到本地目录,后续所有命令均在项目根目录执行。
git clone https://github.com/jianjieyiban/JJYB_AI_VideoAutoCut.git cd JJYB_AI_VideoAutoCut -
2安装主程序依赖
在项目根目录用 Python 3 安装 requirements.txt 中的主程序依赖,等待全部安装完成。
py -3 -m pip install -r requirements.txt -
3安装 FFmpeg
从 FFmpeg 官网下载并解压到任意目录(如 C:\ffmpeg),将 bin 目录加入系统 PATH 后重开终端。
-
4验证 FFmpeg
确认 ffmpeg 与 ffprobe 可被调用,二者用于视频渲染、时长探测和音画同步。
ffmpeg -version ffprobe -version -
5启动应用
双击 启动应用.bat,或在项目根目录执行以下命令,应用会尝试打开 PyWebView 桌面窗口。
py -3 frontend\app.py -
6访问本地页面
若未弹出桌面窗口,可在浏览器访问本地服务地址 http://127.0.0.1:5000 进行操作。
-
7配置模型接口
进入系统设置页 /settings,在文本、视觉、图像生成三张独立卡片中分别填写 API Key、Base URL 与模型名,并点击测试连接。
-
8可选本地声音复刻
安装 Python 3.10,按 models/index-tts/pyproject.toml 装依赖,模型权重放入 models/index-tts/checkpoints/,可设置 INDEXTTS_PYTHON 指向该解释器。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
文本模型 API Key / Base URL / 模型名 | 是 | 支撑解说文案等文本生成,推荐使用自定义 OpenAI 兼容接口。 | sk-xxxxxxxx |
视觉模型 API 配置 | 否 | 原创解说需要云端视觉分析时单独配置,与文本模型互不干扰。 | sk-xxxxxxxx |
图像生成模型 API | 否 | AI 封面生成所使用,独立于文本与视觉模型卡片。 | sk-xxxxxxxx |
INDEXTTS_PYTHON | 否 | 指向 Python 3.10 解释器路径,供本地 IndexTTS2 声音复刻 worker 使用。 | C:\Python310\python.exe |
config/ai_config.json | 否 | 运行时自动生成的模型配置存档,含 API Key,注意不要外传。 | config/ai_config.json |
如何确认成功
终端无报错并打开桌面窗口,或浏览器访问 http://127.0.0.1:5000 能正常显示界面;设置页测试连接通过。
常见问题
Q:启动后没有弹出桌面窗口怎么办?
A:服务可用时直接在浏览器访问 http://127.0.0.1:5000 即可;退出时关闭窗口或在终端按 Ctrl + C。
Q:提示找不到 ffmpeg 命令?
A:确认已把 FFmpeg 的 bin 目录(如 C:\ffmpeg\bin)加入系统 PATH,并重新打开终端后再次执行 ffmpeg -version。
Q:模型配置填好了但任务无法开始?
A:检查 API Key、Base URL 与模型名是否填在对应卡片中,三类模型配置相互独立,并先点击测试连接确认真实连通。
Q:本地声音复刻显示未就绪?
A:需要独立的 Python 3.10 worker、按 pyproject.toml 装好依赖,并把模型权重放到 models/index-tts/checkpoints/ 目录。
注意事项
- uploads/、output/、database/、logs/、temp/ 存放素材、成片、项目数据和日志,不要当作垃圾目录删除。
- 如需清理源码运行产生的 Python 缓存,先执行 py -3 scripts/maintenance.py 只读预览,确认无误后加 --apply。
- 本项目采用个人使用许可,仅限个人学习、研究与自行使用,商业用途需获得作者书面授权。
- 外部语音服务与剪映/CapCut 兼容性需在目标环境自行验收。
核心亮点
- 内置离线 TTS,配音不依赖云端接口,本地即可完成合成
- 覆盖切片、混剪、解说文案、配音到成片的完整链路,减少多工具切换
- 以 HTML 前端呈现,部署和上手门槛较低,适合非专业剪辑人员
不足之处
- 项目以 HTML 为主,工程化与模块化程度有限,二次开发扩展性一般
- AI 解说与自动剪辑的成片质量依赖素材与参数调优,复杂场景仍需人工干预
适用场景
- 批量制作影视/游戏解说类短视频
- 电商或知识类账号的素材混剪与自动配音
- 个人创作者快速把长视频拆成多条短片
替代项目
MoneyPrinterTurbo、Auto-Editor、FunClip
上一篇:ViralForge
下一篇:neonclipping
同类项目推荐
TheoremExplainAgent
开源
让LLM定理推理变成看得懂的动画视频,自动生成教学讲解。
Official Repo for "TheoremExplainAgent: Towards Video-based Multimodal Explanations ···
FancyVideo
开源
输入文字或图片,快速生成动态视频片段
Video generation from text&image, 1st-gen
PRISM
开源
用反事实视频把少量演示扩成机器人训练数据
[CoRL 2026] Counterfactual Video Generation Enables Scalable Humanoid Loco-Manipulat···
svd-mv
开源
用视频扩散模型生成多视角一致的 3D 视图
Unofficial Implementation of "Stable Video Diffusion Multi-View"
vmem
开源
让视频生成保持多视角一致,支持交互式场景编辑
[ICCV 2025 ⭐highlight⭐] Implementation of VMem: Consistent Interactive Video Scene···
Efficient4D
开源
一段单视角视频,快速生成可动的 3D 物体
[IJCV 2026] Efficient4D: Fast Dynamic 3D Object Generation from a Single-view Video
reelforge
开源
一句话简报,自动生成带字幕旁白的可编辑视频
Agent-native AI video factory: one brief → narrated, subtitled, scene-editable vide···
voxel-flow
开源
用体素流场合成视频帧,搞定插帧和预测
Video Frame Synthesis using Deep Voxel Flow (ICCV 2017 Oral)
video-shotcraft
开源
一句话吩咐 AI,电影级产品视频自动剪
AI video skill for Claude Code & Codex — cinematic, editable product promos with Re···