Duix.Avatar 去水印完整指南：5 步解锁无水印口播视频输出

Duix.Avatar 去水印完整指南5 步解锁无水印口播视频输出【免费下载链接】Duix-Avatar Truly open-source AI avatar(digital human) toolkit for offline video generation and digital human cloning.项目地址: https://gitcode.com/GitHub_Trending/he/Duix-Avatar一、你卡住的是视频角落的那块水印数字人口播视频最常卡住人的地方有两个导出的成片角落多了一块水印能看变不能直接用或者你用本地接口搭了自建内容系统同一个模型出的视频有的带水印、有的不带谁也说不出差在哪一环。两类问题的根源是同一个参数watermark_switch它是视频合成服务决定是否往成片里烧录水印的总开关。看懂 Duix.Avatar 无水印功能在项目中如何生效逐字段读懂合成请求里的watermark_switch等参数用 5 步验证你的视频是无水印输出掌握 3 个高频故障的「现象→排查→解决」处理法二、无水印功能定位与原理速览Duix.Avatar 的视频合成分两层桌面客户端负责收集文案、音频和模特本地 Docker 服务face2face 引擎负责真正渲染而水印就是在渲染层加上去的。客户端每提交一次合成任务都会通过watermark_switch告诉引擎加不加水印。核心代码在 src/main/service/video.js这段代码负责组装一次视频合成的请求参数async function makeVideoByF2F(audioPath, videoPath) { const uuid crypto.randomUUID() const param { audio_url: audioPath, // 音频路径本次口播的语音文件 video_url: videoPath, // 视频路径模特形象的视频 code: uuid, // 唯一任务编号供后续查询进度 chaofen: 0, // 口型重叠参数常规保持 0 watermark_switch: 0, // 水印开关0 无水印1 加水印 pn: 1 // 合成任务优先级常规保持 1 } const result await makeVideoApi(param) return { param, result } }参数随后被发到本地服务接口见 src/main/api/f2f.js这段代码只做了最薄的一层转发export function makeVideo(param) { return request.post(${serviceUrl.face2face}/submit, param) }在官方客户端里watermark_switch固定为 0也就是你正常生成的视频本来就是无水印的——这正是开源本地部署的优势不存在免费版/专业版之分去水印无需升级任何订阅。三种常见使用方式的能力差异如下使用方式水印状态控制方式适用场景官方桌面客户端无水印固定 0无需操作客户端自动组装日常口播视频生成自建系统调用本地 API由你决定请求体中watermark_switch传 0 或 1自建内容系统、批量任务第三方封装 / 旧版服务容器视版本可能带水印取决于该版本的请求参数使用前先验证传参三、最小可行路径5 步验证无水印输出这一节的目标是走通打开客户端到确认成片无水印的最短链路全程约 5 分钟不含合成耗时启动本地服务在 deploy/ 目录执行docker-compose up -d等 3 个容器全部 Running。打开 Duix.Avatar 客户端选择一个已训练好的模特形象。输入口播文案或直接上传音频点击生成视频。此时客户端已向合成引擎发出watermark_switch: 0的任务。等待合成完成在我的作品页查看视频预览。导出视频文件用外部播放器检查画面四角与中央确认没有任何水印。整条链路可以概括为客户端首页长这样Create Video 横幅就是口播视频生成入口四、三类使用方式的无水印分场景方案根据你使用 Duix.Avatar 的方式不同去水印要做的事不一样下面三个小节对应三类用户。4.1 官方桌面客户端用户无需配置只需验证官方客户端已把watermark_switch写死为 0设置面板里既没有添加水印的开关也不存在误开启的可能你只需跑通一次生成流程并检查导出文件。若成片仍发现水印先别改客户端参数按第六节的排错流程确认水印是否来自服务端容器。4.2 自建系统用户调用 API 时自行配置参数如果你绕过客户端直接调用本地合成接口http://127.0.0.1:8383/easy/submit服务地址定义在 src/main/config/config.js就需要自己组装请求参数把请求体中的watermark_switch字段置为0即可无水印输出将来想给某些素材加品牌水印把它改成1即可同一套接口无需切换服务。风险提醒只改动你自己系统里的请求参数。服务容器内运行的是第三方开源代码不要修改容器镜像里的源码文件——这类改动可能违反服务条款也大概率在服务升级时被覆盖还原。4.3 离线 / 内网环境用户重点防传参错位全离线环境下客户端与服务在同一台机器接口地址就是本地127.0.0.1不存在连不上的问题真正的风险是参数传给了错误版本如果服务容器升级了而客户端还是旧版本请求参数结构可能不匹配。建议每次升级服务后都做一次验证——生成一条视频并在客户端日志里确认提交请求中的watermark_switch仍是 0。五、进阶与定制读懂合成请求的全部参数如果你要调用 API 自建系统就需要把请求体每个字段的确切含义弄明白视频合成用到的字段全部在下表中参数含义推荐值备注audio_url本次口播的语音文件路径你的实际 .wav 路径需可被服务容器读到video_url模特的形象视频路径你的实际 .mp4 路径需可被服务容器读到code唯一任务编号由crypto.randomUUID()生成查询进度接口复用同一值chaofen口型重叠参数0常规场景保持 0watermark_switch水印开关00 无水印1 加水印pn任务优先级1常规场景保持 1任务提交后用http://127.0.0.1:8383/easy/query?code{任务编号}轮询进度status变为 2 表示合成完成返回的result是结果视频的文件名。一条正常流程从提交任务经过进度 0→100再到拿到结果文件耗时取决于视频长度与显卡性能通常几十秒到几分钟。最终文件落在本地数据目录Windows 为D:\duix_avatar_data\face2face\tempLinux 为~/duix_avatar_data/face2face/temp路径逻辑同样定义在 src/main/config/config.js。六、无水印输出排错与验证高频问题以下三个问题按「现象 → 排查 → 解决」展开覆盖绝大多数以为无水印却不是的场景。6.1 现象导出的视频上仍有水印排查打开客户端右上角 Setting 菜单选择 Open Log 查看提交记录确认请求中watermark_switch的实际取值入口如下图解决日志里是 0 但成片仍有水印说明水印来自服务端容器侧合成引擎不同版本的水印行为此时对照 deploy/ 目录下的 docker-compose 文件确认镜像版本升级服务容器到最新版本后重新生成验证。6.2 现象提交任务直接失败视频没生成排查合成接口默认指向127.0.0.1:8383容器没起来时会立刻出现连接被拒或超时。在 Docker 里确认 3 个服务是否 Running并用nvidia-smi确认显卡驱动正常。解决回到 deploy/ 目录重新执行docker-compose up -d重建服务等容器全部 Running 后再点生成。6.3 现象合成成功但找不到视频文件排查客户端把成片写入本地数据目录而不是下载之类的系统位置去常规位置找会扑空。解决直接到D:\duix_avatar_data\face2face\tempWindows或~/duix_avatar_data/face2face/tempLinux按最新时间戳找 mp4 文件或者用客户端我的作品页的导出入口另存到指定位置更稳妥。七、小结Duix.Avatar 的无水印能力本质就是合成请求里的watermark_switch: 0官方客户端已替你写死自建系统调用 API 时传 0 即可任何疑似带水印的情况都可以从客户端日志的提交参数查起。现在就可以去生成一条视频、逐角检查画面——没有水印验证就完成了。下一篇我们继续以这套本地服务为入口讲chaofen等影响口播视频质量的合成参数怎么调。【免费下载链接】Duix-Avatar Truly open-source AI avatar(digital human) toolkit for offline video generation and digital human cloning.项目地址: https://gitcode.com/GitHub_Trending/he/Duix-Avatar创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考