OpenAI GPT 图像 2.5 - ComfyUI Built-in Node Documentation

此节点使用 OpenAI 的 GPT Image API 生成图像。它支持六种模型——gpt-image-2.6-flare、gpt-image-2.6-sunburst、gpt-image-2.5-flare、gpt-image-2.5-sunburst

此节点使用 OpenAI 的 GPT Image API 生成图像。它支持六种模型——gpt-image-2.6-flare、gpt-image-2.6-sunburst、gpt-image-2.5-flare、gpt-image-2.5-sunburst、gpt-image-2 和 gpt-image-1.5——你可以附加参考图像进行图像编辑，还可以使用遮罩指定要替换图像的哪些部分。

输入

通用输入

这些输入始终可见。

参数	描述	数据类型	必填	范围
`模型`	要使用的 OpenAI 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"` `"gpt-image-1.5"`
`提示词`	GPT Image 的文本提示词（默认：`""`）。	STRING	是	N/A
`数量`	要生成的图像数量（默认：`1`）。	INT	是	1 到 8
`种子`	用于可复现性的种子（默认：`0`）。后端尚未实现。	INT	是	0 到 2147483647

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

当 model 设置为 gpt-image-2.6-flare 或 gpt-image-2.6-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
`model.complexity`	模型在渲染前对图像进行规划的程度。较低的值返回更快，较高的值规划更多。默认：`"high"`。	COMBO	是	`"low"` `"medium"` `"high"`

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 输入

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

参数	描述	数据类型	必填	范围
`尺寸`	图像尺寸（默认：`"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	否	0 到 16
`model.mask`	用于图像修复的可选遮罩（白色区域将被替换）。需要恰好一张参考图像。	MASK	否	N/A

参数约束与限制：

当 model.size 为 "Custom" 时（仅 gpt-image-2.6-flare、gpt-image-2.6-sunburst、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.6-flare、gpt-image-2.6-sunburst、gpt-image-2.5-flare 和 gpt-image-2.5-sunburst。
model.complexity 仅适用于 gpt-image-2.6-flare 和 gpt-image-2.6-sunburst；其他模型使用固定的规划深度。
seed 目前在后端尚未实现。

输出

输出名称	描述	数据类型
`image`	生成的一张或多张图像。所有返回的图像会堆叠成一个批次；如果它们的尺寸不同，会被缩放以匹配第一张图像。	IMAGE

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

Source fingerprint (SHA-256): 36e8dbe4e35d0473ccf16482f640769e8bc30c345bc062a6785a48d7336efa03