跳转到主要内容

​
概述

Comfyui-Luck-gpt2.0 是社区用户 luckdvr 贡献的 ComfyUI 自定义节点合集，在 ComfyUI 中一键调用 API易 的两款 GPT 图像模型 —— 官转 gpt-image-2 与 官逆 gpt-image-2-all。两个节点分工明确：前者主打精细参数（分辨率、画质、mask、多参考图），后者主打 ChatGPT 一致的对话式出图体验，配合超时重试，适合放进生产级工作流。
项目信息
  • 🔗 开源地址：github.com/luckdvr/Comfyui-Luck-gpt2.0
  • 📜 许可证：Apache-2.0
  • 👤 作者：luckdvr
  • ⭐ 该项目由社区用户贡献，专为 API易 适配
同一作者的两套节点如何区分？luckdvr 为 API易 贡献了两套 ComfyUI 节点：
  • Luck Nano Banana Pro：调用 Gemini 系列（gemini-3-pro-image-preview / gemini-3.1-flash-image-preview），强调 14 张参考图与工程化超时重试
  • Luck GPT-Image 2（本页）：调用 OpenAI 系列（gpt-image-2 / gpt-image-2-all），强调双端点切换（chat_completions / images_api）与 mask 重绘

​
核心功能

双节点双路线

Comfyui-Luck gpt-image-2（官转）与 Comfyui-Luck gpt-2.0 all（官逆）各管一路，按场景自由选择

最多 5 张参考图

官转节点支持最多 5 张参考图叠加输入，满足复杂融合与风格迁移

Mask 局部重绘

支持可选 mask 输入，精准圈定重绘区域，做精细化局部编辑

多档分辨率 + 自定义尺寸

1K / 2K / 4K 预设 + 自定义尺寸（单边最大 3840px，像素数 65.5 万–829.4 万）

15 种宽高比

AUTO、1:1、2:3、3:2、3:4、4:3、4:5、5:4、9:16、16:9、21:9、1:4、4:1、1:8、8:1

画质与输出格式可选

quality（auto / low / medium / high）+ 输出格式（png / jpeg / webp）+ 压缩率 0-100

双端点切换（官逆节点）

gpt-image-2-all 节点支持 chat_completions / images_api 端点切换，兼容不同调用习惯

超时重试内建

内置超时与重试参数，应对高峰期网络抖动

​
支持的 API易 模型

模型名称模型标识对应节点用途API 文档
GPT-Image 2（官转）gpt-image-2Comfyui-Luck gpt-image-2原生 2K/4K 文生图、参考图编辑、mask 重绘查看文档
GPT-Image 2 All（官逆）gpt-image-2-allComfyui-Luck gpt-2.0 allChatGPT 一致的对话式出图，按次计费查看文档
两款模型的完整差异详解见 gpt-image-2（官转）vs gpt-image-2-all（官逆）对比文档。

​
节点参数

​
Comfyui-Luck gpt-image-2（官转）

参数名类型必填默认值说明
api_keystring是-API易 令牌，建议单独创建带用量上限的专用 Key
promptstring是-生成或编辑的文本指令
image_1 … image_5IMAGE否-参考图输入，最多 5 张
maskMASK否-可选 mask，用于局部重绘（白色区域为编辑区）
sizeenum否2K输出分辨率（1K / 2K / 4K / custom）
custom_sizestring否-size 选 custom 时生效，如 2048x3072
aspect_ratioenum否AUTO15 种宽高比之一
qualityenum否autoauto / low / medium / high
output_formatenum否pngpng / jpeg / webp
output_compressionint否800-100（仅对 jpeg / webp 生效）

​
Comfyui-Luck gpt-2.0 all（官逆）

参数名类型必填默认值说明
api_keystring是-API易 令牌
promptstring是-对话式生图指令
endpointenum否chat_completionschat_completions / images_api
response_formatenum否-b64_json / url 等
timeout_secondsint否-单次请求超时
retry_timesint否-失败重试次数

​
安装配置

1

第一步：克隆到 custom_nodes

进入 ComfyUI 安装目录：
cd ComfyUI/custom_nodes
git clone https://github.com/luckdvr/Comfyui-Luck-gpt2.0.git
2

第二步：安装依赖

cd Comfyui-Luck-gpt2.0
python3 -m pip install -r requirements.txt
3

第三步：重启 ComfyUI

在节点搜索栏输入 Luck gpt-image-2 或 Luck gpt-2.0 all 即可找到两个节点。
4

第四步：配置 API易 密钥

  • 访问 API易控制台 →【令牌】新建密钥（建议配用量上限）
  • 粘贴到节点的 api_key 参数
  • 节点默认指向 api.apiyi.com；不稳定时可切换备用域名 vip.apiyi.com / b.apiyi.com
5

第五步：导入示例工作流

仓库内提供 example_workflow.json，可直接在 ComfyUI 中导入作为工作流起点。

​
使用示例

​
示例 1：官转 4K 高质量文生图

节点: Comfyui-Luck gpt-image-2
prompt: "Cinematic portrait of a samurai in a misty bamboo forest, volumetric light, 85mm lens, photorealistic"
size: 4K
aspect_ratio: 2:3
quality: high
output_format: png

​
示例 2：mask 局部重绘（官转）

节点: Comfyui-Luck gpt-image-2
image_1: 原始照片
mask: 要替换的区域（白色为编辑区）
prompt: "replace the sky with dramatic sunset clouds, keep everything else intact"
size: 2K
quality: high

​
示例 3：官逆对话式出图

节点: Comfyui-Luck gpt-2.0 all
endpoint: chat_completions
prompt: "一位穿汉服的少女站在樱花树下，水彩画风格，柔和光线"
response_format: b64_json
timeout_seconds: 180
retry_times: 3

​
常见问题

  • gpt-image-2（官转）：参数可控、原生支持 mask、按 token 计费、分辨率 / 画质精细可调 —— 适合有明确尺寸要求或需要局部重绘的工作流
  • gpt-image-2-all（官逆）：按次计费（$0.03 / 次），对话式自然语言出图、与 ChatGPT 网页版能力一致 —— 适合多轮改图、文字还原要求高的场景
  • 完整差异看 官转 vs 官逆 对比文档
  1. 确认目录 ComfyUI/custom_nodes/Comfyui-Luck-gpt2.0 存在
  2. pip install -r requirements.txt 无报错
  3. 完全重启 ComfyUI（只刷新前端不够）
官逆 gpt-image-2-all 的 b64_json 字段会带 data:image/png;base64, 前缀，而官转 gpt-image-2 不带。详细说明见 官转 vs 官逆 对比文档。
  1. 检查 api_key 是否正确，是否被分组限制误拦
  2. 所选模型是否在令牌的白名单内
  3. 余额问题参考 为什么还有余额跑不通

​
相关资源

gpt-image-2（官转）文档

原生 2K/4K 高清生图，按 token 计费

gpt-image-2-all（官逆）文档

ChatGPT 一致体验，$0.03 / 次按次计费

官转 vs 官逆 对比

17 个维度一表看清两款模型的差异

ComfyUI 节点合集

查看更多 API易 适配的 ComfyUI 节点

Luck Nano Banana Pro（同作者）

luckdvr 的 Gemini 系列 ComfyUI 节点

APIYI GPT-Image 2 Skills（同模型）

两款 GPT 图像模型的 AI Agent Skill 封装版本

API易控制台

管理密钥、用量与分组