dsh-tool-lipsync
DSH 免费对口型口语视频生成插件，支持 3000+ 声音和 500+ 语言。
语音音频
READMEdsh-tool-lipsync
免 Key、免登录的 AI 对口型口播视频生成插件，为 DeepSeek Harness (DSH) 注册 5 个工具，使用免费开放 API 生成对口型视频。
3000+ 声音 · 500+ 语言 · 最长 20 秒 · 无水印 · 1-3 分钟出片
功能一览
| 工具 | 作用 |
|---|---|
lipsync_list_voices | 列出预设声音（按语言/关键词筛选） |
lipsync_list_samples | 列出示例人脸/宠物/卡通素材 |
lipsync_generate | 提交对口型口播视频生成任务 |
lipsync_status | 轮询生成状态（5-6 秒/次） |
lipsync_download | 下载成片 MP4 到本地 |
免费层特性
- 无需 API Key、无需登录账号
- 最长 20 秒视频，无水印
- 大多数 1-3 分钟内生成完成
- 支持中文、英文、日文等 500+ 语言预设声音
- 支持自定义人脸图片
安装
方式一：CLI 安装（推荐）
▼bash复制代码# 在 DSH Web profile 中安装 dsh plugin --profile web add github:yu-wenchao/dsh-tool-lipsync
安装后重启 DSH 即可生效。
方式二：一键安装包
- 下载本仓库 Release 中的安装包
- 解压到任意目录
- 双击
安装.bat - 按提示选择安装目录，等待安装完成
- 双击
重启.bat重启 DSH
方式三：手动安装
▼bash复制代码# 克隆仓库 git clone https://github.com/yu-wenchao/dsh-tool-lipsync.git # 安装到 DSH web profile dsh plugin --profile web add ./dsh-tool-lipsync
卸载
▼bash复制代码dsh plugin --profile web remove dsh-tool-lipsync
或使用安装包中的 卸载.bat。
使用示例
在 DSH 对话中输入：
帮我用 FreeLipSync 做一段口播视频，让这个人说"大家好，欢迎收看今天的节目"。先列出中文声音和示例人脸素材，然后生成，完成后下载到工作区。
模型会自动调用：
lipsync_list_voices— 获取中文声音列表lipsync_list_samples— 获取示例人脸素材lipsync_generate— 提交生成任务lipsync_status— 轮询进度lipsync_download— 下载成片
高级用法
▼text复制代码# 指定声音和人脸生成 请用日语女声，配合示例人脸素材，生成一段 15 秒的口播视频，内容是"こんにちは、世界" # 使用自定义人脸 用这张图片作为人脸 https://example.com/face.jpg，配上英文男声说"This is a test" # 批量生成 分别用中文、英文、日文生成三段口播视频，内容都是"欢迎订阅我的频道"
工作原理
▼text复制代码DSH 对话 → lipsync_generate 工具调用 ↓ 提交生成任务到后端 API ↓ 轮询查询生成状态 ↓ 下载成片 MP4 ↓ 保存到本地工作区
- 首次请求自动建立匿名会话
- 所有 API 调用完全开放、无 Key、无登录
- 插件通过 HTTP 代理绕过浏览器限制
技术细节
插件结构
▼text复制代码dsh-tool-lipsync/ ├── package.json # DSH bundle manifest ├── cordis.patch.yml # 向 profile 组合插入本插件 ├── lib/ │ ├── index.js # 插件入口（注册 5 个工具） │ ├── index.d.ts # TypeScript 类型定义 │ └── client.js # Web UI 面板（可选） └── README.md
API 接口
| 接口 | 方法 | 说明 |
|---|---|---|
/api/catalog/voices | GET | 获取声音列表 |
/api/samples | GET | 获取示例素材 |
/api/generate | POST | 提交生成任务 |
/api/status/batch | POST | 批量查询状态 |
/api/download/{id} | GET | 下载成片 |
依赖
- DeepSeek Harness >= 0.1.0-rc.6
- Node.js >= 18
- 网络连接
注意事项
- 免费层输出为低清 preview 版；高清无水印原片需登录/付费
- 本插件依赖第三方免费服务，其免费额度与接口随时可能调整
- 请注意素材/肖像版权
- 后端接口未来可能变动
常见问题
Q: 安装后 DSH 报错 "Failed to load plugins"
A: 重启 DSH 即可。如果仍然报错，检查 DSH 版本是否 >= 0.1.0-rc.6。
Q: 生成的视频在哪里？
A: 默认保存在 DSH 工作区目录下。使用 lipsync_download 工具时可以指定保存路径。
Q: 支持自定义人脸吗？
A: 支持。在 lipsync_generate 工具中传入 faceUrl 参数即可，支持任何公开可访问的图片 URL。
Q: 生成速度慢怎么办？
A: 免费层生成速度取决于服务器负载，通常 1-3 分钟。可以使用 lipsync_status 工具轮询进度。
许可证
MIT License
相关链接
语音音频
