%20(1).png)
ComfyUI-Fal-API-Flux 插件超详细新手教程
1. 插件简介
GitHub原地址：https://github.com/yhayano-ponotech/ComfyUI-Fal-API-Flux
这个插件就像是给ComfyUI装了一个"云端AI画师"的功能。它让你能够在ComfyUI里直接使用fal.ai公司的FLUX.1 AI绘画模型，而不需要自己在电脑上安装这些超大的模型文件。
能给你带来什么效果？
- 云端生成高质量图片：就像用美图秀秀的滤镜一样简单，但效果更专业
- 多种生成模式：从文字生成图片、从图片改图片、给图片补充细节等
- 省电脑配置：不用担心电脑性能不够，云端帮你算
- 专业级效果：能生成商业级别的高质量图片
2. 如何安装
方法一：用ComfyUI管理器安装（推荐新手）
- 确保你已经安装了ComfyUI管理器插件
- 打开ComfyUI，找到"Manager"（管理器）标签页
- 在自定义节点区域搜索"ComfyUI-Fal-API-Flux"
- 点击"Install"（安装）按钮，等待自动下载完成
- 安装完成后点击"Restart"（重启）按钮
方法二：手动安装
- 打开ComfyUI的安装文件夹，找到
custom_nodes子文件夹 - 在这个文件夹里打开命令行工具
- 输入命令：
git clone https://github.com/yhayano-ponotech/ComfyUI-Fal-API-Flux.git - 等待下载完成后，重启ComfyUI
配置密钥（重要步骤）
- 在插件文件夹里创建一个名为
config.ini的文件 - 在文件里写入以下内容：
[falai]
api_key = 你的fal.ai密钥
- 保存文件，重启ComfyUI
3. 节点详细解析
3.1 Fal API Flux Dev 节点
这个节点就像是一个"文字变图片的魔法师"，你写一段描述，它就能帮你画出对应的图片。
3.1.1 参数详解
| 参数名 (界面显示) | 参数名 (代码里) | 参数类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 提示词 | prompt | 文本框 | 详细描述 | 就像给画师下订单，你说要画什么 | 输入生成图像的文本描述 | "一只可爱的小猫在花园里玩耍" |
| 宽度 | width | 数字 | 1024 | 决定生成图片的宽度，像调整画布大小 | 生成图像的像素宽度 | 1024表示1024像素宽 |
| 高度 | height | 数字 | 1024 | 决定生成图片的高度，像调整画布大小 | 生成图像的像素高度 | 1024表示1024像素高 |
| 生成步数 | num_inference_steps | 数字 | 25 | 就像画师画画的精细程度，步数越多越精细 | 模型推理迭代次数 | 25步通常就够用了 |
| 引导强度 | guidance_scale | 小数 | 7.5 | 控制AI多严格按照你的描述画，像给画师的严格程度 | 控制生成结果对提示词的遵循程度 | 7.5是平衡值，太高会过度拟合 |
| 随机种子 | seed | 数字 | 随机 | 就像抽签的号码，同样的号码会得到相同的结果 | 控制随机性，确保结果可复现 | 用-1表示随机，用固定数字保证每次一样 |
| 生成数量 | num_images | 数字 | 1 | 一次生成几张图片，像连拍照片 | 单次请求生成的图像数量 | 1张就够了，多张会花更多钱 |
3.2 Fal API Flux Dev Image-to-Image 节点
这个节点就像是一个"图片改造师"，你给它一张图片，它能按照你的要求重新改造这张图片。
3.2.1 参数详解
| 参数名 (界面显示) | 参数名 (代码里) | 参数类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图像 | image | 图片 | 必填 | 就像给改造师一张原始照片 | 作为基础的输入图像 | 连接一个图片加载节点 |
| 提示词 | prompt | 文本框 | 详细描述 | 告诉改造师你想要什么效果 | 描述期望的图像变化 | "把这张图片改成油画风格" |
| 宽度 | width | 数字 | 1024 | 输出图片的宽度 | 生成图像的像素宽度 | 建议和输入图片尺寸一致 |
| 高度 | height | 数字 | 1024 | 输出图片的高度 | 生成图像的像素高度 | 建议和输入图片尺寸一致 |
| 生成步数 | num_inference_steps | 数字 | 25 | 改造的精细程度 | 模型推理迭代次数 | 25步通常就够用了 |
| 引导强度 | guidance_scale | 小数 | 7.5 | 控制改造的严格程度 | 控制生成结果对提示词的遵循程度 | 7.5是平衡值 |
| 强度 | strength | 小数 | 0.8 | 控制改造的程度，就像调整滤镜强度 | 控制对原图的保留程度 | 0.8表示80%改造，20%保留原图 |
| 随机种子 | seed | 数字 | 随机 | 控制随机性 | 确保结果可复现 | 用-1表示随机 |
| 生成数量 | num_images | 数字 | 1 | 一次生成几张变化图片 | 单次请求生成的图像数量 | 1张就够了 |
3.3 Fal API Flux Dev with LoRA 节点
这个节点就像是一个"有特殊技能的画师"，LoRA就像是给画师增加的特殊绘画风格或技能包。
3.3.1 参数详解
| 参数名 (界面显示) | 参数名 (代码里) | 参数类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 提示词 | prompt | 文本框 | 详细描述 | 告诉画师要画什么 | 输入生成图像的文本描述 | "动漫风格的城市夜景" |
| LoRA配置 | lora | 连接 | 必填 | 连接特殊技能包 | 连接LoRA配置节点 | 从LoRA配置节点连线过来 |
| 宽度 | width | 数字 | 1024 | 画布宽度 | 生成图像的像素宽度 | 1024像素 |
| 高度 | height | 数字 | 1024 | 画布高度 | 生成图像的像素高度 | 1024像素 |
| 生成步数 | num_inference_steps | 数字 | 25 | 绘画精细程度 | 模型推理迭代次数 | 25步平衡质量和速度 |
| 引导强度 | guidance_scale | 小数 | 7.5 | 听话程度 | 控制生成结果对提示词的遵循程度 | 7.5是平衡值 |
| 随机种子 | seed | 数字 | 随机 | 抽签号码 | 控制随机性 | -1表示随机 |
| 生成数量 | num_images | 数字 | 1 | 一次画几张 | 单次请求生成的图像数量 | 1张即可 |
3.4 Fal API Flux Dev with LoRA Image-to-Image 节点
这个节点结合了图片改造和特殊技能，就像是一个"有特殊技能的图片改造师"。
3.4.1 参数详解
| 参数名 (界面显示) | 参数名 (代码里) | 参数类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图像 | image | 图片 | 必填 | 要改造的原图 | 作为基础的输入图像 | 连接图片加载节点 |
| 提示词 | prompt | 文本框 | 详细描述 | 改造要求 | 描述期望的图像变化 | "把这张照片改成动漫风格" |
| LoRA配置 | lora | 连接 | 必填 | 特殊技能包 | 连接LoRA配置节点 | 从LoRA配置节点连线 |
| 宽度 | width | 数字 | 1024 | 输出宽度 | 生成图像的像素宽度 | 与输入图片一致 |
| 高度 | height | 数字 | 1024 | 输出高度 | 生成图像的像素高度 | 与输入图片一致 |
| 生成步数 | num_inference_steps | 数字 | 25 | 改造精细度 | 模型推理迭代次数 | 25步够用 |
| 引导强度 | guidance_scale | 小数 | 7.5 | 听话程度 | 控制生成结果对提示词的遵循程度 | 7.5平衡值 |
| 强度 | strength | 小数 | 0.8 | 改造程度 | 控制对原图的保留程度 | 0.8表示大幅改造 |
| 随机种子 | seed | 数字 | 随机 | 随机控制 | 确保结果可复现 | -1随机 |
| 生成数量 | num_images | 数字 | 1 | 输出数量 | 单次请求生成的图像数量 | 1张即可 |
3.5 Fal API Flux with LoRA and ControlNet 节点
这个节点就像是一个"既有特殊技能又能精确控制的画师"，ControlNet就像是给画师提供精确的构图指导。
3.5.1 参数详解
| 参数名 (界面显示) | 参数名 (代码里) | 参数类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 提示词 | prompt | 文本框 | 详细描述 | 告诉画师画什么 | 输入生成图像的文本描述 | "一个穿红衣服的女孩在跳舞" |
| LoRA配置 | lora | 连接 | 可选 | 特殊技能包 | 连接LoRA配置节点 | 从LoRA配置节点连线 |
| ControlNet配置 | controlnet | 连接 | 可选 | 构图指导 | 连接ControlNet配置节点 | 从ControlNet配置节点连线 |
| 宽度 | width | 数字 | 1024 | 画布宽度 | 生成图像的像素宽度 | 1024像素 |
| 高度 | height | 数字 | 1024 | 画布高度 | 生成图像的像素高度 | 1024像素 |
| 生成步数 | num_inference_steps | 数字 | 25 | 绘画精细度 | 模型推理迭代次数 | 25步平衡质量速度 |
| 引导强度 | guidance_scale | 小数 | 7.5 | 听话程度 | 控制生成结果对提示词的遵循程度 | 7.5平衡值 |
| 随机种子 | seed | 数字 | 随机 | 随机控制 | 控制随机性 | -1表示随机 |
| 生成数量 | num_images | 数字 | 1 | 输出数量 | 单次请求生成的图像数量 | 1张即可 |
3.6 Fal API Flux with LoRA and ControlNet Image-to-Image 节点
这个节点是终极版本，结合了图片改造、特殊技能和精确控制，就像是一个"全能的图片改造大师"。
3.6.1 参数详解
| 参数名 (界面显示) | 参数名 (代码里) | 参数类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 输入图像 | image | 图片 | 必填 | 要改造的原图 | 作为基础的输入图像 | 连接图片加载节点 |
| 提示词 | prompt | 文本框 | 详细描述 | 改造要求 | 描述期望的图像变化 | "把这张照片改成古典油画风格" |
| LoRA配置 | lora | 连接 | 可选 | 特殊技能包 | 连接LoRA配置节点 | 从LoRA配置节点连线 |
| ControlNet配置 | controlnet | 连接 | 可选 | 构图指导 | 连接ControlNet配置节点 | 从ControlNet配置节点连线 |
| 宽度 | width | 数字 | 1024 | 输出宽度 | 生成图像的像素宽度 | 与输入图片一致 |
| 高度 | height | 数字 | 1024 | 输出高度 | 生成图像的像素高度 | 与输入图片一致 |
| 生成步数 | num_inference_steps | 数字 | 25 | 改造精细度 | 模型推理迭代次数 | 25步够用 |
| 引导强度 | guidance_scale | 小数 | 7.5 | 听话程度 | 控制生成结果对提示词的遵循程度 | 7.5平衡值 |
| 强度 | strength | 小数 | 0.8 | 改造程度 | 控制对原图的保留程度 | 0.8表示大幅改造 |
| 随机种子 | seed | 数字 | 随机 | 随机控制 | 确保结果可复现 | -1随机 |
| 生成数量 | num_images | 数字 | 1 | 输出数量 | 单次请求生成的图像数量 | 1张即可 |
3.7 Fal API Flux Pro 节点
这个节点就像是"专业版画师"，比普通版本更强大，能生成更高质量的图片。
3.7.1 参数详解
| 参数名 (界面显示) | 参数名 (代码里) | 参数类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 提示词 | prompt | 文本框 | 详细描述 | 告诉专业画师要画什么 | 输入生成图像的文本描述 | "高质量的商业产品摄影" |
| 宽度 | width | 数字 | 1024 | 画布宽度 | 生成图像的像素宽度 | 1024像素 |
| 高度 | height | 数字 | 1024 | 画布高度 | 生成图像的像素高度 | 1024像素 |
| 生成步数 | num_inference_steps | 数字 | 25 | 绘画精细度 | 模型推理迭代次数 | 专业版可以用更多步数 |
| 引导强度 | guidance_scale | 小数 | 7.5 | 听话程度 | 控制生成结果对提示词的遵循程度 | 7.5平衡值 |
| 安全容忍度 | safety_tolerance | 选择 | 2 | 内容过滤严格程度，像内容审查员 | 控制生成内容的安全过滤级别 | 2是中等程度 |
| 随机种子 | seed | 数字 | 随机 | 随机控制 | 控制随机性 | -1表示随机 |
| 生成数量 | num_images | 数字 | 1 | 输出数量 | 单次请求生成的图像数量 | 1张即可 |
3.8 Fal API Flux Pro V1.1 节点
这个是专业版的升级版，就像是"顶级画师"，功能更强大。
3.8.1 参数详解
| 参数名 (界面显示) | 参数名 (代码里) | 参数类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 提示词 | prompt | 文本框 | 详细描述 | 告诉顶级画师要画什么 | 输入生成图像的文本描述 | "超高质量的艺术作品" |
| 宽度 | width | 数字 | 1024 | 画布宽度 | 生成图像的像素宽度 | 1024像素 |
| 高度 | height | 数字 | 1024 | 画布高度 | 生成图像的像素高度 | 1024像素 |
| 生成步数 | num_inference_steps | 数字 | 25 | 绘画精细度 | 模型推理迭代次数 | 升级版可以用更多步数 |
| 引导强度 | guidance_scale | 小数 | 7.5 | 听话程度 | 控制生成结果对提示词的遵循程度 | 7.5平衡值 |
| 安全容忍度 | safety_tolerance | 选择 | 2 | 内容过滤严格程度 | 控制生成内容的安全过滤级别 | 2是中等程度 |
| 随机种子 | seed | 数字 | 随机 | 随机控制 | 控制随机性 | -1表示随机 |
| 生成数量 | num_images | 数字 | 1 | 输出数量 | 单次请求生成的图像数量 | 1张即可 |
3.9 Fal API Flux LoRA Config 节点
这个节点就像是"技能包配置器"，用来设置特殊绘画技能。
3.9.1 参数详解
| 参数名 (界面显示) | 参数名 (代码里) | 参数类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| LoRA地址 | url | 文本框 | 网址 | 技能包的下载地址 | LoRA模型文件的URL | 输入Hugging Face上的LoRA地址 |
| 强度 | scale | 小数 | 0.8 | 技能包影响程度，像调节特效强度 | 控制LoRA对生成结果的影响程度 | 0.8表示80%影响 |
3.10 Fal API Flux ControlNet Config 节点
这个节点就像是"构图指导配置器"，用来设置精确的构图控制。
3.10.1 参数详解
| 参数名 (界面显示) | 参数名 (代码里) | 参数类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 控制图像 | control_image | 图片 | 必填 | 用来指导构图的参考图片 | 用于控制生成图像结构的参考图像 | 连接一个边缘检测或深度图 |
| 控制模式 | control_mode | 选择 | canny | 选择构图指导的方式 | 指定ControlNet的控制模式 | canny用于边缘控制 |
| 强度 | conditioning_scale | 小数 | 0.8 | 构图指导的强度 | 控制ControlNet的影响强度 | 0.8表示强指导 |
3.11 Fal API Flux ControlNet Union Config 节点
这个节点是"高级构图指导配置器"，支持多种构图控制方式。
3.11.1 参数详解
| 参数名 (界面显示) | 参数名 (代码里) | 参数类型 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 控制图像 | control_image | 图片 | 必填 | 用来指导构图的参考图片 | 用于控制生成图像结构的参考图像 | 连接参考图像 |
| 控制模式 | control_mode | 选择 | canny | 选择构图指导的方式 | 指定ControlNet Union的控制模式 | 支持多种边缘、深度、姿态控制 |
| 强度 | conditioning_scale | 小数 | 0.8 | 构图指导的强度 | 控制ControlNet的影响强度 | 0.8表示强指导 |
| 控制权重 | control_weight | 小数 | 1.0 | 多个控制之间的权重平衡 | 在多种控制模式间分配权重 | 1.0表示完全权重 |
4. 使用技巧和建议
4.1 提示词编写技巧
- 详细描述：像给真人画师下订单一样，越详细越好
- 风格关键词：加入"油画风格"、"动漫风格"、"写实风格"等关键词
- 质量词汇：使用"高质量"、"4K"、"超清晰"等词汇提升质量
- 负面提示：虽然这个插件可能不直接支持负面提示，但可以在正面提示中说明"不要包含..."
4.2 参数调优建议
- 新手设置：生成步数25步，引导强度7.5，这是最平衡的设置
- 追求质量：可以把生成步数调到35-50步，但会更慢更贵
- 节省费用：生成步数降到15-20步，质量会稍微下降但更快
- 图片尺寸：建议使用1024x1024，这是FLUX模型的最佳尺寸
4.3 工作流程建议
- 先用基础节点：新手先用"Fal API Flux Dev"熟悉基本操作
- 逐步升级：熟悉后再尝试带LoRA或ControlNet的节点
- 保存设置：找到好的参数组合后保存为模板
- 批量测试：用固定种子测试不同参数的效果
5. 常见问题解答
Q1: 为什么显示"API密钥错误"？
A: 检查config.ini文件是否正确配置，确保密钥没有多余空格，格式正确。
Q2: 生成图片很慢怎么办？
A: 这是正常现象，云端生成需要时间。可以减少生成步数或降低图片尺寸加快速度。
Q3: 生成的图片不符合预期怎么办？
A: 尝试调整提示词，使用更详细的描述，或者调整引导强度参数。
Q4: 如何使用LoRA？
A: 首先添加"Fal API Flux LoRA Config"节点，输入LoRA地址，然后连接到支持LoRA的生成节点。