ComfyPilotComfyPilot
文档 / 节点说明 / OpenAIGPTImageNodeV3

OpenAIGPTImageNodeV3

OpenAI GPT Image 2.6 使用 OpenAI 的 GPT Image 模型,根据提示词生成图像,并在连接参考图像时对它们进行编辑。

节点说明 OpenAIGPTImageNodeV3 更新于 2026-11-12

查看官方原文

OpenAIGPTImageNodeV3 - ComfyUI Built-in Node Documentation

OpenAI GPT Image 2.6 使用 OpenAI 的 GPT Image 模型,根据提示词生成图像,并在连接参考图像时对它们进行编辑。

概述

OpenAI GPT Image 2.6 使用 OpenAI 的 GPT Image 模型,根据提示词生成图像,并在连接参考图像时对它们进行编辑。此节点提供四种模型:gpt-image-2.6-flare、gpt-image-2.6-sunburst、gpt-image-2.5-flare 和 gpt-image-2.5-sunburst。在第一张参考图像上绘制标注,并将它们作为标记对连接,即可向模型准确指示需要编辑的位置。

输入

通用输入

参数描述数据类型必填范围
model要使用的 GPT Image 模型。选择某个模型后会显示该模型对应的参数。DYNAMIC\_COMBO是"gpt-image-2.6-flare" "gpt-image-2.6-sunburst" "gpt-image-2.5-flare" "gpt-image-2.5-sunburst"

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

当 model 设置为 gpt-image-2.6-flare 或 gpt-image-2.6-sunburst 时,这些输入会出现。两个模型共享相同的参数。

参数描述数据类型必填范围
model.prompt要生成的内容,或要进行的编辑。(默认:"")STRING是N/A
model.size图像尺寸。选择 "Custom" 可使用自定义的宽度和高度。(默认:"auto")COMBO是"auto" "1024x1024" "1024x1536" "1536x1024" "2048x2048" "2048x1152" "1152x2048" "3840x2160" "2160x3840" "Custom"
model.custom_width仅在 model.size 为 "Custom" 时使用。必须为 16 的倍数。(默认:1024)INT否480 到 3840(步长 16)
model.custom_height仅在 model.size 为 "Custom" 时使用。必须为 16 的倍数。(默认:1024)INT否480 到 3840(步长 16)
model.background返回带背景或不带背景的图像。(默认:"auto")COMBO是"auto" "opaque" "transparent"
model.quality图像质量。级别越高,费用越高、耗时越长。(默认:"low")COMBO是"low" "medium" "high" "xhigh" "max"
model.complexity模型在渲染前对图像进行规划的程度。(默认:"high")COMBO是"low" "medium" "high"
model.images用于编辑的可选参考图像。最多 16 张。AUTOGROW否0 到 16
model.markup在第一张参考图像上绘制的标注,用于指示需要编辑的位置。必须与该图像的尺寸一致,并且必须与 model.markup_alpha 一同连接。IMAGE否N/A
model.markup_alpha白色用于标记 model.markup 中的标注。Painter 节点的 MASK 输出可直接使用;Load Image 的蒙版需先经过 Invert Mask。MASK否N/A
model.seed控制节点是否重新运行;无论种子如何,结果都是非确定性的。(默认:42)INT是0 到 2147483647

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

当 model 设置为 gpt-image-2.5-flare 或 gpt-image-2.5-sunburst 时,这些输入会出现。它们与 2.6 模型相同,只是不提供 model.complexity。

参数描述数据类型必填范围
model.prompt要生成的内容,或要进行的编辑。(默认:"")STRING是N/A
model.size图像尺寸。选择 "Custom" 可使用自定义的宽度和高度。(默认:"auto")COMBO是"auto" "1024x1024" "1024x1536" "1536x1024" "2048x2048" "2048x1152" "1152x2048" "3840x2160" "2160x3840" "Custom"
model.custom_width仅在 model.size 为 "Custom" 时使用。必须为 16 的倍数。(默认:1024)INT否480 到 3840(步长 16)
model.custom_height仅在 model.size 为 "Custom" 时使用。必须为 16 的倍数。(默认:1024)INT否480 到 3840(步长 16)
model.background返回带背景或不带背景的图像。(默认:"auto")COMBO是"auto" "opaque" "transparent"
model.quality图像质量。级别越高,费用越高、耗时越长。(默认:"low")COMBO是"low" "medium" "high" "xhigh" "max"
model.images用于编辑的可选参考图像。最多 16 张。AUTOGROW否0 到 16
model.markup在第一张参考图像上绘制的标注,用于指示需要编辑的位置。必须与该图像的尺寸一致,并且必须与 model.markup_alpha 一同连接。IMAGE否N/A
model.markup_alpha白色用于标记 model.markup 中的标注。Painter 节点的 MASK 输出可直接使用;Load Image 的蒙版需先经过 Invert Mask。MASK否N/A
model.seed控制节点是否重新运行;无论种子如何,结果都是非确定性的。(默认:42)INT是0 到 2147483647

参数约束与限制:

  • 当 model.size 设为 "Custom" 时,model.custom_width 和 model.custom_height 都必须是 16 的倍数,最长边不得超过 3840,宽高比不得超过 3:1,总像素数必须在 655,360 到 8,294,400 之间。
  • model.markup 和 model.markup_alpha 必须一同连接。标记需要至少一张参考图像,且其宽度和高度必须与第一张参考图像一致。
  • 不连接 model.images 时,节点仅根据提示词生成图像;连接参考图像时,则会对这些图像进行编辑和组合。
  • 参考图像在发送至 API 之前会被缩小。
  • model.complexity 仅存在于 gpt-image-2.6-flare 和 gpt-image-2.6-sunburst 上;2.5 模型使用固定的规划深度。

输出

输出名称描述数据类型
image生成的一张或多张图像。所有返回的图像会堆叠为一个批次;如果它们的尺寸不同,则会调整尺寸以匹配第一张图像。IMAGE
本文档由 AI 生成。如果您发现任何错误或有改进建议,欢迎贡献! 在 GitHub 上编辑

Source fingerprint (SHA-256): 33f5d91af56c215cc7f7c704f9b123fe1c35bf287012072b818b76b551c04667