OpenAIGPTImage1 - ComfyUI Built-in Node Documentation

通过 OpenAI 的 GPT Image 端点同步生成图像。它可以根据文本提示创建新图像，或者在提供输入图像和可选蒙版时编辑现有图像。该节点支持 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，步长 16
`custom_height`	仅当 `size` 为 “Custom” 时使用。必须是 16 的倍数（仅限 GPT Image 2）（默认值：1024）	INT	否	1024 到 3840，步长 16

参数约束：

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

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

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

Source fingerprint (SHA-256): f0f0db7fd2cdf8efd2155522b289aa8f3f939fa79a6e9060b0ffbb2dd20efa1e