Video2X 使用手册：把模糊老视频放大到 4K、把 30 帧补成 60 帧，一次讲透

Video2X 使用手册：把模糊老视频放大到 4K、把 30 帧补成 60 帧，一次讲透

【免费下载链接】video2xA machine learning-based video super resolution and frame interpolation framework. Est. Hack the Valley II, 2018.项目地址: https://gitcode.com/GitHub_Trending/vi/video2x

如果你的硬盘里躺着几段"扔了可惜、看了难受"的老视频——480p 的家庭录像放大就糊、动漫老番线条发虚、想做的慢动作画面卡成幻灯片——那么 Video2X 就是为你准备的免费救星。这是一个基于机器学习的开源视频放大与补帧框架，诞生于 2018 年的黑客松，6.0 版本用 C/C++ 彻底重写后，速度快、画质好，而且全程不需要额外磁盘空间。本文不绕弯子，直接从"最快跑通"讲到"怎么调出好效果"，每一节都给你能直接抄的命令。

先花 30 秒，让第一帧跑起来

与其先听一堆原理，不如先亲眼看到效果。安装好 Video2X 后，打开终端输入下面这行，确认你的显卡能被识别：

video2x --list-devices

看到类似0. NVIDIA RTX ...的输出就说明环境没问题。接着复制这条最简单的命令：

video2x -i input.mp4 -o output.mp4 -p realesrgan -s 4

各参数含义：-i指定输入文件，-o指定输出文件，-p选择处理器（这里是 realesrgan），-s 4表示把画面放大 4 倍。运行后你会看到进度条实时滚动，帧数、速度、剩余时间一目了然；按空格键可以暂停或继续，按q能体面地中途退出，处理完的文件不会丢。

到这里你已经成功了九成，剩下的都是"如何做得更好"。

四个处理器，本质是四把不同的工具

Video2X 的核心概念叫"处理器"（processor），用-p参数指定。记住一句话：工具没有好坏，只有合不合适。判断标准不是参数表，而是你手里素材的画面类型：

• 画面是动漫、追求速度：优先libplacebo，它走 GLSL 着色器路线，默认内置 Anime4K v4 系列七款着色器，实时处理非常快；
• 画面是动漫、追求质量：realcugan，专为动漫训练，还提供三档降噪强度可选，细节保留更好；
• 画面是真人实拍、自然场景：realesrgan，通用型神经网络，泛化能力最强，也是默认最容易出好效果的选择；
• 想提升帧率、做慢动作：rife，帧插值专用，能在两帧之间凭空生成中间帧。

一句话选型：动漫看 realcugan 和 libplacebo，实拍看 realesrgan，补帧只用 rife。所有模型文件都躺在项目的models/目录下，随时可以翻看有哪些可选。

场景一：修复老动漫，让线条重新清晰

老动漫最常见的痛点是线条发虚、噪点明显。此时先上realcugan，它的模型家族按"要不要降噪"分成三档：

命令示例：

video2x -i old_anime.mp4 -o hd_anime.mp4 -p realcugan -s 3 --realcugan-model models-pro

源画面噪点多就选带降噪的模型，源本来就干净反而该选无降噪版，别让 AI 把原本清晰的细节也"磨"掉了。如果想追求最快的实时放大，可以换 libplacebo 配合 Anime4K，直接指定输出分辨率：

video2x -i input.mp4 -o output.mp4 -p libplacebo -w 3840 -h 2160 --libplacebo-shader anime4k-v4-a+a

这里的-w、-h是输出宽高，--libplacebo-shader选择着色器。Anime4K v4 的 a、b、c 系列分别侧重不同画质取向，默认的anime4k-v4-a就很稳，想更强可以用a+a。

场景二：做丝滑慢动作，先补帧再减速

想做出流畅的慢动作，最忌讳直接放慢原视频——30fps 放慢 4 倍就只剩 7.5fps，卡得没法看。正确顺序是先补帧、再减速：把 30fps 素材补到 120fps，再用剪辑软件放慢 4 倍，得到的就是顺滑的 30fps 慢动作。

补帧命令很简单：

video2x -i input.mp4 -o output.mp4 -p rife -m 2

-m是帧率倍数，2 就是翻倍（30→60fps），最大可以设到 4。RIFE 在models/rife/下提供了从rife-v2到rife-v4.26的十几个版本，默认rife-v4.26综合表现稳定；追求极限画质用rife-v4.6，超高清素材还有rife-HD、rife-UHD可选，用--rife-model指定。

这里有个必调的旋钮：补帧最怕镜头硬切——两帧画面完全不同，硬插出来的中间帧会出现鬼影。-t参数就是场景检测阈值（默认 100，范围 0-100），把它调到 20 左右，画面差异超过 20% 就会被判定为场景切换并跳过插帧：

video2x -i input.mp4 -o output.mp4 -p rife -m 2 -t 20

镜头快速平移、人物复杂运动的片段对补帧考验极大，第一次跑建议先用一小段测试视频调参，确认没有明显鬼影再整片处理。

场景三：没有好显卡，照样能用

没有独立显卡完全不等于告别 Video2X。两条现成的路：

用 Docker 容器。项目发布了现成镜像，一条命令就能起服务（以 NVIDIA 显卡为例，需先装好容器工具包）：

docker run --gpus all -it --rm -v $PWD/data:/host ghcr.io/k4yt3x/video2x:$TAG -i standard-test.mp4 -o output.mp4 -p realesrgan -s 4 --realesrgan-model realesr-animevideov3

把$TAG换成具体版本号，-v挂载你的素材目录，命令参数和本地运行完全一致。

用 Google Colab 白嫖云端 GPU。项目官方提供了 Colab Notebook，可以免费借用 NVIDIA T4、L4 甚至 A100 跑任务，单次会话最长 12 小时。记得公平使用免费资源，别开一堆会话 24 小时连续跑，以免被限制。

另外，跑大素材前建议先测速：加-b参数进入基准测试模式，它只处理不写盘，输出平均处理帧率，帮你估算整段视频的耗时，再决定参数怎么调。

一条命令拆开看：这些参数分别管什么

当你对效果不满意时，真正值得调的就下面几个：

放大完成不等于万事大吉，编码质量同样决定观感。用-e透传 FFmpeg 编码器参数，比如追求极致画质可以写：

video2x -i input.mkv -o output.mkv -p realesrgan --realesrgan-model realesrgan-plus -s 4 -c libx264rgb -e crf=17 -e preset=veryslow -e tune=film

CRF 数值越低画质越好（文件也越大），preset=veryslow用更慢的编码换取更高压缩效率。完整的编码器选项说明见官方文档docs/book/src/running/command-line.md。

最容易踩的四个坑，提前避开

把高频翻车点集中说一遍，遇到问题直接对号入座：

• 报 Vulkan 相关错误：先更新显卡驱动到支持 Vulkan 的版本，再看显卡型号是否达标。最低要求是 NVIDIA Kepler（GTX 600 系）、AMD GCN 1.0（HD 7000 系）、Intel HD 4000 及以上的 GPU；
• 程序启动就崩：预编译版本要求 CPU 支持 AVX2 指令集，Intel 需 Haswell（2013 年）及以后，AMD 需 Excavator（2015 年）及以后，老机器先确认这一点；
• 补帧出现鬼影：多半是没开场景检测或阈值太高，把-t调到 20 左右重跑；
• 处理大素材内存吃紧：显存小的先拿小分辨率素材试水，别一上来就啃 4K；长视频先分段处理，降低单次内存峰值。

值得一提的是，Video2X 的 6.0 架构把帧始终保留在内存中流转，不会像老版本那样把每一帧先落盘再读回——所以你只需预留最终输出文件的空间，不必担心中间过程吃掉大量磁盘。

想再深入一层？三条路任你选

• 自定义着色器：libplacebo 支持加载任意兼容 MPV 的 GLSL 着色器文件，把--libplacebo-shader直接指向你的.glsl文件路径即可，会写 GLSL 的朋友完全可以自造滤镜；
• 多显卡并行：--list-devices查看设备编号后，用-d 1指定用哪张卡，多卡机器可以给不同任务分配不同 GPU；
• 读源码学原理：核心逻辑都在src/目录——decoder.cpp管解码、encoder.cpp管编码、filter_realcugan.cpp和filter_realesrgan.cpp是 AI 滤镜、interpolator_rife.cpp负责插帧，模块划分非常清晰，想二开或入门 AI 视频处理可以直接读；想编译最新代码，用git clone https://gitcode.com/GitHub_Trending/vi/video2x拉取仓库，构建说明见docs/book/src/building/。

现在就去翻出你最想修复的那段视频

从 30 秒快速体验，到认识四把工具、按场景跑通放大与补帧、再逐个调优参数——你现在已经掌握了 Video2X 最核心的完整用法。剩下的就是动手：找一段你最想修复的视频，先跑一遍realesrgan -s 4看看画质提升，再对运动画面多的片段试试rife -m 2 -t 20的补帧效果，把"480p 变 1080p"和"卡顿变丝滑"两个惊喜亲眼验证一遍。遇到文档没覆盖的坑，项目的docs/book/src/目录下有完整的安装、运行、构建说明，也欢迎在项目页面提交 Issue 分享你的踩坑经验。现在就打开终端，让老视频重获新生吧！

【免费下载链接】video2xA machine learning-based video super resolution and frame interpolation framework. Est. Hack the Valley II, 2018.项目地址: https://gitcode.com/GitHub_Trending/vi/video2x