用 FLUX.1 Fill 在 n8n 里做图像局部重绘编辑器

用 FLUX.1 Fill 在 n8n 里做图像局部重绘编辑器

一个 n8n 工作流，在浏览器里提供一个小型图像编辑器，并把每次编辑发给 Black Forest Labs 的 FLUX.1 Fill。你打开 webhook 的地址，选一张图片或载入一张，涂出要改的部分，描述那里应该出现什么，再点“生成”。结果会和原图并排，以前后对比的方式打开。

包里有什么

• workflow.json：n8n 导出的工作流，十九个节点。其中七个是便签，有一个是 Mindket 加的。里面没有任何凭据。
• README.md：这份设置说明，压缩包里的是英文版。

我们相对原来的副本改了什么

• FLUX Fill 原来调用的是 api.bfl.ml，这是该 API 的一个旧地址，Black Forest Labs 的文档已不再使用。现在它向 https://api.bfl.ai/v1/flux-pro-1.0-fill 发 POST，与文档所示一致（2026 年 11 月 12 日读取）。
• Check FLUX status 原来在那个旧地址上请求 get_result?id=。现在它轮询第一次调用返回的 polling_url，文档要求主端点这样做。
• safety_tolerance 原来是 6，在 0 最严的刻度上这是最宽松的级别。现在是 2，也就是接口的默认值。如果审核拦下了你自己的编辑，可以在 FLUX Fill 里调高。
• 编辑器的脚本和样式原来是按分支名从 jsDelivr 上的一个公开仓库加载的，所以之后推送到那里的任何内容都会在你的页面里运行。现在它们从一个固定的提交加载。来自 unpkg 的两个库也固定到了精确版本：Konva 9.3.22 和 img-comparison-slider 8.0.7。
• Mockups 原来列了五张示例照片，存放在原作者的文件存储里。现在它只有一个占位符 <YOUR_IMAGE_URL>。
• 两个 BFL 节点上指向作者凭据的关联，以及两个 webhook 的 id，都已删掉。
• 加了一张便签，说明这两个 BFL 节点现在调用什么。

开始之前

• 一个 n8n 实例，n8n Cloud 或自己的服务器都行。
• 一个 Black Forest Labs API 密钥。
• 可选：几个给编辑器列表用的公开图片地址。编辑器也能载入你电脑里的文件。

设置

1. 在 n8n 里新建一个工作流，打开它的菜单，选 Import from File，选中 workflow.json。
2. 添加一个 Header Auth 凭据，名称填 x-key，值填你的 BFL 密钥。在 FLUX Fill 和 Check FLUX status 里选中它。
3. 打开 Mockups。把 <YOUR_IMAGE_URL> 换成一个你的浏览器可以从其他网站加载的图片地址，或者删掉这一项。
4. 保存，打开 Webhook，监听一个测试事件，再在浏览器里打开它的测试地址。要正式使用，就发布工作流并打开 <YOUR_N8N_HOST>/webhook/flux-fill。

一次运行的过程

1. 打开这个地址会发出一个 GET。Webhook 把它交给 Mockups（生成图片列表）和 Merge（把这个列表和 webhook 自己的数据合在一起，其中包括页面的地址）。
2. Editor page 把列表和地址填进 HTML，Respond to Webhook 把它作为页面返回。
3. 点“生成”会向同一个地址发一个 POST，里面有图片、蒙版、提示词、步数、引导强度和是否优化提示词的选择。Webhook 的 POST 输出经过 NO OP 到达 FLUX Fill。
4. FLUX Fill 去掉图片和蒙版的 data URL 开头，把它们作为 PNG 请求发给 BFL。
5. Wait 3 sec、Check FLUX status 和 Is Ready? 每三秒循环一次，直到状态是 Ready。
6. Get Fill Image 从 result.sample 下载结果，Show the image to user 带着它自己的内容类型把它返回给页面。页面把它和原图对照显示，按钮可以把它再次用于编辑或保存。

想换个结果，改这里

• 编辑器列表里的图片：Mockups。
• 模型的设置：页面上的“步数”和“引导强度”滑块，以及 FLUX Fill 里的 output_format 和 safety_tolerance。
• 轮询的间隔：Wait 3 sec。
• 把结果存到别处：按那里的便签所建议的，在 Get Fill Image 后面加节点。
• 页面本身：Editor page 里的 HTML。

值得知道的事

• Black Forest Labs 的文档（2026 年 11 月 12 日读取）说，蒙版里的黑色区域保持不变，白色区域会被重绘。编辑器会替你画好蒙版。
• 从 n8n 1.103.0 起，webhook 返回的 HTML 在沙盒 iframe 里渲染。n8n 的文档说，那里的脚本够不到父窗口，相对地址不起作用，Basic Auth 的请求头也没有。编辑器用的是绝对地址，而 webhook 的 Allowed Origins 选项默认是 *。
• 正因为最后这一点，Webhook 上的 Basic Auth 到不了页面自己发出的 POST。这个 webhook 没有认证，和原来的副本一样，所以任何知道地址的人都能花掉你的 BFL 额度。不用时请取消发布工作流，或设置节点的 IP 允许列表。
• 任何不是 Ready 的状态，包括失败或被审核拦下的请求，都会让循环再转一圈，直到工作流 120 秒的超时让这次运行结束。
• BFL 的文档说，结果地址 10 分钟后失效，不发送 CORS 头，也不是给最终用户直接访问的。这就是工作流自己下载图片的原因。
• 每次“生成”都是一次付费的 BFL 请求。
• 页面需要能访问 unpkg 和 jsDelivr，才能加载它的脚本和样式。
• 在列表里选中那个占位图片，会显示一个错误，直到你换掉它的地址。
• 你的图片、蒙版和提示词会发给 Black Forest Labs。