Nunchaku FLUX.1-dev新手教程英文提示词写作技巧常见报错解决方案你是不是刚在ComfyUI里装好Nunchaku FLUX.1-dev模型兴冲冲地输入一段描述结果要么生成一张完全看不懂的图要么直接弹出一堆红色错误信息别急这太正常了。FLUX.1-dev是个能力超强的文生图模型但它就像个刚来中国的外国大厨你用中文点菜提示词它可能理解得七扭八歪。今天这篇教程就是来帮你解决这两个最头疼的问题怎么写好英文提示词以及怎么搞定那些烦人的报错。我会带你从零开始用最直白的话把从安装到出图的每一步都讲清楚重点攻克“写提示词”和“解错误”这两个难关。看完你就能自己调教这个“大厨”让它乖乖做出你想要的“菜”。1. 环境准备给你的电脑“体检”在请这位“大厨”开工前得先看看你家“厨房”电脑够不够格。别嫌麻烦这一步做对了后面能省一堆事儿。硬件要求“厨房”大小显卡必须是一块NVIDIA的显卡并且支持CUDA。这是最重要的。显存推荐24GB或以上。如果显存不够比如只有8G或12G也不用慌后面我们会用“精简版”模型FP8量化版一样能跑起来。软件要求“厨具”齐全Python需要安装Python 3.10或更高的版本。Git用来下载代码确保已经安装好。PyTorch这是AI模型的“发动机”需要安装和你系统、显卡匹配的版本比如torch 2.7, 2.8, 2.9。一个关键工具 在开始安装前先打开你的命令行终端运行下面这个命令。它会安装一个叫huggingface_hub的工具后面下载模型全靠它。pip install --upgrade huggingface_hub好了“体检”完成如果都满足我们就可以进入下一步搭建“厨房”了。2. 安装部署把“厨房”和“大厨”请回家这一步我们要做两件事安装ComfyUI的Nunchaku插件搭建厨房然后安装Nunchaku的后端程序请回大厨本人。2.1 安装ComfyUI-nunchaku插件这里给你两种方法选一个你觉得顺手的就行。方法A用Comfy-CLI安装最简单推荐新手这个方法就像用“应用商店”一键安装非常省心。# 1. 安装ComfyUI的命令行工具 pip install comfy-cli # 2. 安装ComfyUI如果你已经装过了这步可以跳过 comfy install # 3. 安装Nunchaku插件 comfy noderegistry-install ComfyUI-nunchaku # 4. 把插件移动到正确的位置 mv ComfyUI-nunchaku ComfyUI/custom_nodes/nunchaku_nodes方法B手动安装适合喜欢自己掌控一切的朋友# 1. 下载并安装ComfyUI git clone https://github.com/comfyanonymous/ComfyUI.git cd ComfyUI pip install -r requirements.txt # 2. 下载Nunchaku插件 cd custom_nodes git clone https://github.com/mit-han-lab/ComfyUI-nunchaku nunchaku_nodes2.2 安装Nunchaku后端插件装好后“大厨”的核心程序还没来。从v0.3.2版本开始这个过程变得超级简单。你只需要在ComfyUI的网页界面里找到并加载一个叫install_wheel.json的工作流文件运行它就能一键安装或更新后端了。具体位置通常在插件自带的示例工作流里。“厨房”搭好了“大厨”也请进门了。接下来我们得给大厨准备好“食材”模型文件和“菜谱”工作流。3. 使用准备备好“食材”与“菜谱”3.1 配置工作流“菜谱”工作流就是告诉ComfyUI每一步该怎么做的流程图。Nunchaku插件自带了一些现成的“菜谱”我们把它复制到ComfyUI能识别的地方就行。打开命令行进入你的ComfyUI文件夹然后执行# 进入ComfyUI的主目录 cd ComfyUI # 创建存放示例工作流的文件夹如果还没有的话 mkdir -p user/default/example_workflows # 把插件自带的工作流复制过去 cp custom_nodes/nunchaku_nodes/example_workflows/* user/default/example_workflows/3.2 下载模型文件“食材”这是最关键的一步模型文件放错地方整个“厨房”都会罢工。你需要下载两种“食材”1. 基础FLUX模型“主食和调味料”必下这些是FLUX系列模型通用的组件包括理解文字的和处理图像的。# 下载文本理解模型放到 models/text_encoders 文件夹 hf download comfyanonymous/flux_text_encoders clip_l.safetensors --local-dir models/text_encoders hf download comfyanonymous/flux_text_encoders t5xxl_fp16.safetensors --local-dir models/text_encoders # 下载图像处理模型放到 models/vae 文件夹 hf download black-forest-labs/FLUX.1-schnell ae.safetensors --local-dir models/vae小提示如果之前用其他方式下过这些模型也可以手动创建“软链接”指向它们节省硬盘空间。2. Nunchaku FLUX.1-dev主模型“主厨的独家秘方”核心这才是我们今天的主角。根据你的显卡型号选择对应的版本大多数NVIDIA显卡如RTX 30/40系列用INT4版本平衡了效果和速度。Blackwell新架构显卡如RTX 50系列用FP4版本。显存紧张比如只有8G-12G用FP8版本效果稍弱但能跑起来。以最常用的INT4版本为例下载命令如下# 下载主模型放到 models/unet/ 文件夹 hf download nunchaku-tech/nunchaku-flux.1-dev svdq-int4_r32-flux.1-dev.safetensors --local-dir models/unet/3. 可选LoRA模型“风味添加剂”LoRA可以微调模型的风格。比如FLUX.1-Turbo-Alpha能加快生成速度Ghibsky Illustration能生成吉卜力动画风格。这些文件需要下载到models/loras/文件夹。万事俱备只欠东风。接下来我们启动厨房开始做第一道菜。4. 启动与运行做出你的第一张图4.1 启动ComfyUI在你的ComfyUI根目录下打开命令行输入python main.py看到命令行输出一个本地网址通常是http://127.0.0.1:8188用浏览器打开它你就进入了ComfyUI的网页操作界面。4.2 加载工作流并生成加载“菜谱”在网页界面点击“Load”按钮选择我们刚才复制过来的nunchaku-flux.1-dev.json这个工作流文件。这个工作流功能最全支持使用多个LoRA。输入“点菜单”在工作流中找到Prompt节点这里就是输入描述的地方。重点来了请用英文描述这是让FLUX模型理解你的关键。调整“火候”你可以调整图片尺寸、生成步数等参数。如果显存小就把分辨率调低点比如1024x1024。点击“开始烹饪”点击“Queue Prompt”按钮等待进度条走完你的第一张FLUX.1-dev作品就在右侧预览区诞生了看到生成的图片你可能兴奋也可能有点失望——“这跟我想要的好像不太一样” 别急问题大概率出在“点菜”的方式上也就是提示词Prompt。5. 核心技巧如何写好英文提示词“点菜的艺术”FLUX.1-dev对英文提示词的理解远好于中文。写好英文提示词是用好它的核心。记住这个公式核心主体 细节描述 风格修饰 质量参数。1. 核心主体 (Subject)说清楚“画什么”差A cat(一只猫)好A majestic Siberian cat with bright blue eyes(一只拥有明亮蓝眼睛的威严西伯利亚猫)要点越具体越好。包括种类、品种、特征、动作。2. 细节描述 (Details)丰富画面“有什么”环境in a cozy sunlit room, on a velvet cushion(在洒满阳光的舒适房间里在天鹅绒垫子上)光影dramatic sidelighting, soft shadows(戏剧性的侧光柔和的阴影)构图close-up portrait, dynamic angle(特写肖像动态角度)3. 风格修饰 (Style Artist)决定“怎么画”艺术风格digital painting, concept art, anime style, photorealistic艺术家参考by Studio Ghibli, in the style of Van Gogh渲染引擎Unreal Engine 5, Octane render4. 质量参数 (Quality Parameters)控制“画多好”画质8K, UHD, highly detailed, intricate details负面提示词在Negative Prompt框里输入你不想看到的东西如blurry, deformed, ugly, bad hands(模糊变形丑陋坏手)一个完整的优秀提示词示例A futuristic cyberpunk samurai standing on a neon-lit rainy rooftop at night, wearing intricate armor with glowing circuits, holding a katana. Cyberpunk style, cinematic lighting, dramatic atmosphere, highly detailed, 8K, masterpiece. (一位未来赛博朋克武士站在霓虹灯照耀的雨夜屋顶身穿带有发光电路的复杂盔甲手持武士刀。赛博朋克风格电影感灯光戏剧性氛围高度细节8K杰作。)多尝试多组合你会逐渐找到感觉。接下来我们解决另一个拦路虎报错。6. 常见报错与解决方案“厨房故障排除”即使一切安装正确运行时也可能遇到问题。这里列出几个最常见的错误和解决办法。报错1KeyError: xxx或模块/节点找不到问题加载工作流时提示缺少某个节点或模块。解决这是最常遇到的问题说明你的ComfyUI缺少某个自定义节点。打开ComfyUI网页。点击右下角的“Manager”按钮如果没有你需要先安装ComfyUI-Manager。在“Manager”界面点击“Install Missing Custom Nodes”。等待安装完成重启ComfyUI即可。报错2CUDA out of memory(显存不足)问题显卡显存不够模型加载失败或生成过程中崩溃。解决换用轻量模型确认你下载的是INT4或FP8的量化版模型而不是完整的FP16版。降低分辨率在生成时将输出分辨率从默认的1440x1440降低到1024x1024或更低。关闭其他程序关闭占用显存的游戏、浏览器等。使用--lowvram参数启动在启动命令中加入python main.py --lowvram但这会显著降低速度。报错3生成图片全黑、全灰或扭曲问题图片看起来完全不对。解决检查模型路径这是最常见原因请严格按照第3.2节的要求检查每个模型文件是否放在了正确的文件夹unet,loras,text_encoders,vae。检查VAE模型确保ae.safetensors这个VAE模型已正确下载并放置。调整推理步数如果你关闭了FLUX.1-Turbo-Alpha这个LoRA请将采样步数Steps调整到20步或以上步数太少会导致图像不完整。报错4HF Hub下载模型失败或网络错误问题使用hf download命令时卡住或报错。解决使用国内镜像如果你在国内下载Hugging Face模型可能很慢或失败。可以尝试使用ModelScope等国内镜像源手动下载模型文件然后放到对应目录。科学上网配置稳定的网络环境。手动下载直接访问模型的Hugging Face页面手动下载.safetensors文件然后放入对应文件夹。遇到错误别慌张按照上面的思路一步步排查大部分问题都能解决。7. 总结走到这里你已经完成了Nunchaku FLUX.1-dev在ComfyUI中的完整部署掌握了写出有效英文提示词的核心方法也具备了解决常见运行故障的能力。回顾一下最关键的三点环境与安装是基础确保显卡、Python环境达标并严格按照指引安装插件和模型特别是模型文件的存放位置一步错步步错。提示词是灵魂FLUX.1-dev是一位“英语大厨”。用具体、详细、结构化的英文向它描述你的想法结合风格和质量关键词才能得到惊艳的作品。多练是唯一的捷径。报错是常态CUDA out of memory、节点丢失、模型路径错误是最常见的“坑”。根据第6节的指南耐心排查你总能找到解决办法。现在打开你的ComfyUI用刚学到的提示词技巧去创造你的第一张FLUX.1-dev大作吧。从简单的场景开始逐步增加复杂度你会发现这个模型的潜力远超你的想象。祝你玩得开心获取更多AI镜像想探索更多AI镜像和应用场景访问 CSDN星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。
Nunchaku FLUX.1-dev新手教程：英文提示词写作技巧+常见报错解决方案
Nunchaku FLUX.1-dev新手教程英文提示词写作技巧常见报错解决方案你是不是刚在ComfyUI里装好Nunchaku FLUX.1-dev模型兴冲冲地输入一段描述结果要么生成一张完全看不懂的图要么直接弹出一堆红色错误信息别急这太正常了。FLUX.1-dev是个能力超强的文生图模型但它就像个刚来中国的外国大厨你用中文点菜提示词它可能理解得七扭八歪。今天这篇教程就是来帮你解决这两个最头疼的问题怎么写好英文提示词以及怎么搞定那些烦人的报错。我会带你从零开始用最直白的话把从安装到出图的每一步都讲清楚重点攻克“写提示词”和“解错误”这两个难关。看完你就能自己调教这个“大厨”让它乖乖做出你想要的“菜”。1. 环境准备给你的电脑“体检”在请这位“大厨”开工前得先看看你家“厨房”电脑够不够格。别嫌麻烦这一步做对了后面能省一堆事儿。硬件要求“厨房”大小显卡必须是一块NVIDIA的显卡并且支持CUDA。这是最重要的。显存推荐24GB或以上。如果显存不够比如只有8G或12G也不用慌后面我们会用“精简版”模型FP8量化版一样能跑起来。软件要求“厨具”齐全Python需要安装Python 3.10或更高的版本。Git用来下载代码确保已经安装好。PyTorch这是AI模型的“发动机”需要安装和你系统、显卡匹配的版本比如torch 2.7, 2.8, 2.9。一个关键工具 在开始安装前先打开你的命令行终端运行下面这个命令。它会安装一个叫huggingface_hub的工具后面下载模型全靠它。pip install --upgrade huggingface_hub好了“体检”完成如果都满足我们就可以进入下一步搭建“厨房”了。2. 安装部署把“厨房”和“大厨”请回家这一步我们要做两件事安装ComfyUI的Nunchaku插件搭建厨房然后安装Nunchaku的后端程序请回大厨本人。2.1 安装ComfyUI-nunchaku插件这里给你两种方法选一个你觉得顺手的就行。方法A用Comfy-CLI安装最简单推荐新手这个方法就像用“应用商店”一键安装非常省心。# 1. 安装ComfyUI的命令行工具 pip install comfy-cli # 2. 安装ComfyUI如果你已经装过了这步可以跳过 comfy install # 3. 安装Nunchaku插件 comfy noderegistry-install ComfyUI-nunchaku # 4. 把插件移动到正确的位置 mv ComfyUI-nunchaku ComfyUI/custom_nodes/nunchaku_nodes方法B手动安装适合喜欢自己掌控一切的朋友# 1. 下载并安装ComfyUI git clone https://github.com/comfyanonymous/ComfyUI.git cd ComfyUI pip install -r requirements.txt # 2. 下载Nunchaku插件 cd custom_nodes git clone https://github.com/mit-han-lab/ComfyUI-nunchaku nunchaku_nodes2.2 安装Nunchaku后端插件装好后“大厨”的核心程序还没来。从v0.3.2版本开始这个过程变得超级简单。你只需要在ComfyUI的网页界面里找到并加载一个叫install_wheel.json的工作流文件运行它就能一键安装或更新后端了。具体位置通常在插件自带的示例工作流里。“厨房”搭好了“大厨”也请进门了。接下来我们得给大厨准备好“食材”模型文件和“菜谱”工作流。3. 使用准备备好“食材”与“菜谱”3.1 配置工作流“菜谱”工作流就是告诉ComfyUI每一步该怎么做的流程图。Nunchaku插件自带了一些现成的“菜谱”我们把它复制到ComfyUI能识别的地方就行。打开命令行进入你的ComfyUI文件夹然后执行# 进入ComfyUI的主目录 cd ComfyUI # 创建存放示例工作流的文件夹如果还没有的话 mkdir -p user/default/example_workflows # 把插件自带的工作流复制过去 cp custom_nodes/nunchaku_nodes/example_workflows/* user/default/example_workflows/3.2 下载模型文件“食材”这是最关键的一步模型文件放错地方整个“厨房”都会罢工。你需要下载两种“食材”1. 基础FLUX模型“主食和调味料”必下这些是FLUX系列模型通用的组件包括理解文字的和处理图像的。# 下载文本理解模型放到 models/text_encoders 文件夹 hf download comfyanonymous/flux_text_encoders clip_l.safetensors --local-dir models/text_encoders hf download comfyanonymous/flux_text_encoders t5xxl_fp16.safetensors --local-dir models/text_encoders # 下载图像处理模型放到 models/vae 文件夹 hf download black-forest-labs/FLUX.1-schnell ae.safetensors --local-dir models/vae小提示如果之前用其他方式下过这些模型也可以手动创建“软链接”指向它们节省硬盘空间。2. Nunchaku FLUX.1-dev主模型“主厨的独家秘方”核心这才是我们今天的主角。根据你的显卡型号选择对应的版本大多数NVIDIA显卡如RTX 30/40系列用INT4版本平衡了效果和速度。Blackwell新架构显卡如RTX 50系列用FP4版本。显存紧张比如只有8G-12G用FP8版本效果稍弱但能跑起来。以最常用的INT4版本为例下载命令如下# 下载主模型放到 models/unet/ 文件夹 hf download nunchaku-tech/nunchaku-flux.1-dev svdq-int4_r32-flux.1-dev.safetensors --local-dir models/unet/3. 可选LoRA模型“风味添加剂”LoRA可以微调模型的风格。比如FLUX.1-Turbo-Alpha能加快生成速度Ghibsky Illustration能生成吉卜力动画风格。这些文件需要下载到models/loras/文件夹。万事俱备只欠东风。接下来我们启动厨房开始做第一道菜。4. 启动与运行做出你的第一张图4.1 启动ComfyUI在你的ComfyUI根目录下打开命令行输入python main.py看到命令行输出一个本地网址通常是http://127.0.0.1:8188用浏览器打开它你就进入了ComfyUI的网页操作界面。4.2 加载工作流并生成加载“菜谱”在网页界面点击“Load”按钮选择我们刚才复制过来的nunchaku-flux.1-dev.json这个工作流文件。这个工作流功能最全支持使用多个LoRA。输入“点菜单”在工作流中找到Prompt节点这里就是输入描述的地方。重点来了请用英文描述这是让FLUX模型理解你的关键。调整“火候”你可以调整图片尺寸、生成步数等参数。如果显存小就把分辨率调低点比如1024x1024。点击“开始烹饪”点击“Queue Prompt”按钮等待进度条走完你的第一张FLUX.1-dev作品就在右侧预览区诞生了看到生成的图片你可能兴奋也可能有点失望——“这跟我想要的好像不太一样” 别急问题大概率出在“点菜”的方式上也就是提示词Prompt。5. 核心技巧如何写好英文提示词“点菜的艺术”FLUX.1-dev对英文提示词的理解远好于中文。写好英文提示词是用好它的核心。记住这个公式核心主体 细节描述 风格修饰 质量参数。1. 核心主体 (Subject)说清楚“画什么”差A cat(一只猫)好A majestic Siberian cat with bright blue eyes(一只拥有明亮蓝眼睛的威严西伯利亚猫)要点越具体越好。包括种类、品种、特征、动作。2. 细节描述 (Details)丰富画面“有什么”环境in a cozy sunlit room, on a velvet cushion(在洒满阳光的舒适房间里在天鹅绒垫子上)光影dramatic sidelighting, soft shadows(戏剧性的侧光柔和的阴影)构图close-up portrait, dynamic angle(特写肖像动态角度)3. 风格修饰 (Style Artist)决定“怎么画”艺术风格digital painting, concept art, anime style, photorealistic艺术家参考by Studio Ghibli, in the style of Van Gogh渲染引擎Unreal Engine 5, Octane render4. 质量参数 (Quality Parameters)控制“画多好”画质8K, UHD, highly detailed, intricate details负面提示词在Negative Prompt框里输入你不想看到的东西如blurry, deformed, ugly, bad hands(模糊变形丑陋坏手)一个完整的优秀提示词示例A futuristic cyberpunk samurai standing on a neon-lit rainy rooftop at night, wearing intricate armor with glowing circuits, holding a katana. Cyberpunk style, cinematic lighting, dramatic atmosphere, highly detailed, 8K, masterpiece. (一位未来赛博朋克武士站在霓虹灯照耀的雨夜屋顶身穿带有发光电路的复杂盔甲手持武士刀。赛博朋克风格电影感灯光戏剧性氛围高度细节8K杰作。)多尝试多组合你会逐渐找到感觉。接下来我们解决另一个拦路虎报错。6. 常见报错与解决方案“厨房故障排除”即使一切安装正确运行时也可能遇到问题。这里列出几个最常见的错误和解决办法。报错1KeyError: xxx或模块/节点找不到问题加载工作流时提示缺少某个节点或模块。解决这是最常遇到的问题说明你的ComfyUI缺少某个自定义节点。打开ComfyUI网页。点击右下角的“Manager”按钮如果没有你需要先安装ComfyUI-Manager。在“Manager”界面点击“Install Missing Custom Nodes”。等待安装完成重启ComfyUI即可。报错2CUDA out of memory(显存不足)问题显卡显存不够模型加载失败或生成过程中崩溃。解决换用轻量模型确认你下载的是INT4或FP8的量化版模型而不是完整的FP16版。降低分辨率在生成时将输出分辨率从默认的1440x1440降低到1024x1024或更低。关闭其他程序关闭占用显存的游戏、浏览器等。使用--lowvram参数启动在启动命令中加入python main.py --lowvram但这会显著降低速度。报错3生成图片全黑、全灰或扭曲问题图片看起来完全不对。解决检查模型路径这是最常见原因请严格按照第3.2节的要求检查每个模型文件是否放在了正确的文件夹unet,loras,text_encoders,vae。检查VAE模型确保ae.safetensors这个VAE模型已正确下载并放置。调整推理步数如果你关闭了FLUX.1-Turbo-Alpha这个LoRA请将采样步数Steps调整到20步或以上步数太少会导致图像不完整。报错4HF Hub下载模型失败或网络错误问题使用hf download命令时卡住或报错。解决使用国内镜像如果你在国内下载Hugging Face模型可能很慢或失败。可以尝试使用ModelScope等国内镜像源手动下载模型文件然后放到对应目录。科学上网配置稳定的网络环境。手动下载直接访问模型的Hugging Face页面手动下载.safetensors文件然后放入对应文件夹。遇到错误别慌张按照上面的思路一步步排查大部分问题都能解决。7. 总结走到这里你已经完成了Nunchaku FLUX.1-dev在ComfyUI中的完整部署掌握了写出有效英文提示词的核心方法也具备了解决常见运行故障的能力。回顾一下最关键的三点环境与安装是基础确保显卡、Python环境达标并严格按照指引安装插件和模型特别是模型文件的存放位置一步错步步错。提示词是灵魂FLUX.1-dev是一位“英语大厨”。用具体、详细、结构化的英文向它描述你的想法结合风格和质量关键词才能得到惊艳的作品。多练是唯一的捷径。报错是常态CUDA out of memory、节点丢失、模型路径错误是最常见的“坑”。根据第6节的指南耐心排查你总能找到解决办法。现在打开你的ComfyUI用刚学到的提示词技巧去创造你的第一张FLUX.1-dev大作吧。从简单的场景开始逐步增加复杂度你会发现这个模型的潜力远超你的想象。祝你玩得开心获取更多AI镜像想探索更多AI镜像和应用场景访问 CSDN星图镜像广场提供丰富的预置镜像覆盖大模型推理、图像生成、视频生成、模型微调等多个领域支持一键部署。
