OpenAIGPTImageNodeV3 - ComfyUI Built-in Node Documentation - ComfyUI

概述

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