Luck GPT-Image 2 - ComfyUI 节点

文档说明

社区贡献的双节点合集：一键在 ComfyUI 调用 gpt-image-2（官转）与 gpt-image-2-all（官逆），覆盖文生图、参考图编辑、mask 重绘、自定义分辨率。

概述

Comfyui-Luck-gpt2.0 是社区用户 luckdvr 贡献的 ComfyUI 自定义节点合集，在 ComfyUI 中一键调用 FastAiToken 的两款 GPT 图像模型 —— 官转 gpt-image-2 与 官逆 gpt-image-2-all。两个节点分工明确：前者主打精细参数（分辨率、画质、mask、多参考图），后者主打 ChatGPT 一致的对话式出图体验，配合超时重试，适合放进生产级工作流。

项目信息

• 🔗 开源地址：github.com/luckdvr/Comfyui-Luck-gpt2.0
• 📜 许可证：Apache-2.0
• 👤 作者：luckdvr
• ⭐ 该项目由社区用户贡献，专为 FastAiToken 适配

同一作者的两套节点如何区分？

luckdvr 为 FastAiToken 贡献了两套 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 张参考图叠加输入，满足复杂融合与风格迁移 支持可选 mask 输入，精准圈定重绘区域，做精细化局部编辑 1K / 2K / 4K 预设 + 自定义尺寸（单边最大 3840px，像素数 65.5 万–829.4 万） 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 端点切换，兼容不同调用习惯 内置超时与重试参数，应对高峰期网络抖动

支持的 FastAiToken 模型

模型名称	模型标识	对应节点	用途	API 文档
GPT-Image 2（官转）	gpt-image-2	Comfyui-Luck gpt-image-2	原生 2K/4K 文生图、参考图编辑、mask 重绘	查看文档
GPT-Image 2 All（官逆）	gpt-image-2-all	Comfyui-Luck gpt-2.0 all	ChatGPT 一致的对话式出图，按次计费	查看文档

两款模型的完整差异详解见 gpt-image-2（官转）vs gpt-image-2-all（官逆）对比文档。

节点参数

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

参数名	类型	必填	默认值	说明
api_key	string	是	-	FastAiToken 令牌，建议单独创建带用量上限的专用 Key
prompt	string	是	-	生成或编辑的文本指令
image_1 … image_5	IMAGE	否	-	参考图输入，最多 5 张
mask	MASK	否	-	可选 mask，用于局部重绘（白色区域为编辑区）
size	enum	否	2K	输出分辨率（1K / 2K / 4K / custom）
custom_size	string	否	-	size 选 custom 时生效，如 2048x3072
aspect_ratio	enum	否	AUTO	15 种宽高比之一
quality	enum	否	auto	auto / low / medium / high
output_format	enum	否	png	png / jpeg / webp
output_compression	int	否	80	0-100（仅对 jpeg / webp 生效）

Comfyui-Luck gpt-2.0 all（官逆）

参数名	类型	必填	默认值	说明
api_key	string	是	-	FastAiToken 令牌
prompt	string	是	-	对话式生图指令
endpoint	enum	否	chat_completions	chat_completions / images_api
response_format	enum	否	-	b64_json / url 等
timeout_seconds	int	否	-	单次请求超时
retry_times	int	否	-	失败重试次数

安装配置

进入 ComfyUI 安装目录：

cd ComfyUI/custom_nodes
git clone https://github.com/luckdvr/Comfyui-Luck-gpt2.0.git

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

在节点搜索栏输入 Luck gpt-image-2 或 Luck gpt-2.0 all 即可找到两个节点。 * 访问 FastAiToken控制台 →【令牌】新建密钥（建议配用量上限） * 粘贴到节点的 api_key 参数 * 节点默认指向 api.fastaitoken.com；不稳定时可切换备用域名 vip.fastaitoken.com / b.fastaitoken.com 仓库内提供 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（只刷新前端不够）
• 调大官逆节点的 timeout_seconds 参数
• 服务器网络慢可参考 下载 CDN 图片/视频很慢怎么办
• 默认域名不稳时可切换到备用 vip.fastaitoken.com / b.fastaitoken.com 官逆 gpt-image-2-all 的 b64_json 字段会带 data:image/png;base64, 前缀，而官转 gpt-image-2 不带。详细说明见 官转 vs 官逆 对比文档。 1. 检查 api_key 是否正确，是否被分组限制误拦 2. 所选模型是否在令牌的白名单内 3. 余额问题参考 为什么还有余额跑不通

相关资源

原生 2K/4K 高清生图，按 token 计费 ChatGPT 一致体验，$0.03 / 次按次计费 17 个维度一表看清两款模型的差异 查看更多 FastAiToken 适配的 ComfyUI 节点 luckdvr 的 Gemini 系列 ComfyUI 节点 两款 GPT 图像模型的 AI Agent Skill 封装版本 管理密钥、用量与分组