OpenAIGPTImage1 - ComfyUI Built-in Node Documentation

通过 OpenAI 的 GPT Image 端点同步生成图像。它可以根据文本提示词创建新图像，也可以在提供输入图像和可选 mask 时编辑现有图像。该节点支持 gpt-image-1、gpt-image-1.5 和 gpt-image-2 模型，并已标记为弃用。

输入

参数	描述	数据类型	必需	范围
`提示词`	GPT Image 的文本提示词（默认值：""）	STRING	是	-
`种子`	用于生成的随机种子；后端尚未实现（默认值：0）	INT	否	0 到 2147483647
`质量`	图像质量，影响费用和生成时间（默认值：“low”）	COMBO	否	”low" "medium" "high”
`背景`	返回图像时是否包含背景（默认值：“auto”）	COMBO	否	”auto" "opaque" "transparent”
`尺寸`	图像尺寸。选择 “Custom” 以使用自定义宽度和高度（仅 GPT Image 2）（默认值：“auto”）	COMBO	否	”auto" "1024x1024" "1024x1536" "1536x1024" "2048x2048" "2048x1152" "1152x2048" "3840x2160" "2160x3840" "Custom”
`数量`	要生成的图像数量（默认值：1）	INT	否	1 到 8
`参考图像`	用于图像编辑的可选参考图像	IMAGE	否	-
`遮罩`	用于图像修复的可选遮罩（白色区域将被替换）	MASK	否	-
`模型`	要使用的 GPT Image 模型（默认值：“gpt-image-2”）	COMBO	否	”gpt-image-1" "gpt-image-1.5" "gpt-image-2”
`custom_width`	仅当 `size` 为 “Custom” 时使用。必须是 16 的倍数（仅 GPT Image 2）（默认值：1024）	INT	否	1024 到 3840, step 16
`custom_height`	仅当 `size` 为 “Custom” 时使用。必须是 16 的倍数（仅 GPT Image 2）（默认值：1024）	INT	否	1024 到 3840, step 16

参数约束：

当提供 image 时，节点使用图像编辑端点。
mask 只能在提供 image 时使用。
使用 mask 时，仅支持单张图像（批大小必须为 1）。
mask 和 image 必须尺寸相同。
自定义分辨率（size = “Custom”）仅受 gpt-image-2 模型支持。
自定义宽度和高度必须是 16 的倍数。
自定义分辨率的最长边必须小于或等于 3840。
自定义分辨率的宽高比不得超过 3:1。
自定义分辨率的总像素数必须在 655,360 到 8,294,400 之间。
gpt-image-2 模型不支持透明背景。
gpt-image-1 和 gpt-image-1.5 模型仅支持 auto、1024x1024、1024x1536 和 1536x1024 这些尺寸。其他尺寸仅受 gpt-image-2 模型支持。

输出名称	描述	数据类型
`IMAGE`	生成或编辑后的图像。多张图像会作为批次返回；如果返回的图像尺寸不同，它们会被调整为与第一张图像匹配。	IMAGE

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

Source fingerprint (SHA-256): bf588bffced6e66536b4cb54655ef6ebb9cf988d9739e3c379a8ebda1486e20a