OpenAIGPTImage1 - ComfyUI Built-in Node Documentation

Complete documentation for the OpenAIGPTImage1 node in ComfyUI. Learn its inputs, outputs, parameters and usage.

Generates images synchronously via OpenAI’s GPT Image endpoint. This node can create new images from text prompts or edit existing images when provided with an input image and optional mask. It supports multiple GPT Image models, including gpt-image-1, gpt-image-1.5, and gpt-image-2.

Inputs

Parameter	Description	Data Type	Required	Range
prompt	Text prompt for GPT Image (default: "")	STRING	Yes	-
seed	Random seed for generation (default: 0) - not implemented yet in backend	INT	No	0 to 2147483647
quality	Image quality, affects cost and generation time (default: “low”)	COMBO	No	”low" "medium" "high”
background	Return image with or without background (default: “auto”)	COMBO	No	”auto" "opaque" "transparent”
size	Image size. Select “Custom” to use the custom width and height (GPT Image 2 only) (default: “auto”)	COMBO	No	”auto" "1024x1024" "1024x1536" "1536x1024" "2048x2048" "2048x1152" "1152x2048" "3840x2160" "2160x3840" "Custom”
n	How many images to generate (default: 1)	INT	No	1 to 8
image	Optional reference image for image editing	IMAGE	No	-
mask	Optional mask for inpainting (white areas will be replaced)	MASK	No	-
model	GPT Image model to use (default: “gpt-image-2”)	COMBO	No	”gpt-image-1" "gpt-image-1.5" "gpt-image-2”
custom_width	Used only when size is “Custom”. Must be a multiple of 16 (GPT Image 2 only) (default: 1024)	INT	No	1024 to 3840
custom_height	Used only when size is “Custom”. Must be a multiple of 16 (GPT Image 2 only) (default: 1024)	INT	No	1024 to 3840

Parameter Constraints:

• When image is provided, the node switches to image editing mode
• mask can only be used when image is provided
• When using mask, only single images are supported (batch size must be 1)
• mask and image must be the same size
• Custom resolution (size = “Custom”) is only supported by the gpt-image-2 model
• Custom width and height must be multiples of 16
• Custom resolution aspect ratio must not exceed 3:1
• Custom resolution total pixels must be between 655,360 and 8,294,400
• Transparent background is not supported for the gpt-image-2 model
• Sizes larger than 1536x1024 (e.g., 2048x2048, 3840x2160) are only supported by the gpt-image-2 model

Outputs

Output Name	Description	Data Type
IMAGE	Generated or edited image(s)	IMAGE

This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub

---

Source fingerprint (SHA-256): e7f460fccb6c372558f9a012632804a6047ee5be78b1fc3209f255a55fe13d7c