video-quick-mashup

关于

视频快速混剪 本机运行的视频混剪 Web 工具。你在浏览器里填自己的密钥、引用本机素材、写或生成文案、选模板，本机用火山引擎或阿里百炼 TTS，再交给 FFmpeg 合成 MP4。 这不是抖音、字节跳动、火山引擎、阿里云或 DeepSeek 的官方产品。密钥只存在你的浏览器里。素材、任务和成片写在本机 data/ 目录。本项目没有云端服务器，也不会代你调用第三方接口。 界面 | 编辑文案 | 工作台成片 | | --- | --- | | | | | 成片库 | 成片预览 | | | | 你需要准备什么 1. Node.js 20 或更高 2. 本机已安装 FFmpeg 和 ffprobe，并且能在终端里直接运行 ffmpeg、ffprobe 3. 至少一家配音服务： 火山引擎 语音合成的 App ID 和 Access Token 或 阿里百炼 API Key（CosyVoice） 两家都可以填，出片时在配音区选择用哪一家 4. （可选）DeepSeek API Key，用来根据主题生成文案；不填也可以手写文案后出片 本机还需要能访问你实际用到的接口： 火山 TTS： 阿里百炼： DeepSeek： Linux 上若要用系统文件选择器，请先安装 Zenity（常见桌面环境一般已有）。没有的话，可以把文件从文件管理器拖进页面。 启动 进入本项目目录后： bash cp .env.example .env npm install npm run dev 浏览器打开 / 本机使用的方式。 已经构建过、只想起一个本机服务时： bash npm run build npm start 然后打开 API 都由这个地址提供。没先 build 的话，打开页面会是 404。 .env 只放端口，不要把 API Key 或 TTS Token 写进去。 怎么用 1. 打开「配置」，填写至少一家 TTS 凭证；要用 AI 写文案时再填 DeepSeek API Key。点对应的「测试」确认连通。 2. 在 ① 素材池选择或拖入竖屏图片 / 视频。工具会引用本机原路径，不把文件复制进项目。可选在 ③ 添加一首 BGM。 3. 在 ② 选择火山或百炼，再选音色。密钥在「配置」里填，这里只选音色。 4. 在 ④ 手写一条或多条文案（标题 + 字幕段），或填主题后让 DeepSeek 生成；表格里可以再改。 5. 在 ⑤ 勾选一套或多套模板。可用「显示标题 / 显示字幕」控制成片是否画出标题和字幕；关掉前会确认。口播仍按字幕生成。 6. 点「开始生成」。文案数 × 模板数不能超过 20，同时只能跑一个任务。 7. 在工作台看配音 → 成片进度，预览或下载 MP4；失败后可以整单重新生成。历史成片在「成片库」。 本机数据 | 位置 | 内容 | | --- | --- | | 浏览器 localStorage 的 qm.config | 你填的 Key 和 TTS 凭证 | | 项目下的 data/ | 任务 JSON、配音音频、成片 MP4；引用素材只记路径 | 任务 JSON 里不会保存 API Key 或 TTS Token。 关掉页面或停掉本机服务后，正在跑的任务会停。下次打开不会自动续跑。 常见问题 提示找不到 ffmpeg 先在终端执行 ffmpeg -version 和 ffprobe -version。macOS 可用 brew install ffmpeg。 TTS 测试失败 核对当前选用的那一家凭证，以及本机能否访问对应域名。火山要核对 App ID 与 Access Token 是否来自同一语音合成应用。 画面没有中文标题 FFmpeg 需要本机有可用中文字体。工具会按常见路径查找；找不到时成片仍会生成，但标题 / 字幕可能是方框。说明见 templates/fonts.md。 Linux 点「选择文件」没反应 确认已安装 zenity，或改用拖入文件。 开发 bash npm test npm run typecheck 测试默认不调用真实 DeepSeek / 火山 / 百炼接口，也不要求本机已安装 FFmpeg。 免责与安全 使用前请阅读 DISCLAIMER.md、SECURITY.md、docs/privacy.md。贡献见 CONTRIBUTING.md。 License MIT

收录记录

1. 阮一峰周刊·用户投稿

   2026年9月1日 · 1 次收录