%20(1).png)
ComfyUI-UltraPixel 插件完全教程
1. 插件简介
插件地址： https://github.com/2kpr/ComfyUI-UltraPixel
这个插件是什么呢？简单来说，它就像是给ComfyUI装了一个"超级画家"！UltraPixel是一个非常厉害的AI绘画技术，能够生成超高分辨率的精美图片。你可以把它想象成一个拥有超能力的画师，不仅能画出普通的图片，还能画出超级清晰、细节丰富的大尺寸作品。
能给我们带来什么效果？
- 🎨 超高分辨率绘画：能生成2048x2048甚至更大尺寸的高清图片，比普通AI画得更清晰
- 🖼️ 文字转图片：输入文字描述，就能画出对应的精美图片
- 🎯 控制网络支持：可以用参考图片来控制生成图片的构图和姿态
- ⚡ 多阶段生成：像专业画家一样，先画草图，再加细节，最后精修
- 🎭 高质量输出：生成的图片质量非常高，细节丰富，色彩鲜艳
想象一下：你只需要输入"一个美丽的花园里有个穿红裙子的女孩"，这个插件就能为你画出一幅超高清、细节丰富的艺术作品，就像请了世界顶级画家为你作画一样！
2. 如何安装
方法一：手动安装（推荐）
- 打开你的ComfyUI安装目录
- 进入
custom_nodes文件夹 - 在这里打开命令行（终端）
- 输入以下命令：
git clone https://github.com/2kpr/ComfyUI-UltraPixel.git
cd ComfyUI-UltraPixel
pip install -r requirements.txt
方法二：ComfyUI Manager安装
- 在ComfyUI界面中点击"Manager"按钮
- 搜索"UltraPixel"
- 点击安装即可
重要提醒：
- 安装完成后需要重启ComfyUI
- 第一次使用时会自动下载模型文件（约几个GB），请耐心等待
- 建议显存至少10GB以上，16GB更佳
- 支持的最大分辨率取决于显存大小：
- 10GB显存：最大2048x2048
- 12GB显存：最大3072x3072
- 16GB显存：最大4096x4096
3. 节点详细解析
3.1 UltraPixel Load 节点 - 模型加载器
这个节点是干嘛的？
这就像是一个"工具箱管理员"！它负责加载UltraPixel需要的所有AI模型文件。你可以把它想象成一个专业画家的工具箱，里面装着各种不同的画笔、颜料和工具，每个都有特定的用途。这个节点会自动帮你准备好所有需要的"绘画工具"。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| ultrapixel | ultrapixel | 模型文件名 | ultrapixel_t2i.safetensors | 这是"主画师大脑"，负责理解文字并生成图片 | UltraPixel主模型文件 | 选择默认的ultrapixel_t2i.safetensors |
| stage_a | stage_a | 模型文件名 | stage_a.safetensors | 这是"最终修饰师"，负责把图片变得更清晰 | Stage A解码器模型 | 使用默认的stage_a.safetensors |
| stage_b | stage_b | 模型文件名 | stage_b_lite_bf16.safetensors | 这是"中级画师"，负责添加中等细节 | Stage B生成器模型 | 使用默认的stage_b_lite_bf16.safetensors |
| stage_c | stage_c | 模型文件名 | stage_c_bf16.safetensors | 这是"草图画师"，负责画出基本构图 | Stage C生成器模型 | 使用默认的stage_c_bf16.safetensors |
| effnet | effnet | 模型文件名 | effnet_encoder.safetensors | 这是"特征识别师"，负责理解图片特征 | EfficientNet编码器 | 使用默认的effnet_encoder.safetensors |
| previewer | previewer | 模型文件名 | previewer.safetensors | 这是"预览生成器"，负责生成预览图 | 预览器模型 | 使用默认的previewer.safetensors |
| controlnet | controlnet | 模型文件名 | controlnet/canny.safetensors | 这是"构图控制师"，负责控制图片的构图和线条 | ControlNet控制模型 | 使用默认的controlnet/canny.safetensors |
| ultrapixel_directory | ultrapixel_directory | 文件路径 | default | UltraPixel模型的"存放位置" | UltraPixel模型目录路径 | 保持"default"让系统自动管理 |
| stablecascade_directory | stablecascade_directory | 文件路径 | default | StableCascade模型的"存放位置" | StableCascade模型目录路径 | 保持"default"让系统自动管理 |
3.2 UltraPixel Process 节点 - 图片生成处理器
这个节点是干嘛的？
这就像是一个"超级画家工作室"！它是整个插件的核心，负责根据你的要求生成高质量的图片。你可以把它想象成一个拥有多个助手的顶级画家，能够按照你的描述，一步步地创作出精美的艺术作品。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| model | model | 模型对象 | 连接UltraPixel Load | 这是"画家工具箱"，包含所有绘画需要的工具 | UltraPixel模型实例 | 连接UltraPixel Load节点的输出 |
| height | height | 整数 | 2048 | 图片的"高度"，决定画布有多高 | 生成图像的高度像素 | 设置2048生成高清图片 |
| width | width | 整数 | 2048 | 图片的"宽度"，决定画布有多宽 | 生成图像的宽度像素 | 设置2048生成正方形高清图片 |
| seed | seed | 整数 | 0 | "随机种子"，相同种子产生相同结果 | 随机数生成种子 | 设置固定数字保证结果可重现 |
| dtype | dtype | 数据类型 | bf16 | "计算精度"，影响速度和质量 | 浮点数精度类型 | bf16节省显存，fp32质量更高 |
| stage_a_tiled | stage_a_tiled | 布尔值 | true | 是否"分块处理"最终阶段，节省显存 | Stage A是否使用瓦片处理 | true适合大图片，false适合小图片 |
| stage_b_steps | stage_b_steps | 整数 | 10 | 中级绘画的"步骤数"，步数越多细节越丰富 | Stage B采样步数 | 10步平衡速度和质量 |
| stage_b_cfg | stage_b_cfg | 浮点数 | 1.1 | 中级绘画的"遵循程度"，数值越高越听话 | Stage B分类器引导强度 | 1.1是推荐值，不建议改动太大 |
| stage_c_steps | stage_c_steps | 整数 | 20 | 草图绘画的"步骤数"，影响基础构图质量 | Stage C采样步数 | 20步是推荐值，可适当增加 |
| stage_c_cfg | stage_c_cfg | 浮点数 | 4.0 | 草图绘画的"遵循程度"，控制对文字描述的理解 | Stage C分类器引导强度 | 4.0是推荐值，可根据需要调整 |
| controlnet_weight | controlnet_weight | 浮点数 | 0.7 | 控制网络的"影响强度"，控制参考图片的影响程度 | ControlNet权重系数 | 0.7中等强度，1.0最强，0.3较弱 |
| prompt | prompt | 多行文本 | 空白 | "绘画指令"，告诉AI你想要什么样的图片 | 文本提示词 | 输入"美丽的花园里有个穿红裙子的女孩" |
| controlnet_image | controlnet_image | 图片对象 | 可选连接 | "参考构图图片"，用来控制生成图片的构图 | ControlNet输入图像 | 连接Load Image节点提供参考图片 |
输出结果：
- image：生成的最终高清图片
- edge_preview：控制网络的边缘预览图（仅在使用controlnet_image时有效）
4. 使用技巧和建议
4.1 新手入门建议
- 从小尺寸开始：初次使用建议设置1024x1024，熟悉后再尝试更大尺寸
- 使用简单提示词：先用简单的描述测试，如"a beautiful flower"
- 保持默认参数：新手建议使用默认参数，效果已经很好
- 注意显存使用：如果出现内存不足，降低图片尺寸
4.2 参数调优技巧
-
尺寸设置建议：
- 10GB显存：推荐1536x1536或2048x1024
- 12GB显存：推荐2048x2048或2560x1920
- 16GB显存：可尝试3072x3072或4096x2048
-
质量优化：
- 增加stage_c_steps到30-40获得更好的基础构图
- 增加stage_b_steps到15-20获得更丰富的细节
- 使用fp32获得最高质量（但会消耗更多显存）
-
速度优化：
- 使用bf16数据类型
- 降低steps参数
- 使用较小的图片尺寸
4.3 提示词编写技巧
-
描述要具体：
- 好的例子："A young woman with long blonde hair wearing a red dress in a garden"
- 不好的例子："woman"
-
添加质量词汇：
- 在描述后加上"high quality, detailed, masterpiece"
- 使用"photorealistic"获得照片级效果
-
控制风格：
- 加上"oil painting"获得油画风格
- 加上"anime style"获得动漫风格
5. 常见问题解答
Q1：为什么会出现"CUDA out of memory"错误？
A： 显存不足的解决方法：
- 降低图片尺寸（从2048降到1536或1024）
- 使用bf16而不是fp32
- 设置stage_a_tiled为true
- 关闭其他占用显存的程序
Q2：生成的图片质量不理想怎么办？
A： 提升质量的方法：
- 增加stage_c_steps和stage_b_steps
- 使用更详细的提示词
- 尝试不同的seed值
- 使用fp32数据类型（如果显存允许）
Q3：第一次使用时下载很慢怎么办？
A： 下载问题的解决方法：
- 确保网络连接稳定
- 使用科学上网工具
- 耐心等待，模型文件较大
- 可以手动下载模型到指定目录
Q4：如何使用ControlNet功能？
A： ControlNet使用方法：
- 连接Load Image节点到controlnet_image输入
- 调整controlnet_weight控制影响强度
- 查看edge_preview输出了解边缘检测效果
- 确保参考图片清晰且构图合理
Q5：生成速度很慢怎么办？
A： 加速生成的方法：
- 降低steps参数（stage_b_steps和stage_c_steps）
- 使用bf16数据类型
- 减小图片尺寸
- 确保使用GPU而不是CPU
6. 工作流程示例
6.1 基础文字转图片工作流程
-
加载模型：
- UltraPixel Load → 使用所有默认模型
-
设置生成参数：
- UltraPixel Process → 连接模型
- 设置尺寸为2048x2048
- 输入提示词："A beautiful landscape with mountains and lake"
-
生成图片：
- 点击Queue Prompt开始生成
- 等待处理完成
-
保存结果：
- Save Image → 保存生成的图片
6.2 使用ControlNet的工作流程
-
准备参考图片：
- Load Image → 加载参考构图图片
-
加载模型：
- UltraPixel Load → 使用默认模型
-
设置ControlNet：
- UltraPixel Process → 连接模型和参考图片
- 设置controlnet_weight为0.7
- 输入提示词描述想要的内容
-
查看预览：
- 连接Preview Image到edge_preview输出
- 检查边缘检测效果
-
生成最终图片：
- 调整参数后生成最终结果
6.3 高质量大图生成工作流程
-
优化参数设置：
- 设置尺寸为3072x3072（如果显存允许）
- stage_c_steps设置为30
- stage_b_steps设置为15
- 使用fp32数据类型
-
精心编写提示词：
- 使用详细的描述
- 添加质量关键词
- 指定艺术风格
-
分批生成：
- 使用不同的seed生成多张
- 选择最满意的结果
7. 高级应用技巧
7.1 艺术风格控制
-
写实风格：
- 提示词加上"photorealistic, highly detailed"
- 使用较高的cfg值
-
艺术风格：
- 加上"oil painting, impressionist style"
- 尝试不同的艺术家名字
-
动漫风格：
- 加上"anime, manga style"
- 降低cfg值获得更柔和的效果
7.2 构图控制技巧
-
使用ControlNet：
- 准备清晰的线稿或边缘图
- 调整权重控制影响程度
- 结合详细提示词
-
长宽比选择：
- 人像：推荐3:4或2:3比例
- 风景：推荐16:9或4:3比例
- 正方形：适合社交媒体
7.3 批量生成策略
-
固定参数批量：
- 使用相同参数，改变seed
- 快速生成多个变体
-
参数对比：
- 改变单一参数对比效果
- 找到最佳参数组合
8. 总结
ComfyUI-UltraPixel插件是一个功能强大的超高分辨率图像生成工具，通过2个核心节点，你可以：
- 🎨 生成超高清图片：支持2048x2048甚至更大尺寸
- 🖼️ 文字转图片：根据描述生成精美艺术作品
- 🎯 精确控制构图：使用ControlNet控制图片构图
- ⚡ 多阶段优化：通过多个阶段逐步提升图片质量
使用建议：
- 新手从默认参数和小尺寸开始
- 根据显存大小合理设置图片尺寸
- 编写详细具体的提示词
- 善用ControlNet功能控制构图
记住：UltraPixel是一个非常强大的工具，但也需要较高的硬件配置。合理设置参数，发挥创意，你就能创造出令人惊艳的高质量艺术作品！