OpenAIGPTImageNodeV2 - ComfyUI Built-in Node Documentation

此节点使用 OpenAI 的 GPT Image API 生成图像。

此节点使用 OpenAI 的 GPT Image API 生成图像。它支持五种模型 — gpt-image-2.5-flare、gpt-image-2.5-sunburst、gpt-image-2、gpt-image-1.5 和 gpt-image-1 — 允许附加参考图像进行图像编辑，并可使用蒙版指定图像中需要替换的部分。

​

输入

​

通用输入

这些输入始终可见。

参数	描述	数据类型	必填	范围
模型	要使用的 OpenAI GPT Image 模型。选择模型后会显示该模型特有的其他参数。	DYNAMIC_COMBO	是	"gpt-image-2.5-flare" "gpt-image-2.5-sunburst" "gpt-image-2" "gpt-image-1.5" "gpt-image-1"
提示词	GPT Image 的文本提示词（默认值：""）。	STRING	是	N/A
数量	要生成的图像数量（默认值：1）。	INT	是	1到8
种子	用于结果可复现的随机种子（默认值：0）。后端尚未实现此参数。	INT	是	0到2147483647

​

gpt-image-2.5-flare 和 gpt-image-2.5-sunburst 输入

当 model 设置为 gpt-image-2.5-flare 或 gpt-image-2.5-sunburst 时显示这些输入。两个模型共享同一组参数。

参数	描述	数据类型	必填	范围
尺寸	图像尺寸。选择“Custom”可使用自定义宽度和高度（默认值："auto"）。	COMBO	是	"auto" "1024x1024" "1024x1536" "1536x1024" "2048x2048" "2048x1152" "1152x2048" "3840x2160" "2160x3840" "Custom"
自定义宽度	仅当 model.size 为“Custom”时使用。必须是 16 的倍数（默认值：1024）。	INT	否	480到3840（步长 16）
自定义高度	仅当 model.size 为“Custom”时使用。必须是 16 的倍数（默认值：1024）。	INT	否	480到3840（步长 16）
背景	返回带或不带背景的图像（默认值："auto"）。	COMBO	是	"auto" "opaque" "transparent"
质量	图像质量，影响成本和生成时间（默认值："low"）。	COMBO	是	"low" "medium" "high" "xhigh" "max"
model.images	用于图像编辑的可选参考图像。最多 16 张。详见“参考输入”。	IMAGE	否	0到16
model.mask	用于局部重绘的可选蒙版（白色区域将被替换）。必须恰好有一张参考图像。	MASK	否	N/A

​

gpt-image-2 输入

当 model 设置为 gpt-image-2 时显示这些输入。

参数	描述	数据类型	必填	范围
尺寸	图像尺寸。选择“Custom”可使用自定义宽度和高度（默认值："auto"）。	COMBO	是	"auto" "1024x1024" "1024x1536" "1536x1024" "2048x2048" "2048x1152" "1152x2048" "3840x2160" "2160x3840" "Custom"
自定义宽度	仅当 model.size 为“Custom”时使用。必须是 16 的倍数（默认值：1024）。	INT	否	480到3840（步长 16）
自定义高度	仅当 model.size 为“Custom”时使用。必须是 16 的倍数（默认值：1024）。	INT	否	480到3840（步长 16）
背景	返回带或不带背景的图像（默认值："auto"）。	COMBO	是	"auto" "opaque"
质量	图像质量，影响成本和生成时间（默认值："low"）。	COMBO	是	"low" "medium" "high"
model.images	用于图像编辑的可选参考图像。最多 16 张。详见“参考输入”。	IMAGE	否	0到16
model.mask	用于局部重绘的可选蒙版（白色区域将被替换）。必须恰好有一张参考图像。	MASK	否	N/A

​

gpt-image-1.5 和 gpt-image-1 输入

当 model 设置为 gpt-image-1.5 或 gpt-image-1 时显示这些输入。两个模型共享同一组参数。

参数	描述	数据类型	必填	范围
尺寸	图像尺寸（默认值："auto"）。	COMBO	是	"auto" "1024x1024" "1024x1536" "1536x1024"
背景	返回带或不带背景的图像（默认值："auto"）。	COMBO	是	"auto" "opaque" "transparent"
质量	图像质量，影响成本和生成时间（默认值："low"）。	COMBO	是	"low" "medium" "high"
model.images	用于图像编辑的可选参考图像。最多 16 张。详见“参考输入”。	IMAGE	否	0到16
model.mask	用于局部重绘的可选蒙版（白色区域将被替换）。必须恰好有一张参考图像。	MASK	否	N/A

​

参考输入

参数	描述	数据类型	必填	范围
model.images	可扩展插槽：连接 1..N 个项目（例如 image_1…image_16）；所有模型最多支持 16 张参考图像。	IMAGE	否	1到16
model.mask	用于局部重绘的可选蒙版（白色区域将被替换）。必须恰好有一张参考图像。	MASK	否	N/A

参数约束与限制：

• 当 model.size 为“Custom”时（仅限 gpt-image-2.5-flare、gpt-image-2.5-sunburst 和 gpt-image-2），model.custom_width 和 model.custom_height 都必须为 16 的倍数，最长边不得超过 3840，宽高比不得超过 3:1，总像素数必须在 655,360到8,294,400 之间。
• model.mask 要求在 model.images 中恰好有一张参考图像：没有图像时不能使用，有多个图像时也不能使用。
• 使用 model.mask 时，其高度和宽度必须与参考图像的高度和宽度一致。
• 提供 model.images 时，节点会以图像编辑模式运行；未提供 model.images 时，仅根据提示词生成图像。
• 参考图像和蒙版在发送到 API 之前会被缩小。
• "xhigh" 和 "max" 质量等级仅适用于 gpt-image-2.5-flare 和 gpt-image-2.5-sunburst。
• "transparent" 背景选项可用于 gpt-image-2.5-flare、gpt-image-2.5-sunburst、gpt-image-1.5 和 gpt-image-1，但不适用于 gpt-image-2。
• seed 当前尚未在后端实现。

​

输出

输出名称	描述	数据类型
image	生成的图像。所有返回的图像会被堆叠为一个批次；如果尺寸不同，则会调整大小以匹配第一张图像。	IMAGE

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ 在 GitHub 上编辑

---

Source fingerprint (SHA-256): 4f77b79f9f432a1f2e0fd814012aebe7cc42a8aa983ee9a61f3b32984bf65148