ComfyUI 已有官方 OpenAI GPT Image 2.5 节点，可以选择 Flare 或 Sunburst，完成文生图、参考图编辑和蒙版编辑。它属于 Partner Node：图片生成在远端进行，使用 Comfy 账号与积分，不需要下载 GPT Image 2.5 checkpoint，也不能把 OpenAI API Key 或第三方平台令牌直接当作该节点的登录凭据。ComfyUI 官方中文指南
如果你希望把生成结果继续接入 ComfyUI 的图片处理流程，可以从官方模板开始。本文依据 2026 年 9 月 21 日核验的文档和节点源码说明操作与限制，未在本机安装运行，也未进行付费生成测试；配图仅用于说明工作流。
找不到节点时，先查版本和登录状态
官方教程要求 ComfyUI 0.35.0 或更新版本，并提供四个涵盖生成与编辑的模板。不同发布渠道的节点和模板可能并不同步：教程中已经出现的功能，稳定版安装里可能还没更新。因此，打开模板后显示缺失节点时，先检查 ComfyUI 核心版本与更新渠道，再判断是否需要更新，不要一开始就到处安装名称相似的第三方插件。官方版本与模板说明
在模板库中查找 GPT Image 2.5，或在添加节点的搜索中查找 OpenAI GPT Image 2.5。用于识别工作流的内部节点 ID 是 OpenAIGPTImageNodeV2；这个名字不是本地模型文件名。
Partner Nodes 的使用还取决于账号与积分：
- 在 Settings → User 登录 Comfy 账号。
- 在 Settings → Credits 确认积分余额大于 0。
- 从本机回环地址访问时，可以使用直接登录流程；通过局域网地址或非白名单站点访问时，按官方说明使用 ComfyUI Account API Key。
Account API Key 用于账号访问，不能与发布节点到 Registry 所用的 key 混为一谈。具体入口与访问条件见 Partner Nodes 概览。ChatGPT 订阅也不能代替这里的 Comfy 积分。
官方节点通过 Comfy 的代理路径发送请求，当前实现没有供用户任意填写第三方 base URL 的公开字段。因此，手头已有某家 API 平台的 key，并不意味着可以直接填入这个节点。第三方自定义节点若提供独立接口配置，其凭据、计费和维护责任需要另行核查，不能套用本篇官方节点的步骤。官方节点实现
先生成一张能保存的图片
第一次配置建议只保留生成和保存这两个环节，避免在复杂工作流里同时排查多个问题。
- 加载官方文生图模板，确认 GPT Image 2.5 节点没有缺失。
- 选择
gpt-image-2.5-flare或gpt-image-2.5-sunburst。前者的官方定位侧重速度，后者侧重精确编辑；它们都支持根据文字生成图片。 - 填写完整提示词，例如：“一只白色陶瓷咖啡杯放在浅色木桌上，柔和晨光，背景简洁，画面右上留白，不出现文字。”
- 先选择
1024x1024、medium，生成数量n设为1，便于检查结果。 - 将节点的图片输出连接到 Save Image，执行工作流，等待节点实际返回图片。
- 检查 Save Image 的结果，并到当前环境配置的输出位置打开文件；远程部署的文件不一定自动下载到你的电脑。
这是一组依据文档整理的起始设置，不代表已经测得的最佳画质或成本。需要比较模型时，可先保留相同的提示词、尺寸和质量；更完整的选择依据见 Flare 与 Sunburst 的速度、编辑和成本比较。
当前节点源码提供 low、medium、high、xhigh、max 五个质量选项，生成数量 n 的范围是 1–8。直接 API 的参数列表和 ComfyUI 节点界面并不完全一样：不能因为 API 文档列有 auto，就在没有该选项的节点中照填。GPT Image 2.5 节点参数
接入参考图后，工作流就进入图片编辑
不连接参考图时，当前实现调用图片生成接口；连接参考图后则调用图片编辑接口。你不需要再去加载一个本地大模型，但需要确保输入图片已进入正确的节点接口。
例如，要将商品照片的背景改成浅灰色，可以用 Load Image 读取商品图，将图片输出连到 GPT Image 2.5 的参考图输入，并在提示词中明确“改变什么”和“保留什么”：
“将背景替换为浅灰色摄影棚背景，保留商品的外形、标签文字、材质和拍摄角度，不添加新的装饰。
这个要求比“美化一下”更容易检查，但模型仍可能改变不希望变化的细节。输出后应将商品轮廓、标签和接缝与原图对照，而不是只看新背景是否好看。
当前官方实现允许最多 16 张参考图；上传前，会将参考图缩放到不超过 2048×2048 的总像素面积，即 4,194,304 像素，并保留相应比例。因此，把超高分辨率原图接入节点，不等于模型会按原始尺寸读取全部细节。参考图数量与预处理源码
多张参考图适合提供不同的内容依据，但不能推导出角色或商品会绝对一致。对商品交付任务，先说明每张图承担的作用，例如第一张提供主体、第二张提供背景氛围，并对最终输出进行检查。
蒙版的白色区域表示要修改的位置
在 ComfyUI 的这个官方节点中，白色蒙版标记希望编辑的区域。例如只改咖啡杯的颜色，可以在蒙版中将杯身涂白，其他区域保留黑色，再将蒙版接到节点的 mask 输入。提示词仍然要说明目标修改和需要保留的内容。
不要把这条规则与直接调用 Images API 时的透明像素规则混用。官方节点源码在准备上传图片时，将 ComfyUI 蒙版转换为 alpha，使用的是 1 - mask；所以在 ComfyUI 画布中看到的白色区域，会按接口所需的透明区域语义处理。蒙版转换实现
还有一个关键限制：使用 mask 时必须恰好连接一张参考图。多张参考图与蒙版并用不符合当前节点校验要求。出现对应报错时，应先检查参考图数量，不能只反转蒙版颜色反复尝试。
蒙版用于引导修改，不是锁住其他区域像素的开关。检查时，除了确认白色区域是否改对，还要核对区域外的商品信息和背景有没有意外变化。如果交付要求是区域外逐像素完全不动，可将生成结果作为局部素材，再用常规合成流程保留原图；不能仅凭选了 Sunburst 就承诺完全不变。
自定义尺寸要同时通过几项限制
常见预设尺寸适合先验证连接。使用自定义宽高时，不能只看两个输入框是否接受数字；当前节点还会检查尺寸组合。依据本轮读取的实现，约束包括：
| 检查项 | 当前节点要求 |
|---|---|
| 宽度与高度 | 都是 16 的倍数，界面最小边长为 480 |
| 最长边 | 不超过 3,840 像素 |
| 长宽比 | 长边与短边之比不超过 3∶1 |
| 总像素 | 宽×高介于 655,360 与 8,294,400 之间 |
这些条件须同时满足。例如 3840x2160 的总像素正好是 8,294,400，也是实现中列出的预设；3840x3840 虽然两边都没有超过 3,840，却有 14,745,600 像素，超过总面积上限。480x480 虽然满足界面边长下限，总像素却不足 655,360，仍不能通过完整校验。尺寸预设及校验源码
因此，“支持 4K”不能直接理解成任意 4K 方图都能生成。先按交付比例选一个合法尺寸，再决定是否需要后续缩放或裁切。
seed、显卡和自动化连接，哪些不能想当然
固定 seed 不能保证复现同一张图片。 当前官方源码明确说明后端没有实现 seed；即使工作流保存了相同数字，也不能把它当作稳定重现或严格 A/B 对比的控制变量。需要留档时，应保存输入图、提示词、模型、参数和实际结果。seed 参数说明
远程生图不代表整条工作流都不需要本地算力。 GPT Image 2.5 节点本身通过 API 生成图片，没有待下载的本地权重；但后面接入的放大、分割或其他本地模型仍可能需要显存和相应依赖。诊断显存问题时，要先看是哪个节点报错。
能从 n8n 调用 ComfyUI，也不等于旧工作流可以直接调用这个官方节点。 历史教程可能使用本地 SDXL、Flux 或社区节点，不能据此推定 Comfy Partner Node 的账号认证会随导出的工作流自动透传。若只是做自动化生图，应先明确自己需要的是直接调用图片 API，还是必须串联 ComfyUI 的后处理节点；后一种情况还要验证部署环境的认证与任务完成机制。
最后按最短路径排查：节点缺失看版本与模板，登录失败看访问地址与 Comfy 账号方式，请求被拒看积分和错误信息，蒙版错误看参考图数量，尺寸错误看全部约束。只有图片真正返回并保存，才继续添加复杂的编辑和后处理步骤。
