Jasna 视频马赛克修复选型指南一张表配齐硬件、许可与模型【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasnaJasna 是一款在本机 GPU 上运行的视频和图片马赛克修复工具它逐帧找出马赛克、只修马赛克区域画面其余部分保持不变。输入支持单个视频、文件夹、VR180 和静态图片。本文面向第一次使用的读者帮你确认硬件与许可、选对模型、写出能直接跑的命令。速览每个场景的最小命令先给答案。下面每行都可在命令行整行复制GUI 用户对应操作见各章「参数入口」你的场景模型组合最小命令日常批量 1080pNVIDIA / AMD 均可rfdetr-v6 BasicVSR全默认jasna --input in.mp4 --output out.mkv4K 素材想少漏检rfdetr-v6-large BasicVSRjasna --input in.mp4 --output out.mkv --detection-model rfdetr-v6-largeAMD 显卡检测优先速度lada-yolo-v4 BasicVSRjasna --input in.mp4 --output out.mkv --detection-model lada-yolo-v4重点视频精修需许可LTX 标准画质jasna --input in.mp4 --output out.mkv --restoration-model-name ltx还不知道 LTX 在自己机器上要多久LTX 试用模式免费、不修视频jasna --input in.mp4 --output out.mkv --restoration-model-name ltx --ltx-trial长视频省时间只让 LTX 修大马赛克LTX BasicVSR 分流jasna --input in.mp4 --output out.mkv --restoration-model-name ltx --ltx-auto-split 124K / 特写结果偏糊BasicVSR RTX Super Res免费jasna --input in.mp4 --output out.mkv --secondary-restoration rtx-super-resVR180 左右并排视频rfdetr-vr-v1 BasicVSRjasna --input in.mp4 --output out.mp4 --detection-model rfdetr-vr-v1静态图片自动走 SD 1.5sd-15-jav需许可jasna --input photo.png --output restored.png动手之前先核对硬件与许可 ⚠️Jasna 能跑起来的基础门槛NVIDIAGTX 16 系列 / RTX 20 系列或更新计算能力 ≥ 7.5用较新驱动Windows 610 / Linux 580。AMDRadeon RX 7000/9000实验性Linux 需先装一次 AMD AMF 运行库Windows 需 Adrenalin 26.8.1。装在有SSD的本地磁盘上网络盘不支持安装路径不能含中文、日文等非英文字符。功能面、显存与授权门槛合并成一张表授权按美元累计支持额计算一个许可证码可同时覆盖 3 台电脑功能授权显卡门槛显存 / 其他全部检测模型免费所有受支持 GPU权重放进model_weights/即自动识别BasicVSR 主修复免费所有受支持 GPU4–6 GB 显卡建议把最大片段降到 30LTX 主修复25 美元档或先跑免费试用RTX 30/40/50仅 RTX 2080 Ti 实测过Linux 另支持 AMD RX 7000/9000Windows 上的 AMD LTX 为测试版显存 ≥ 8 GB、内存 ≥ 16 GB首次下载约 9–28 GBUNet 4x 二次修复15 美元档起仅 NVIDIA—RTX Super Res 二次修复免费仅 NVIDIA—TVAI 二次修复另购 Topaz Video仅 Windows仅 NVIDIA Windows—SD 1.5 图片修复15 美元档起所有受支持 GPU约 7 GB 显存模型约 6.9 GB不满足门槛的替代路线没有 8 GB 显存的 NVIDIA 卡或想用 AMD——主修复只走 BasicVSR想要更锐利就叠免费的--secondary-restoration rtx-super-resNVIDIA没有许可证——走「检测 BasicVSR RTX Super Res」全免费路线LTX 和 SD 1.5 暂时跳过。日常视频批量快修默认 BasicVSR适用对象手里有一批 1080p 或普通视频目标是尽快修完、不想折腾设置。选择理由BasicVSR 是默认主修复模型速度快、免费、所有受支持的 GPU 都能跑默认检测模型rfdetr-v6覆盖大多数视频输入分辨率 576。检测权重按显卡自动匹配格式NVIDIA 用 ONNX 导出、AMD 用.pt见 detection_registry.py不需要手动配置。配置步骤什么都不改直接跑jasna --input in.mp4 --output out.mkv参数入口GUI 的基本处理区可改检测阈值CLI 用--detection-score-threshold取值 0–1漏检调低、误检调高。检测模型切换用--detection-model或在区间编辑器里给不同视频分别指定。首次任务会花 15–60 分钟为 GPU 编译模型结果存进model_weights之后任务直接复用。检测模型怎么选不确定就用rfdetr-v6本节可跳过rfdetr-v6默认内置速度快适合大多数视频。rfdetr-v6-large检测更准、更慢适合 4K需单独下载后放进model_weights/。rfdetr-vr-v1内置VR180 最适配。zelefans-vr-yolo-v2单独下载另一个 VR180 方案。lada-yolo-v4内置YOLO 后端AMD 上比 RF-DETR 系更快2D 动画上也可能更好。重点视频高质量精修LTX 先试速再正式适用对象有 25 美元档许可证、NVIDIA 显存 ≥ 8 GB、内存 ≥ 16 GB且这一条视频值得等。选择理由LTX 走扩散模型推理能补出 BasicVSR 给不出的真实细节但慢得多——标准画质下 1 分钟 1080p马赛克持续在画面中大约RTX 5090 约 1 分钟、RTX 5080 约 2 分钟、RTX 4090 约 1.5 分钟、RTX 3090 约 3 分钟、RTX 2080 Ti 约 10 分钟快速模式仅 RTX 505090 不到 1 分钟、5080 约 1.5 分钟。配置步骤# 第一次先测速不下载模型、不需要许可证视频不会被修复 jasna --input in.mp4 --output out.mkv --restoration-model-name ltx --ltx-trial # 测速可接受后再正式跑首次会先询问并下载所选模型约 15 GB jasna --input in.mp4 --output out.mkv --restoration-model-name ltx进度条分四步查找马赛克、准备、修复、保存。在你的 GPU 上第一次及每次更新后第一次会先做一次简短速度测试之后剩余时间估算就是准的。LTX 支持暂停/继续中断后重跑同一条命令即可续上。画质档位CLI 取值不同见 session_config.py 与 docs/zh/models.md画质CLI 取值相对速度标准默认ltx基准良好ltx-4step慢约 1.5 倍高画质ltx-8step慢约 2.5 倍顶级ltx-undistilled慢约 5 倍通常不值得参数入口GUI修复模型区可切换档位、种子与开关CLI 侧开关包括--ltx-fast快约 1.4 倍仅限 RTX 50其他卡会报错、--ltx-large-canvas大马赛克细节更多约需 12 GB 空闲显存长视频里这类部分慢约 3 倍显存不够会自动回退普通方式画布常量见 plan.py、--ltx-seed默认20260923同种子同结果、--no-experimental-ltx-less-overlap回到重叠更多的旧模式默认开启的减重叠模式约快 13%。想只让大马赛克走 LTX、其余交给更快的 BasicVSR加--ltx-auto-split 12数字 马赛克占视频高度的百分比推荐 12可与--segments、--fmp4同用时报错。跑 LTX 前关掉游戏和浏览器。4K 或特写结果偏糊开启二次修复适用对象用 BasicVSR 修完、但把小马赛克放回 4K 或人物特写后仍显模糊显卡是 NVIDIA。选择理由主修复输出的是一张 256×256 的小图二次修复先把它放大到 512×512 或 1024×1024 再放回画面。注意用 LTX 时二次修复不会生效CLI 同时给会直接报错。配置步骤jasna --input in.mp4 --output out.mkv --secondary-restoration rtx-super-res三个选项的定位选项授权特点rtx-super-res免费非常快部分视频会闪烁先用短片段验证unet-4x15 美元档起质量接近 TVAIiris-2且更快256 进 1024 出见 unet4x_secondary_restorer.pytvai另购 Topaz Video仅 Windows质量相近但很慢指定iris-2模型实测开销两条 1080p 视频耗时 / 显存无二次修复 22s / 10.0 GB 与 11s / 10.7 GBRTX Super Res 25s / 11.7 GB 与 13s / 11.4 GBUNet 4x 29s / 12.5 GB 与 14s / 12.6 GBTVAI 52s / 12.1 GB 与 24s / 12.4 GB。参数入口RTX Super Res 侧有--rtx-quality、--rtx-denoise、--rtx-deblur、--rtx-scaleTVAI 侧需先把环境变量TVAI_MODEL_DATA_DIR与TVAI_MODEL_DIR指向 Topaz Video 的模型文件夹未设置会直接报错见 tvai_secondary_restorer.py再配--tvai-model默认iris-2、--tvai-scale默认 4、--tvai-workers默认 2。静态图片修复SD 1.5 自动路由适用对象要修的是图片而不是视频持有 15 美元档以上许可显存约 7 GB4K 大图再多一点。选择理由图片输入会自动路由到 SD 1.5sd-15-jav路径视频修复那套参数不生效不用额外设置。该模型是实验性的不同图片效果差别大正确姿势是多生成几版留最好的。配置步骤jasna --input photo.png --output restored.png --sd15-variants 4--sd15-variants 4会保存name_v1…name_v4四个版本种子依次为seed…seed3。模型约 6.9 GB 不随包附带首次运行先询问、再下载到model_weights/sd-15-jav/见 sd15_download.py。参数入口--sd15-steps、--sd15-strength、--sd15-freeu、--sd15-seed均收进下文「参数速查」不再展开。GUI 里想逐张试种子用交互式处理图片功能。VR180 左右并排视频rfdetr-vr-v1 配 BasicVSR适用对象VR180左眼右眼并排在一个宽画面里素材。选择理由Jasna 会把 SBS 画面拆开、分别修复每只眼再拼回并按片商选择马赛克展平方式原始 / 鱼眼 / 球心投影。注意左右并排格式不支持 LTX——选 LTX 会收到「请用 BasicVSR 修复」的报错见 vr180.py所以这一路主修复固定是 BasicVSR。配置步骤jasna --input in.mp4 --output out.mp4 --detection-model rfdetr-vr-v1VR 模式保持autoJasna 按 2:1 超宽帧、VR 元数据和片商名自动识别自动模式认不出时用--vr-mode sbs强制按 VR 处理需要鱼眼展平用sbs-fisheye。参数入口区间编辑器的修复预览旁有VR 投影菜单可逐个试「自动 / 原始 / 鱼眼 / 球心投影」确认后点应用最终任务会沿用该选择。检测阈值方面rfdetr-vr-v1推荐值 0.40。参数速查所有可调参数一张表参数默认什么时候动它调整方式--detection-modelrfdetr-v64K 换 large、VR 换 vr-v1、AMD 求快换lada-yolo-v4CLI或 GUI 检测下拉框权重放进model_weights/自动识别--detection-score-threshold按模型推荐0.35 / 0.40 / 0.25漏检马赛克调低正常区域被误检调高CLI0–1或 GUI 基本处理 → 检测阈值--restoration-model-namebasicvsrpp精修换ltx及三档画质CLI或 GUI 修复模型区--ltx-fast关RTX 50 系列想快约 1.4 倍其他卡会报错勿加--ltx-large-canvas关特写 / 4K 大马赛克要更多细节约 12 GB 空闲显存不够自动回退--experimental-ltx-less-overlap开想回到重叠更多的旧模式加--no-前缀关闭--ltx-seed20260923想复现或微调结果同种子同结果--ltx-trial关买许可前先测速视频不会被修复--ltx-auto-split无长视频只让 LTX 修大马赛克百分比推荐12--max-clip-size90显存不足就降90→60→30CLI或 GUI片段越大越稳且越快--temporal-overlap8拼接处闪烁8–20须小于--max-clip-size一半--denoisenone修复区域有噪点low/medium/high与 LTX 互斥--secondary-restorationnone4K / 特写偏糊rtx-super-res/unet-4x/tvai--rtx-scale/--rtx-quality/--rtx-denoise/--rtx-deblur4/high/medium/none微调 RTX Super Res 观感仅--secondary-restoration rtx-super-res时有效--tvai-model/--tvai-scale/--tvai-workersiris-2/4/2微调 TVAI先配好两个TVAI_*环境变量--vr-modeauto自动模式认不出 VR 或想强制auto/sbs/sbs-fisheye--codec/--cqhevc/ 按 GPU改输出体积与兼容性hevc/h264/av1CQ 越低越糊越少--sd15-steps25想要更多细节、能接受更慢只用于图片--sd15-strength0.6上限 0.7马赛克更重越高越不像原图--sd15-freeu开出现生硬边缘时关闭默认开启让形状更清晰--sd15-seed/--sd15-variants0/1复现结果 / 多存几版挑最好图片完整清单以 docs/zh/cli.md 为准jasna --help可随时查看。故障手册常见失败怎么处理症状原因处理第一个任务要等 15–60 分钟NVIDIA 上首次为 GPU 编译检测 / 修复模型TensorRT等它完成结果存在model_weights升级到新版时把该文件夹拷过去就不用再等LTX 任务启动即报错与--stream、--secondary-restoration、--denoise同时使用三选一去掉LTX 路线下二次修复和降噪都不可用VR180 SBS 选 LTX 被拒LTX 不支持左右并排换basicvsrpp重跑Windows 上 LTX「拒绝访问」Windhawk 注入干扰退出 Windhawk或把jasna.exe加入它的排除进程列表用 ESET 时 LTX 起不来提示ebehmonl.dll深度行为检查拦截把 Jasna 文件夹加入 ESET DFI 排除项换新版目录后需再加一次显存不够、任务报 OOM--max-clip-size偏大或占卡应用多降到 60 或 304–6 GB 卡从 30 起关掉浏览器游戏必要时关二次修复--ltx-fast报错停止仅 RTX 50 系列支持去掉该参数TVAI 启动即报错TVAI_MODEL_DATA_DIR/TVAI_MODEL_DIR未设置或目录不存在两个变量都指向 Topaz Video 模型文件夹TVAI 之外的二次修复不可用AMD 用户二次修复仅限 NVIDIAAMD 路线放弃二次修复靠检测 BasicVSR 完成LTX 换显卡 / 换驱动后变慢其他应用占用 GPU跑 LTX 前关掉游戏和浏览器 下载失败手动放 LTX 文件应用内下载一直失败时用浏览器从Kruk2/ltx-restore仓库huggingface.co 或其镜像 hf-mirror.com无法访问 Hugging Face 的环境 Jasna 会自动切镜像下载3 个文件你选的那个模型文件 2 个 VAE 文件。文件名保持原样含.enc加密、打开时仍需许可证校验全部放入 Jasna 目录下的model_weights/ltx-restore/没有就新建再重新开始 LTX 任务即不再要求下载。路径约定见 engine_paths.py体积与校验和见 model_files.py。你选的档位模型文件标准ltx-restore-alpha1-distill2-int8.safetensors.enc标准 快速模式ltx-restore-alpha1-distill2-nvfp4.safetensors.enc良好ltx-restore-alpha1-distill4-int8.safetensors.enc良好 快速模式ltx-restore-alpha1-distill4-nvfp4.safetensors.enc高画质ltx-restore-alpha1-distill8-int8.safetensors.enc高画质 快速模式ltx-restore-alpha1-distill8-nvfp4.safetensors.enc顶级ltx-restore-alpha1-int8.safetensors.enc顶级 快速模式ltx-restore-alpha1-nvfp4.safetensors.enc所有档位共用vae.safetensors.encvae-decoder.safetensors.enc收尾按身份给一句话建议只想把一批 1080p 修完——全默认就是最优解jasna --input in.mp4 --output out.mkv4K 源一个马赛克都不想漏——检测换 largejasna --input in.mp4 --output out.mkv --detection-model rfdetr-v6-largeAMD 用户速度优先——检测换 YOLO 系jasna --input in.mp4 --output out.mkv --detection-model lada-yolo-v4先弄清 LTX 在自己机器上要多久——跑免费试用jasna --input in.mp4 --output out.mkv --restoration-model-name ltx --ltx-trial有许可、显存够精修重点视频——直接上 LTX 标准档jasna --input in.mp4 --output out.mkv --restoration-model-name ltx长视频只让大马赛克吃 LTX——按高度 12% 分流jasna --input in.mp4 --output out.mkv --restoration-model-name ltx --ltx-auto-split 12BasicVSR 出片在特写上偏糊——叠免费二次修复先用短片段验证闪烁jasna --input in.mp4 --output out.mkv --secondary-restoration rtx-super-res修的是图片——丢进去多生成几版挑最好的jasna --input photo.png --output restored.png --sd15-variants 4【免费下载链接】jasnaVideo restoration tool项目地址: https://gitcode.com/GitHub_Trending/ja/jasna创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考