%20(1).png)
ComfyUI-HiDream-I1 插件完全指南
1. 插件简介
插件地址： https://github.com/Yuan-ManX/ComfyUI-HiDream-I1
HiDream-I1是一个拥有17B参数的新开源图像生成基础模型，能在几秒钟内实现最先进的图像生成质量。这个插件的作用就是让ComfyUI能够直接使用HiDream-I1这个强大的图像生成模型。
简单来说，这个插件能给你带来什么：
- 让你在ComfyUI里直接用上HiDream-I1这个超强的图像生成模型
- 生成质量比很多现有的开源模型都要好
- 生成速度很快，几秒钟就能出图
- 支持多种不同的模型版本（完整版、开发版、快速版等）
想象一下，这就像是给你的ComfyUI装上了一个全新的、更强大的"画笔"，能画出比之前更漂亮、更精细的图片。
2. 如何安装
第一步：确保你已经安装了ComfyUI
如果还没有安装ComfyUI，请先去官网下载安装。
第二步：下载插件
- 打开你的ComfyUI安装文件夹
- 找到
custom_nodes文件夹（这就像是ComfyUI的"插件库"） - 在这个文件夹里打开命令行（就是那个黑框框）
- 输入以下命令：
git clone https://github.com/Yuan-ManX/ComfyUI-HiDream-I1.git
第三步：安装依赖
- 进入刚刚下载的插件文件夹：
cd ComfyUI-HiDream-I1
- 安装必要的组件：
pip install -r requirements.txt
第四步：下载模型文件
你需要下载几个重要的文件：
-
文本编码器文件（就像是"翻译官"，把你的文字描述转换成模型能理解的语言）
- 把这4个文件放到
ComfyUI/models/text_encoders文件夹里 - 可以从这里下载：https://huggingface.co/Comfy-Org/HiDream-I1_ComfyUI/tree/main/split_files/text_encoders
- 把这4个文件放到
-
VAE文件（就像是"颜色调色板"，负责图片的颜色和细节）
- 下载ae.safetensors文件
- 放到
ComfyUI/models/vae/文件夹里
-
主模型文件（这是真正的"画师"）
- 选择你想要的版本下载（建议新手先用dev版本）
- 放到
ComfyUI/models/diffusion_models/文件夹里
3. 节点详细解析
重要说明： 这个插件实际上是让ComfyUI原生支持HiDream-I1模型，而不是添加新的自定义节点。你会在ComfyUI的原生节点中看到HiDream-I1相关的选项。
3.1 模型加载节点 (Load Diffusion Model)
这个节点就像是"选择画师"的地方，你在这里告诉ComfyUI你想用哪个HiDream-I1模型来画图。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 模型名称 | model_name | hidream_i1_dev_bf16.safetensors 等 | hidream_i1_dev_bf16.safetensors | 选择你想用的HiDream-I1模型版本，就像选择不同风格的画师 | 指定要加载的HiDream-I1模型文件 | 从下拉菜单中选择你下载的模型文件 |
3.2 文本编码器节点 (Load CLIP)
这个节点就像是"翻译官"，把你写的文字描述翻译成模型能理解的"画画指令"。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 文本编码器类型 | clip_name | t5xxl_fp16.safetensors | t5xxl_fp16.safetensors | 选择负责理解文字的"翻译官"，不同的翻译官理解能力不同 | 选择文本编码器模型，用于将文本提示转换为向量表示 | 选择你下载的文本编码器文件 |
3.3 VAE解码器节点 (Load VAE)
这个节点就像是"调色师"，负责把模型生成的"草稿"变成最终的彩色图片。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| VAE模型名称 | vae_name | ae.safetensors | ae.safetensors | 选择负责图片颜色和细节的"调色师" | 选择VAE模型，用于图像的编码和解码 | 选择你下载的VAE文件 |
3.4 采样器节点 (KSampler)
这个节点就像是"画画的过程控制器"，决定模型怎么一步步画出图片。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 采样步数 | steps | 1-150 | 20-50 | 画画的步骤数，步数越多画得越细致但用时越长 | 去噪采样的迭代次数 | 新手建议用20-30步 |
| CFG值 | cfg | 1.0-20.0 | 5.0-8.0 | 模型对你描述的"听话程度"，数值越高越听话但可能过头 | 分类器自由引导强度 | 建议从7.0开始调整 |
| 采样器类型 | sampler_name | euler, dpm++等 | euler | 选择画画的"技法"，不同技法出来的效果略有不同 | 选择采样算法 | 新手建议用euler |
| 调度器 | scheduler | normal, karras等 | normal | 控制画画过程的"节奏"，影响生成的质量 | 选择噪声调度策略 | 建议用normal |
| 随机种子 | seed | 任意数字 | -1 | 控制随机性，相同种子会生成相似图片 | 随机数生成器种子 | 用-1表示随机，固定数字可复现结果 |
3.5 正面提示词节点 (CLIP Text Encode - Positive)
这个节点就像是"画画需求单"，你在这里详细描述你想要的图片是什么样的。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 提示词文本 | text | 任意英文描述 | 详细的英文描述 | 告诉模型你想要什么样的图片，越详细越好 | 正面提示词，描述期望生成的内容 | "a beautiful landscape with mountains and lake" |
3.6 负面提示词节点 (CLIP Text Encode - Negative)
这个节点就像是"不要画这些东西"的清单，告诉模型你不想在图片里看到什么。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 负面提示词文本 | text | 任意英文描述 | 常见的负面词汇 | 告诉模型不要画什么，避免不想要的内容 | 负面提示词，描述不希望生成的内容 | "blurry, low quality, distorted" |
3.7 空噪声节点 (Empty Latent Image)
这个节点就像是"画布"，决定你要画的图片有多大。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 宽度 | width | 64-2048 | 1024 | 图片的宽度，像素单位 | 生成图像的水平分辨率 | 1024适合大多数情况 |
| 高度 | height | 64-2048 | 1024 | 图片的高度，像素单位 | 生成图像的垂直分辨率 | 1024适合大多数情况 |
| 批次大小 | batch_size | 1-64 | 1 | 一次生成几张图片 | 单次生成的图像数量 | 新手建议用1 |
3.8 VAE解码节点 (VAE Decode)
这个节点就像是"显影剂"，把模型生成的"底片"转换成我们能看到的图片。
参数详解：
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入样本 | samples | 来自采样器的数据 | 自动连接 | 接收采样器生成的"底片数据" | 接收潜在空间的图像数据 | 通过连线自动获取 |
| VAE模型 | vae | 来自VAE加载器 | 自动连接 | 使用的"显影设备" | 用于解码的VAE模型 | 通过连线自动获取 |
4. 使用技巧和建议
4.1 新手入门建议
- 先用dev版本：hidream_i1_dev_bf16.safetensors比较适合新手，生成速度快
- 从简单开始：先试试简单的提示词，比如"a cat sitting on a table"
- 步数不要太高：刚开始用20-30步就够了，太高容易出问题
4.2 提升图片质量的技巧
- 详细描述：提示词越详细，生成的图片越符合你的期望
- 使用高质量关键词：添加"high quality", "detailed", "masterpiece"等词汇
- 合理设置CFG：一般在5.0-8.0之间效果最好
4.3 参数调节小窍门
- CFG太高：图片可能会过度饱和或者出现奇怪的颜色
- CFG太低：图片可能会偏离你的描述
- 步数太少：图片可能不够精细
- 步数太多：浪费时间，而且可能出现过度处理的问题
5. 常见问题解答
Q1: 为什么我找不到HiDream-I1的节点？
A: 这个插件不是添加新节点，而是让ComfyUI原生支持HiDream-I1模型。你需要在模型加载节点中选择相应的HiDream-I1模型文件。
Q2: 模型文件太大了怎么办？
A: HiDream-I1模型确实比较大，建议：
- 先下载dev版本（相对较小）
- 确保你的硬盘空间足够
- 使用稳定的网络连接下载
Q3: 生成速度很慢怎么办？
A: 可能的原因和解决方案：
- 显存不够：降低图片分辨率或者减少步数
- CPU处理：确保模型在GPU上运行
- 步数太多：减少采样步数到20-30步
Q4: 生成的图片质量不好怎么办？
A: 检查以下几点：
- 提示词是否足够详细
- CFG值是否合适（建议5.0-8.0）
- 采样步数是否太少（建议20-50步）
- 是否使用了负面提示词
Q5: 无法加载模型文件怎么办？
A: 检查：
- 文件是否放在正确位置
- 文件是否下载完整
- 文件名是否正确
- ComfyUI是否重启
6. 进阶使用技巧
6.1 不同模型版本的选择
- hidream_i1_full_fp16.safetensors：完整版，质量最高，但需要更多显存
- hidream_i1_dev_bf16.safetensors：开发版，平衡了质量和速度
- hidream_e1_full_bf16.safetensors：实验性编辑模型，适合图片编辑
6.2 提示词优化技巧
- 风格词汇：添加"photorealistic", "anime style", "oil painting"等描述风格
- 质量词汇：使用"8k", "ultra detailed", "sharp focus"等提升质量
- 情感词汇：添加"peaceful", "dramatic", "mysterious"等表达情感
6.3 高级工作流程
- 多模型对比：同时使用不同版本的模型对比效果
- 渐进式生成：先用低分辨率快速预览，再用高分辨率精细生成
- 批量生成：使用不同的种子值生成多个版本供选择
6.4 故障排除指南
- 显存不足：降低分辨率、减少批次大小、使用fp16版本
- 生成失败：检查提示词是否包含敏感内容
- 结果不稳定：固定种子值来获得一致的结果
记住，使用HiDream-I1就像学习一门新的绘画技巧，需要多练习和实验。不要害怕尝试不同的参数组合，每个人的使用习惯和需求都不同，找到最适合你的设置才是最重要的！