remove-ai-watermarks

环境要求

• uv 包管理器（README 全部用 uv tool install 安装）
• 去除隐形水印需 NVIDIA GPU，仅支持 CUDA，无 CPU/MPS 回退
• 仅用于你自己生成或拥有的内容，不针对第三方付费内容水印
• 视频处理支持 MP4、MOV、M4V、WebM、MKV、AVI、FLV

安装与启动步骤

1. 1安装默认CLI

   用 uv 安装默认版本，只带元数据检查与剥离能力，不需要 GPU。

   uv tool install remove-ai-watermarks

   复制

2. 2检查图像溯源

   对图片运行 identify，查看检测到的可见水印与 C2PA/EXIF 等溯源信息。

   remove-ai-watermarks identify image.png

   复制

3. 3剥离AI元数据

   去掉 C2PA、EXIF、XMP、IPTC 等 AI 元数据；不加 -o 会原地覆盖源图。

   remove-ai-watermarks metadata image.png --remove -o clean.png

   复制

4. 4去除可见水印

   先补装 visible 依赖，再去除 Gemini 星标等已知可见标记，无需 GPU。

   uv tool install --force "remove-ai-watermarks[visible]"
   remove-ai-watermarks visible image.png -o clean.png

   复制

5. 5处理视频元数据

   检查或剥离视频 AI 元数据；省略 -o 时输出 <source>_clean 并保留原文件。

   remove-ai-watermarks video metadata input.mp4 --check
   remove-ai-watermarks video metadata input.mp4 --remove -o clean.mp4

   复制

6. 6视频识别与清理

   装 video 依赖后可识别或清理；video all 去可见水印并剥离元数据，batch 批量处理目录。

   uv tool install --force "remove-ai-watermarks[video]"
   remove-ai-watermarks video identify input.mp4
   remove-ai-watermarks video all input.mp4 -o clean.mp4
   remove-ai-watermarks video batch ./videos --mode all

   复制

7. 7去除隐形水印

   需 NVIDIA GPU，全部 profile 仅 CUDA；对自产图可用 --force 强制处理。

   uv tool install --force "remove-ai-watermarks[qwen-zimage]"
   remove-ai-watermarks invisible image.png -o clean.png

   复制

关键配置

如何确认成功

identify 能正常输出溯源信号；visible 或 metadata 生成的 clean.png 可打开且无报错。

常见问题

注意事项

• 仅对你自己拥有或生成的内容合法使用，不针对图库预览等保护第三方付费内容的水印。
• 安装额外依赖时 README 示例使用 --force 覆盖已有安装，避免旧版本残留。
• video all 默认排除专有隐形视频去除，需显式加 --invisible 才启用有损 SynthID 配置。
• HDR、PQ/HLG 及大于 8bit 的视频输入会在编码前被拒绝，不会静默降为 8bit。