GPT Image 2 可以通过 ComfyUI 的官方 OpenAI Partner Node 进入节点画布，但它仍然是一次远程 OpenAI 图像 API 调用，不是下载到本机显卡上的 checkpoint。真正要先分清的是路线：当生成步骤必须待在 ComfyUI 图里，就从 Partner Node 开始；当需求只是应用或脚本里生成一张图，就直接调用 OpenAI Image API；当图像生成只是助手、多工具或代理流程中的一步，就把 Responses API 放进应用代码；当看到 GitHub 或第三方提供的自定义节点时，先审计它的端点、密钥和维护边界。
| 你要完成的任务 | 先走哪条路线 | 先停在哪个检查点 |
|---|---|---|
| 在 ComfyUI 图里调用 GPT Image 2 | 官方 OpenAI Partner Node | 节点可见、模型字段能选 gpt-image-2、账号能跑通一次请求 |
| 后端或脚本里生成/编辑一张图 | OpenAI Image API | 保存返回文件并确认尺寸、格式和错误日志 |
| 多步助手里需要图像工具 | Responses API | 确认工具调用、上下文、返回文件和用户说明都可追踪 |
| 需要第三方提供商或 GitHub 节点 | 先审计再窄测 | 端点、密钥保存、数据路径、限制、维护者和失败信息都能解释 |
不要一开始就把复杂工作流、批量任务、上采样、遮罩、参考图和第三方节点全部堆上去。最小验证顺序应该是：更新 ComfyUI 或进入 Comfy Cloud，找到 OpenAI GPT Image 节点，把 model 设成 gpt-image-2，确认 OpenAI API Key、组织验证和账号状态，然后只跑一次文生图或一次简单编辑。如果官方节点缺失、账号没有资格、或自定义节点要求使用你无法审计的服务密钥，先停下修路线，不要继续加图节点。
官方 ComfyUI 路线到底意味着什么
ComfyUI 官方文档把 GPT-Image-2 放在 OpenAI Partner Node 路线里。这个说法很关键：Partner Node 让 ComfyUI 工作流从图里调用外部模型服务，但不会把 GPT Image 2 变成一个本地模型文件。ComfyUI 负责画布、节点连接、输入输出和后处理，OpenAI 负责模型执行、账号资格、策略限制、计费和远程请求。
实际操作可以拆成三层。第一层是 ComfyUI 环境：版本、Cloud/Desktop 时序、节点库、模板导入和工作流 JSON。第二层是 OpenAI API 路线：密钥、组织验证、账单状态、模型可用性、网络和选项支持。第三层是自定义节点或提供商：维护者是谁、请求发到哪里、密钥怎么存、模型标签是否真实、数据是否会经过额外服务。只有先确认是哪一层失败，排错才不会变成反复改 prompt。
| 层级 | 谁负责 | 先查什么 |
|---|---|---|
| ComfyUI 图与节点 | 本地环境或 Comfy Cloud | 版本、节点是否导入、模板是否加载、输入输出是否连接 |
| OpenAI 模型调用 | OpenAI API 账号 | API Key、组织验证、账单状态、权限、网络和支持的参数 |
| 自定义节点路线 | 节点维护者或第三方提供商 | 端点、密钥处理、数据条款、限制、支持和失败信息 |
如果节点库里看不到 OpenAI GPT Image 节点，问题通常在 ComfyUI 版本、Cloud/Desktop 发布节奏或节点导入。若节点存在但请求报认证或权限错误，优先看 OpenAI 账号。若第三方节点能跑而官方节点不能跑，也不能证明官方路线坏了；它只说明另一个提供商路线可用，合约已经变了。
先把官方 Partner Node 跑通
最稳的设置顺序是先清空工作流，只保留必需节点。把 ComfyUI 更新到当前版本，或直接用 Comfy Cloud 打开官方模板；然后在节点库里寻找 OpenAI GPT Image 相关节点，把模型字段设为 gpt-image-2。如果文档说可用而你的环境看不到，不要先装随机插件，而是先确认版本、模板、节点缓存、Cloud/Desktop 差异和启动日志。
设置步骤可以保持很短：更新环境，确认 Partner Node 可用，添加 OpenAI GPT Image 节点，设置 gpt-image-2，写一个低风险 prompt，保存输出，然后重开工作流验证它仍然可复现。这个顺序看起来保守，但能避免把错误隐藏在多张参考图、遮罩、上采样、批量队列或后处理节点里。
| 步骤 | 目标 | 失败时不要做什么 |
|---|---|---|
| 更新 ComfyUI 或使用 Comfy Cloud | 让官方节点和模板处在同一代 | 不要用旧版本截图判断节点不存在 |
| 添加 OpenAI GPT Image 节点 | 确认官方路线可见 | 不要先装未审计插件 |
设置 gpt-image-2 | 确认调用的是目标模型 | 不要把旧 GPT Image 节点和新模型混在一起猜 |
| 运行一次文生图 | 验证最短远程调用 | 不要马上加入复杂图链 |
| 保存并重开 workflow | 验证可复现 | 不要只看一次预览结果 |
编辑流程应当放在第二个测试，而不是第一个测试。官方 ComfyUI 文档给出了 GPT-Image-2 的编辑工作流，并说明编辑路径可以处理到 2K。这个信息足够做一次真实编辑测试，但不等于 ComfyUI 节点已经暴露了所有 API 级别的 size、background 或格式控制。若目标是精确 4K 尺寸，请转到 GPT Image 2 高清图片路线，用 API 请求和保存文件验证像素。
排图之前先证明账号可用
GPT Image 2 在 ComfyUI 里仍然依赖 OpenAI API 账号。OpenAI 图像文档把 Image API、编辑接口和 Responses API 的图像工具分成不同路线，也提醒 GPT Image 模型可能需要组织验证。换句话说，即使 ComfyUI 图没有任何连线错误，账号或组织状态也可能让请求失败。
先检查五个基础条件：API Key 是否存在并能被节点读取，组织是否具备调用 GPT Image 模型的资格，账单或用量状态是否允许图像请求，本地网络或代理是否能访问远程 API，以及 ComfyUI 节点暴露的参数是否真的支持你要的尺寸、背景或编辑行为。不要把这些问题都压缩成“节点坏了”。
| 检查项 | 为什么重要 | 常见失败含义 |
|---|---|---|
| API Key | Partner Node 需要远程 OpenAI 路线 | key 缺失、过期、权限不对或没有被节点读取 |
| 组织验证 | GPT Image 模型可能要求组织准备好 | 能认证但不能调用目标模型 |
| 账单与用量 | 图像生成是账号级 API 操作 | 额度、账单、策略或账户状态拦截 |
| 网络访问 | 生成步骤不在本地执行 | 防火墙、代理、容器或桌面网络阻断 |
| 参数支持 | 节点不一定暴露全部 API 选项 | 请求的 size、background 或 edit 行为不在当前节点能力里 |
最快的隔离方式是在 ComfyUI 之外用同一个账号跑一次直接 OpenAI 图像请求。直接 API 也失败，就先修账号；直接 API 成功而 ComfyUI 失败，再查 Partner Node、模板、模型字段、环境变量和 workflow wiring。不要把这个问题写成免费额度问题；若读者真正想确认官方 API 是否免费，应转到 GPT Image 2 API 是否免费 或 免费/不限量路线审计。
文生图和编辑各跑一次最小测试
第一次文生图应该故意简单。prompt 只需要描述一个可见、低风险、容易判断的结果，例如“一个干净的技术流程板，包含 ComfyUI 图、OpenAI 远程 API、保存输出三个标签块”。不要用密集文字、品牌标志、复杂遮罩、多参考图或批量队列来做第一轮验证。你要验证的是路线，而不是最终作品质量。
第一次成功后，看三件事：节点是否调用 gpt-image-2，输出是否保存到预期路径，工作流重开后是否还能复现。只有这三项稳定，才适合加入参考图、mask、上采样、局部修图或后处理。如果保存路径不稳定，后面再复杂的图都会给运营交付留下风险。
编辑测试也要小。只放一张输入图，要求一个明确的小改动，例如改背景色、加一个简单物件或替换局部材质。目标是验证输入图路径、编辑节点、输出路径和账号权限协同工作。简单编辑失败时，复杂编辑不会提供更多真相，只会增加噪音。
这一步还会暴露本地与远程的边界。ComfyUI 图中可以有本地节点，也可以在 OpenAI Partner Node 前后做准备和后处理；但 GPT Image 2 的生成或编辑本身仍是远程模型调用。对隐私、延迟、重试、成本记录和失败恢复有要求的项目，必须把这个边界写进工作流决策。
根据任务选择 ComfyUI、Image API 或 Responses API
官方 Partner Node 的适用场景很清楚：生成步骤必须留在 ComfyUI 图里。比如参考图准备、遮罩、局部编辑、复合图、多步视觉系统、上采样、风格统一或团队需要在同一个节点画布里协作。此时把 GPT Image 2 放在图中可以减少手动导入导出的摩擦。
直接 Image API 适合应用和脚本。网页工具生成一张产品图、内部脚本批量测试 prompt、后端服务编辑一张素材，这些任务通常更需要日志、重试、成本控制、文件保存和异常分类。没有图编排价值时，引入 ComfyUI 只是多一层依赖。
Responses API 适合更大的助手流程：应用先理解用户 brief，再生成图像，随后解释修改理由、记录上下文或调用其他工具。它不是节点画布，而是应用逻辑。若团队需要的是可视化节点操作，就留在 ComfyUI；若需要的是对话、工具链和状态管理，就放在应用代码里。
| 路线 | 最适合 | 避免用于 |
|---|---|---|
| ComfyUI 官方 OpenAI Partner Node | 图节点前后都有工作流，操作者需要可视画布 | 只生成一张后端图 |
| OpenAI Image API | 应用、服务、脚本里的直接生成或编辑 | 生成结果必须继续进入 ComfyUI 节点 |
| Responses API 图像工具 | 多步助手、代理和工具链 | 人工操作者需要节点图 |
| 第三方自定义节点 | 明确需要特定提供商或团队路由 | 端点、密钥、数据和维护边界无法解释 |
安装自定义节点前先审计
自定义节点不一定有问题，但它不是官方默认路线。只要节点通过第三方提供商、网关或自有端点转发请求，调用合约就和 OpenAI Partner Node 不一样。谁收费、谁保存请求、谁处理失败、谁更新模型映射、谁负责支持，都要重新判断。
审计时不要只看截图或演示视频。先看仓库维护者、许可证、提交时间、issue 状态和安装说明。再看代码里的 endpoint、base_url、模型字段、密钥读取位置和日志输出。最后看错误处理是否保留上游状态码、请求原因和重试边界。一个把所有失败都写成“node broken”的插件，不适合作为生产路线。
| 审计问题 | 可以继续的信号 | 应该停止的信号 |
|---|---|---|
| 维护者是谁 | 维护者、许可证、发布记录和 issue 可见 | 匿名、长期不维护、只有销售页 |
| 请求发到哪里 | endpoint 与提供商明示 | 路由隐藏或绕过不明服务 |
| 密钥怎么保存 | key 在预期配置位置，不进 workflow JSON 和日志 | key 出现在示例、URL、控制台或共享图里 |
| 模型是否真实 | gpt-image-2 映射可测试 | UI 写 GPT Image 2，但实际模型不可查 |
| 失败如何呈现 | 保留认证、限制、参数、网络等原因 | 只有泛化错误 |
| 限制和数据条款 | 用量、保留、权利和支持有文档 | 只承诺方便、免费或无限 |
只有当官方路线解决不了明确需求时，才把自定义节点纳入测试。例如团队必须走某个已签约提供商、必须复用某个企业网关、或必须把现有 ComfyUI 管线接到特定账户。即使如此，也要先用一张低风险测试图验证，而不是把真实素材直接交给未知路由。
常见故障先按层分类
多数失败都能放进几个桶里。节点缺失是环境问题，模型字段缺失是版本或模板问题，认证错误是账号问题，编辑失败可能是输入图、mask 或 edit 路线问题，4K 或透明背景失败通常是参数支持边界，自定义节点异常则要看第三方路线。先分类，再动手。
| 症状 | 最可能的层 | 第一动作 |
|---|---|---|
| 找不到 OpenAI GPT Image 节点 | ComfyUI 版本、Cloud/Desktop 时序或节点导入 | 更新、重载模板、查看官方文档和启动日志 |
节点存在但没有 gpt-image-2 | 节点版本或模型列表 | 更新节点、重启、确认官方模板 |
| 认证或权限错误 | OpenAI 账号路线 | 检查 key、组织验证、账单、模型资格和网络 |
| 文生图成功但编辑失败 | 输入图或编辑 workflow | 换小图、简化 mask、去掉下游节点 |
| 自定义节点能跑但官方节点失败 | 路线不一致 | 分开判断提供商成功和 OpenAI 账号成功 |
| 4K 或透明背景失败 | 参数支持边界 | 用 API 文档和 4K 专题验证，不要假设节点支持 |
| 输出慢或不稳定 | 远程调用、账号状态或图复杂度 | 对比直接 API、一节点 workflow 和复杂图 |
不要把所有失败都归因于模型质量。ComfyUI 的图可以失败，账号可以失败，网络可以失败，第三方路线也可以失败。真正可复现的修复来自分层日志：哪一个节点、哪个请求、哪个账号、哪个参数、哪个返回状态。没有这些信息，换节点通常只是换一个未知错误。
相邻问题应该交给相邻路线
把 GPT Image 2 接入 ComfyUI 和其他问题分开，读者后续判断会更快。精确 4K 输出、size 参数、保存文件和像素验证属于 GPT Image 2 高清图片路线。ComfyUI 节点可能调用 GPT Image 2，但它不是每一个 API 尺寸控制问题的最佳入口。
官方 API 是否免费属于 GPT Image 2 API 是否免费。各种免费、无限、浏览器工具、封装站点或无登录包装是否可靠，属于 GPT Image 2 免费/不限量路线审计。这些问题不能混到 ComfyUI 设置流程里，否则第一屏会失去操作焦点。
如果目标是离开 Nano Banana Pro，转到 ComfyUI Nano Banana Pro 替代路线。替代模型选择、开源/托管/API 路线、成本和部署约束，与 GPT Image 2 官方 Partner Node 设置不是同一个任务。
实际操作可以收成一句话：需要 GPT Image 2 留在 ComfyUI 图里，就从官方 OpenAI Partner Node 开始，先验证账号和最小工作流，再决定是否改用直接 API 或审计自定义节点。
常见问题
GPT Image 2 是否已经能在 ComfyUI 中正式使用？
可以。ComfyUI 官方文档和公告把 GPT Image 2 放在 OpenAI Partner Node 路线下。需要在节点画布里调用 GPT Image 2 时，应优先使用这个官方路线，并按当前文档确认版本、模板和模型字段。
GPT Image 2 是本地 ComfyUI 模型吗？
不是。在官方 ComfyUI 路线中，ComfyUI 负责工作流编排，GPT Image 2 的生成和编辑仍通过 OpenAI 的远程模型路线完成。它不是本地 checkpoint，也不应被当成离线 GPU 推理。
应该用哪个 ComfyUI 节点？
先使用官方 OpenAI GPT Image Partner Node，并把模型字段设成 gpt-image-2。如果节点或模型选项缺失，先更新 ComfyUI、重启、查看官方模板和日志，再考虑是否需要自定义节点。
是否一定需要 OpenAI API Key？
官方 Partner Node 路线应按 OpenAI API 访问来准备：API Key、组织验证、账单或账号状态、网络访问和模型资格都要先确认。账号路线失败时，修改 ComfyUI 图通常解决不了问题。
能不能直接在 ComfyUI 里生成 4K？
不要默认假设 ComfyUI 节点暴露了所有 API 级输出选项。若目标是精确 4K 尺寸，应在 GPT Image 2 高清图片路线 中用 API size、文件保存和像素读取来验证。
GPT Image 2 自定义节点安全吗？
安全性取决于节点和路线。安装前要看维护者、端点、密钥处理、模型映射、数据条款、限制、支持和错误信息。无法解释这些边界时，不要把真实素材交给自定义节点。
ComfyUI 和直接 OpenAI API 应该怎么选？
图像步骤必须进入节点画布时选 ComfyUI。只需要应用或脚本生成一张图时选 Image API。图像生成属于多步助手、代理或工具链时选 Responses API。选择依据是工作流归属，不是哪个入口看起来更方便。
