The project's README from github.com/yizhi-chengzi/video-ai-talking. As one markdown file: README.md.
想做一条真人口播,又不必自己对着镜头念稿。
视频介绍(B 站):我开源了一个AI真人口播视频生成软件|本机运行 + AI自动对口型 + 素材 + AI文案 + 配音一键出 MP4
把一段真人出镜的视频放进来(脸清楚就行,不用说话),写好要说的话,选一套字幕样子。本机先找火山引擎或阿里百炼配音,再把这段真人和配音交给百炼 VideoRetalk 对上口型,最后用 FFmpeg 合成一条竖屏 MP4。中间某几句想换画面,可以把视频素材整屏切进去。
密钥只留在你的浏览器里;任务和成片写在本机 data/。没有云端服务器,也不会替你去调任何接口。这也不是抖音、字节跳动、火山引擎、阿里云或 DeepSeek 的官方产品。
由 yizhi-chengzi 开源。仓库:github.com/yizhi-chengzi/video-ai-talking
工作台:左侧口播真人视频和视频素材,中间配音、BGM 和文案,右侧选皮肤并预览。

生成完成后,历史成片在「成片库」里预览、下载或删除。

截图里的出镜和画面来自免费可商用素材库(如 Pexels),只用来演示界面,不是本工具的真实用户,也不代表出镜人代言本项目。仓库自带的口播试用片及来源见 demos/README.md,截图说明见 docs/screenshots/README.md。
| 用途 | 申请什么 | 去哪里申请 | 是否必填 |
|---|---|---|---|
| 对口型 | 阿里百炼 VideoRetalk 的 API Key(华北2 / 北京地域,以 sk- 开头) |
产品介绍 · 密钥管理 | 出片必填,填到「AI口播对口型配置」 |
| 配音(百炼) | 阿里百炼 CosyVoice 的 API Key(以 sk- 开头) |
产品介绍 · 密钥管理 | 配音两家选一家即可。填到「AI配音配置」 |
| 配音(火山) | 火山引擎语音合成的 App ID 和 Access Token | 产品介绍 · 控制台申请 | 配音两家选一家即可。填到「AI配音配置」 |
| 文案 | DeepSeek API Key(以 sk- 开头) |
开放平台 · 创建 API Key | 可选。不填也可以手写口播文案 |
百炼的配音 Key 和对口型 Key 分开填:可以用同一把,也可以用另一把。出片时在配音区选择用火山还是百炼。
本机还需要能访问你实际用到的接口:
https://dashscope.aliyuncs.com(配音、临时上传、VideoRetalk)https://openspeech.bytedance.comhttps://api.deepseek.comLinux 上若要用系统文件选择器,请先安装 Zenity(常见桌面环境一般已有)。没有的话,可以把文件从文件管理器拖进页面。
git clone https://github.com/yizhi-chengzi/video-ai-talking.git
cd video-ai-talking
cp .env.example .env
npm install
npm run dev
浏览器打开 http://127.0.0.1:5175。这是日常开发 / 本机使用的方式。
已经构建过、只想起一个本机服务时:
npm run build
npm start
然后打开 http://127.0.0.1:8789。页面和 API 都由这个地址提供。没先 build 的话,打开页面会是 404。
.env 只放端口,不要把 API Key 或 TTS Token 写进去。本地验证可以设 VAT_MOCK=1,配音 / 上传 / 对口型 / FFmpeg / DeepSeek 全部走 mock,不访问外网。
| 位置 | 内容 |
|---|---|
浏览器 localStorage 的 vat.config |
你填的 Key 和 TTS 凭证 |
项目下的 data/ |
任务 JSON、配音音频、对口型中间片、成片 MP4;引用素材只记路径 |
任务 JSON 里不会保存 API Key 或 TTS Token。
关掉页面或停掉本机服务后,正在跑的任务会停。下次打开不会自动续跑。
出片时,参考视频和配音会被上传到阿里百炼官方临时存储(oss://,约 48 小时),供 VideoRetalk 使用。详见 docs/privacy.md。
提示找不到 ffmpeg
先在终端执行 ffmpeg -version 和 ffprobe -version。macOS 可用 brew install ffmpeg。
对口型失败
确认已在「AI口播对口型配置」填写百炼 VideoRetalk API Key,本机可访问 dashscope.aliyuncs.com,参考视频是带人脸的近景片段。
TTS 测试失败
核对当前选用的那一家凭证,以及本机能否访问对应域名。火山要核对 App ID 与 Access Token 是否来自同一语音合成应用。
画面没有中文标题
FFmpeg 需要本机有可用中文字体。工具会按常见路径查找;找不到时成片仍会生成,但标题 / 字幕可能是方框。说明见 templates/fonts.md。
Linux 点「选择文件」没反应
确认已安装 zenity,或改用拖入文件。
npm test
npm run typecheck
测试默认不调用真实 DeepSeek / 火山 / 百炼接口,也不跑完整 VideoRetalk,不要求本机已安装 FFmpeg。
不要从本目录 import 其他产品源码,也不要把本机 data/、密钥或人脸素材提交上去。
使用前请阅读 DISCLAIMER.md、SECURITY.md、docs/privacy.md。贡献见 CONTRIBUTING.md。参与时请遵守 CODE_OF_CONDUCT.md。