%20(1).png)
ComfyUI-APISR 插件保姆级教程
1. 插件简介
插件地址： https://github.com/ZHO-ZHO-ZHO/ComfyUI-APISR
这个插件是专门为动漫图片和视频设计的"放大镜"！就像你用放大镜看蚂蚁一样，它能把小小的动漫图片变得又大又清晰。
主要功能：
- 把动漫图片放大2倍或4倍，而且不会变模糊
- 也能处理动漫视频，让每一帧都变得超清晰
- 速度很快，效果很棒
- 支持电脑显卡和普通电脑处理器两种工作方式
能带来什么效果：
- 小图变大图：256x256的图片能变成1024x1024
- 模糊变清晰：让动漫人物的线条更加锐利
- 视频升级：让动漫视频从标清变成高清
2. 如何安装
方法一：使用管理器安装（推荐）
- 打开 ComfyUI Manager（就像手机的应用商店）
- 搜索 "APISR"
- 点击安装，等待完成
方法二：手动安装
- 打开终端（就像电脑的命令行窗口）
- 进入 ComfyUI 的插件文件夹：
cd custom_nodes - 下载插件：
git clone https://github.com/ZHO-ZHO-ZHO/ComfyUI-APISR - 进入插件文件夹：
cd custom_nodes/ComfyUI-APISR - 安装依赖：
pip install -r requirements.txt - 重启 ComfyUI
下载模型文件
你还需要下载两个"大脑"文件（模型），放到指定位置：
下载后放到：/ComfyUI/models/apisr 文件夹里
3. 节点详解
3.1 APISR ModelLoader（模型加载器）
这个节点就像一个"工具箱管理员"，负责准备好放大图片用的工具。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| apisr_model | apisr_model | 下拉选择 | 根据需要选择 | 选择用哪个"放大镜"，就像选择用2倍还是4倍的望远镜 | 选择预训练的超分辨率模型文件 | 想要2倍放大选"2x_APISR_RRDB_GAN_generator.pth"，想要4倍放大选"4x_APISR_GRL_GAN_generator.pth" |
输出：
- pipe：准备好的"放大工具"，给后面的节点使用
3.2 APISR（批量放大器）
这个节点就像一个"批量复印机"，能同时处理很多张图片或视频的所有帧。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| pipe | pipe | 连接线 | 必须连接 | 接收"工具箱"，就像插上电源线才能工作 | 接收模型加载器输出的模型实例 | 从ModelLoader节点连一条线过来 |
| image | image | 连接线 | 必须连接 | 要放大的图片，就像要复印的原稿 | 输入的图像张量数据 | 从图片加载节点或其他图像处理节点连线 |
| crop_for_4x | crop_for_4x | True/False | True | 是否要"修剪边缘"，让图片尺寸符合4的倍数，就像裁纸要整齐 | 是否裁剪图像使其尺寸为4的倍数 | 一般保持True，这样处理效果更好 |
| dtype | dtype | float32/float16 | float32 | 选择"计算精度"，就像选择用普通计算器还是科学计算器 | 数据类型精度选择 | 显存大选float32（更精确），显存小选float16（省内存） |
输出：
- IMAGE：放大后的图片
3.3 APISR Lterative（逐张放大器）
这个节点就像一个"单张复印机"，一张一张地处理图片，适合电脑配置不高的用户。
参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| pipe | pipe | 连接线 | 必须连接 | 接收"工具箱"，就像插上电源线才能工作 | 接收模型加载器输出的模型实例 | 从ModelLoader节点连一条线过来 |
| image | image | 连接线 | 必须连接 | 要放大的图片，就像要复印的原稿 | 输入的图像张量数据 | 从图片加载节点或其他图像处理节点连线 |
| crop_for_4x | crop_for_4x | True/False | True | 是否要"修剪边缘"，让图片尺寸符合4的倍数，就像裁纸要整齐 | 是否裁剪图像使其尺寸为4的倍数 | 一般保持True，这样处理效果更好 |
| dtype | dtype | float32/float16 | float32 | 选择"计算精度"，就像选择用普通计算器还是科学计算器 | 数据类型精度选择 | 显存大选float32（更精确），显存小选float16（省内存） |
输出：
- IMAGE：放大后的图片
4. 使用技巧和建议
选择合适的节点
- 显存充足（8GB以上）：用 APISR 批量处理，速度更快
- 显存不足（4GB以下）：用 APISR Lterative 逐张处理，虽然慢但不会卡死
模型选择建议
- 2倍放大：适合轻微提升画质，速度快
- 4倍放大：适合大幅提升分辨率，效果明显但耗时更长
参数设置技巧
- crop_for_4x：建议保持True，这样能避免边缘出现奇怪的效果
- dtype：
- 有好显卡选float32，画质更好
- 显卡一般选float16，省内存防止崩溃
工作流搭建
- 先放置 APISR ModelLoader 节点
- 选择合适的模型文件
- 添加图片输入节点
- 连接到 APISR 或 APISR Lterative 节点
- 最后连接图片输出节点
5. 常见问题解答
Q1: 为什么提示找不到模型文件？
A: 检查是否已经下载模型文件并放到正确位置（/ComfyUI/models/apisr文件夹）
Q2: 处理时显存不够怎么办？
A:
- 使用 APISR Lterative 节点代替 APISR 节点
- 将 dtype 改为 float16
- 减小输入图片尺寸
Q3: 处理视频时出现问题？
A:
- 视频帧数多时建议用 Lterative 模式
- 配合 Video Helper Suite 插件使用
- 可能需要用 Split Image with Alpha 节点去除透明通道
Q4: 2倍和4倍模型有什么区别？
A:
- 2倍模型：文件小，速度快，适合轻微提升
- 4倍模型：文件大，速度慢，但放大效果更明显
Q5: 为什么处理后的图片有黑边？
A: 可能是 crop_for_4x 参数的影响，可以尝试关闭这个选项
6. 进阶使用技巧
批量处理大量图片
- 使用 Load Images 节点加载多张图片
- 连接到 APISR Lterative 节点（推荐）
- 设置合适的输出路径
与其他插件配合
- ControlNet：先用APISR放大，再用ControlNet调整细节
- Video Helper Suite：处理视频文件的最佳搭档
- Image Resize：放大前可以先调整尺寸
性能优化
- 关闭其他占用显存的程序
- 适当降低输入图片分辨率
- 使用SSD硬盘提高读写速度
7. 总结
APISR 插件是专门为动漫内容设计的超分辨率工具，具有以下特点：
优点：
- 专门针对动漫优化，效果出色
- 支持图片和视频处理
- 提供两种处理模式适应不同配置
- 速度相对较快
适用场景：
- 动漫图片放大
- 动漫视频画质提升
- 老动画修复
- 低分辨率动漫素材处理
注意事项：
- 需要下载对应的模型文件
- 显存要求较高（建议4GB以上）
- 主要适用于动漫风格内容
希望这份教程能帮助你更好地使用 APISR 插件，让你的动漫图片和视频都变得更加清晰美丽！