closerAI-qwen-image-Helper套件节点

会员共享。

现阶段套件节点说明及操作如下:

ComfyUI · Qwen-Image 2.1 扩展套件

closerAI-qwen-image-Helper

面向 Qwen-Image 2.1 的提示词增强与推理加速套件。用中文结构化提示词降低复杂生成和多图编辑的使用门槛,并通过 Spectrum 特征预测减少完整 Transformer 计算。

中文界面与中文提示词 文生图与图片编辑 最多 10 张参考图 训练免费采样加速

套件包含什么

两个节点分别处理生成前的提示词组织和采样阶段的性能优化,可单独使用,也可以组合进同一条工作流。

提示词

closerAI-qwen-image提示词增强

调用 OpenAI 兼容的文本或多模态 API,将简短需求改写成适合 Qwen-Image 2.1 的中文提示词。

  • 文生图和图片编辑双模式
  • 轻度、标准、专业三档增强
  • 自动选择宽高比和官方 2K 尺寸
  • 多图角色绑定与未编辑区域保护
  • API 失败自动回退原提示词
加速

closerAI Qwen-Image 2.1 加速(Spectrum)

在部分采样步预测末端 hidden feature,跳过昂贵的 32 层 Transformer,只运行输出头。

  • 无需训练,不修改模型权重
  • 支持 T2I、I2I、多参考图和 RGBA
  • 内置 4GB 至 24GB 以上显存预设
  • 异常时自动回退完整计算
  • 支持 CPU、卸载设备和 GPU 缓存

安装方法

将完整套件目录放入 ComfyUI 的自定义节点目录,然后重新启动 ComfyUI。

放置套件目录

确认最终目录名称为 closerAI-qwen-image-Helper,不要只复制其中单个 Python 文件。

ComfyUI/custom_nodes/closerAI-qwen-image-Helper/

重启 ComfyUI

重新启动后,在节点搜索中输入 closerAI-qwen-image。节点分类位于 closerAI-qwen-image-Helper

准备 Qwen-Image 2.1

Spectrum 节点要求 ComfyUI 原生 Qwen-Image 2.1 Transformer。隐藏内部模块的特殊量化封装可能无法使用。

提示词增强:配置与操作

文生图可以调用普通文本模型;图片编辑必须使用支持图片输入的多模态模型,否则 API 无法理解参考图内容。

输入原始需求
调用 LLM / VLM API
输出中文增强提示词
连接 Qwen 文本编码
参数作用推荐
任务模式选择文生图或图片编辑。有参考图时选“图片编辑”。
强化强度控制增强提示词的信息密度。普通任务用“标准”;海报和复杂排版用“专业”。
API地址OpenAI 兼容 Chat Completions 地址。可填写到服务根地址、/v1 或完整接口。
模型名称API 服务端实际提供的模型 ID。编辑模式选择视觉多模态模型。
API密钥Bearer Token。优先使用环境变量,避免把密钥保存到工作流。
温度控制语言模型生成随机性。0.3~0.5,默认 0.4
随机种子传给支持 seed 的 API,提高结果复现性。需要固定结果时保持不变。
最大输出Token限制增强结果长度。标准模式使用 4096
超时秒数单次 API 请求的最长等待时间。默认 120 秒;远程多模态服务较慢时可适当提高。
失败时回退原提示词API 异常时不中断工作流。建议开启。
API Key 环境变量:节点会依次读取 CLOSERAI_QWEN_API_KEYOPENAI_API_KEY。API 密钥输入框留空即可使用环境变量。

文生图操作

填写原始提示词

可以输入简短中文,例如“雨中弹吉他的柯基,电影感横版”。

选择文生图与强化强度

节点会输出中文画面描述,并单独返回宽高比、宽度和高度。

连接文本编码节点

将“增强提示词”连接到 Qwen-Image 2.1 文本编码输入;宽度和高度可连接到对应 latent 节点。

图片编辑操作

连接参考图

按顺序连接参考图1至参考图10。节点在 API 请求中按 <image1><image2> 的顺序管理它们。

选择图片编辑

使用支持视觉输入的 API 模型。节点会识别基础画布、身份参考、服装、商品和场景来源。

使用跟随图片输出

原图内编辑通常输出 <image1>;新海报或新构图通常输出明确宽高比。

隐私提示:图片编辑模式会把连接的参考图发送给所选 API 服务商。涉及人像、商品资料或未公开素材时,请确认服务商的数据处理政策。

Spectrum 加速:连接与预设

该节点不是 4 步 LoRA。它保留原采样步数,但让其中一部分步骤不再运行完整 Transformer。

加载 Qwen-Image 2.1
加载 LoRA / 模型修改
Spectrum 加速
KSampler
节点顺序:Spectrum 必须放在所有 LoRA 和模型修改节点之后、采样器之前。第一次使用建议打开“调试日志”,在控制台确认真实计算和预测计算数量。
显存预设缓存位置加速倾向适用建议
4GBCPU保守低分辨率尝试,减少额外显存压力。
8GBCPU平衡适合 RTX 4060 Ti 等 8GB 显卡。
8GB~16GBComfyUI 卸载设备中等速度与显存占用折中。
16GB~24GBGPU较激进减少 CPU 与 GPU 之间的特征传输。
24GB以上GPU速度优先允许更长预测间隔,复杂任务仍需检查画质。
自定义手动可调只有选择“自定义”时,下方手动参数才生效。

预设自动参数

选择显存档位后,下列参数会自动生效并覆盖节点面板里的手动值;只有选择“自定义”时,手动参数才参与计算。

预设预热末尾真实初始间隔间隔增长最大连续预测历史点Chebyshev阶数混合权重缓存
4GB422.00.506420.35CPU
8GB422.00.758630.50CPU
8GB~16GB422.01.0010840.50卸载设备
16GB~24GB412.01.5012840.60GPU
24GB以上412.02.0014840.65GPU
预设定位:这些数值是 closerAI 面向常见 Qwen-Image 2.1 工作流整理的推荐最优起点。分辨率、采样步数、注意力实现、控制节点和量化方式不同,实际最优值可能需要向相邻档位调整。

调参原则

  • 间隔增长越大,完整 Transformer 调用越少,但纹理和文字更容易漂移。
  • 预热步数提供预测历史,过低可能导致前期构图不稳定。
  • 末尾真实步数负责恢复细节,文字、毛发和商品图建议保留 2~4 步。
  • 历史特征点数越多拟合越稳,但占用更多内存。
  • 8GB 显卡建议先用 25 步、8GB 预设和 CPU 缓存。

推荐组合工作流

提示词增强解决“模型不知道你具体想要什么”,Spectrum 解决“每一步完整计算太慢”。

增强提示词

把短需求整理为中文成图描述或精确编辑指令,同时获取建议比例。

准备条件输入

连接 Qwen 文本编码、多参考图、latent 和可选 LoRA。

应用 Spectrum

根据显卡选择预设,再将输出模型接入采样器。

检查最终质量

文字密集、商品 Logo、人物身份和复杂多图任务应与未加速结果对照。

常见问题

提示词增强节点必须使用官方 Qwen Prompt Enhancer 吗?

不需要。该节点通过 OpenAI 兼容 API 调用外部 LLM/VLM。文生图可使用文本模型;图片编辑应使用能看图的多模态模型。

为什么随机种子相同,增强结果仍可能略有差异?

并非所有 API 都支持 seed,也并非所有服务都承诺严格确定性。节点会传递随机种子;服务商不支持时会自动移除并重试。

为什么图片编辑节点输出“跟随图片”?

原图内局部编辑应继承基础画布比例,因此返回 <image1> 等标记。创建新海报、新合影或新构图时,则返回独立宽高比。

Spectrum 能把模型变成 4 步吗?

不能。Spectrum 是推理时特征预测,通常仍使用 20~40 步,只是减少其中完整 Transformer 的运行次数。真正的 4 步模型需要蒸馏 LoRA。

启用加速后哪些内容最容易损失?

细小文字、毛发、织物纹理、商品标记和复杂多主体关系最敏感。提高末尾真实步数或降低间隔增长可以换取更稳定的画质。

为什么量化模型不能使用 Spectrum?

Spectrum 需要访问原生 Transformer 的 transformer_blocksnorm_outproj_out。如果量化封装隐藏了这些模块,节点会拒绝加载或回退完整计算。

套件节点下载:

隐藏内容
本内容需权限查看
  • 普通用户: 599金币
  • VIP会员: 免费
  • 永久会员: 免费

主题授权提示:请在后台主题设置-主题授权-激活主题的正版授权,授权购买:RiTheme官网

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。