用途:解决绿幕素材的色彩解混(color unmixing)问题,包括运动模糊、毛发、失焦边缘等半透明像素,输出直通(未预乘)前景色与干净线性 alpha,面向 VFX 合成流程。
主要能力:逐帧预测真直通前景色和线性 alpha;读取/写入 16 位与 32 位 EXR;每帧需两个输入——RGB 绿幕图(sRGB 或线性 gamma,sRGB/REC709 色域)和粗略黑白 alpha 提示(无需精确,模型基于模糊/腐蚀掩码训练);可选配 GVM、VideoMaMa、BiRefNet 等 alpha 提示生成器。
使用方式:需 uv 包管理器,以及 NVIDIA GPU(CUDA 12.8+ 驱动)或 Apple M1+(MLX)或 CPU。安装示例:uv sync(CPU/Apple MPS)、uv sync --extra cuda、uv sync --extra mlx;模型需下载至 CorridorKeyModule/checkpoints/CorridorKey.pth。常用命令:uv run python main.py run_inference --device cuda|cpu|mps、uv run python main.py list、uv run python main.py wizard。也提供 Docker 与 Docker Compose 运行方式。目录结构约定 ClipsForInference/、Output/、checkpoints 等。
适用场景:影视绿幕抠像、半透明边缘处理、需要 EXR 的合成管线,可接入 Nuke/Fusion/Resolve。
限制与注意:输入需为 sRGB/REC709 色域,勿直接传 log 编码素材;alpha 提示不宜向外膨胀(dilate),应腐蚀(erode);极强绿色溢色可能影响效果,可先做去溢色;GVM 对人物效果较好,道具/物体可尝试 VideoMaMa 加手绘提示;4K 素材建议至少 6–8GB 显存,显存不足可改用 CPU。具体收费、价格、性能数据暂未提供。