OpenAI GPT-Image-1 Node

Learn how to use the OpenAI GPT-Image-1 API node to generate images in ComfyUI

OpenAI GPT-Image-1 is part of the ComfyUI API nodes series that allows users to generate images through OpenAI’s GPT-Image-1 model. This is the same model used for image generation in ChatGPT 4o.

This node supports:

• Text-to-image generation
• Image editing functionality (inpainting through masks)

Node Overview

The OpenAI GPT-Image-1 node synchronously generates images through OpenAI’s image generation API. It receives text prompts and returns images matching the description. GPT-Image-1 is OpenAI’s most advanced image generation model currently available, capable of creating highly detailed and realistic images.

To use the API nodes, you need to ensure that you are logged in properly and using a permitted network environment. Please refer to the API Nodes Overview section of the documentation to understand the specific requirements for using the API nodes.

If you find missing nodes when loading the workflow file below, it may be due to the following situations:

1. You are not using the latest Development (Nightly) version of ComfyUI.
2. You are using the Stable (Release) version or Desktop version of ComfyUI (which does not include the latest feature updates).
3. You are using the latest Commit version of ComfyUI, but some nodes failed to import during startup.

Please make sure you have successfully updated ComfyUI to the latest Development (Nightly) version. See: How to Update ComfyUI section to learn how to update ComfyUI.

Parameter Description

Required Parameters

Parameter	Type	Description
prompt	Text	Text prompt describing the image content you want to generate

Widget Parameters

Parameter	Type	Options	Default	Description
seed	Integer	0-2147483647	0	Random seed used to control generation results
quality	Option	low, medium, high	low	Image quality setting, affects cost and generation time
background	Option	opaque, transparent	opaque	Whether the returned image has a background
size	Option	auto, 1024x1024, 1024x1536, 1536x1024	auto	Size of the generated image
n	Integer	1-8	1	Number of images to generate

Optional Parameters

Parameter	Type	Options	Default	Description
image	Image	Any image input	None	Optional reference image for image editing
mask	Mask	Mask input	None	Optional mask for inpainting (white areas will be replaced)

Usage Examples

Text-to-Image Example

The image below contains a simple text-to-image workflow. Please download the image and drag it into ComfyUI to load the corresponding workflow.

The corresponding workflow is very simple:

You only need to load the OpenAI GPT-Image-1 node, input the description of the image you want to generate in the prompt node, connect a Save Image node, and then run the workflow.

Image-to-Image Example

The image below contains a simple image-to-image workflow. Please download the image and drag it into ComfyUI to load the corresponding workflow.

We will use the image below as input:

In this workflow, we use the OpenAI GPT-Image-1 node to generate images and the Load Image node to load the input image, then connect it to the image input of the OpenAI GPT-Image-1 node.

Multiple Image Input Example

Please download the image below and drag it into ComfyUI to load the corresponding workflow.

Use the hat image below as an additional input image.

The corresponding workflow is shown in the image below:

The Batch Images node is used to load multiple images into the OpenAI GPT-Image-1 node.

Inpainting Workflow

GPT-Image-1 also supports image editing functionality, allowing you to specify areas to replace using a mask. Below is a simple inpainting workflow example:

Download the image below and drag it into ComfyUI to load the corresponding workflow. We will continue to use the input image from the image-to-image workflow section.

The corresponding workflow is shown in the image

Compared to the image-to-image workflow, we use the MaskEditor in the Load Image node through the right-click menu to draw a mask, then connect it to the mask input of the OpenAI GPT-Image-1 node to complete the workflow.

Notes

• The mask and image must be the same size
• When inputting large images, the node will automatically resize the image to an appropriate size

FAQs

Why can't I find the API nodes?

Please update your ComfyUI to the latest version (the latest commit or the latest desktop version). We may add more API support in the future, and the corresponding nodes will be updated, so please keep your ComfyUI up to date.

Please note that you need to distinguish between the nightly version and the release version. In some cases, the latest release version may not be updated in time compared to the nightly version. Since we are still iterating quickly, please ensure you are using the latest version when you cannot find the corresponding node.

Why can't I use / log in to the API Nodes?

API access requires that your current request is based on a secure network environment. The current requirements for API access are as follows:

• The local network only allows access from 127.0.0.1 or localhost, which may mean that you cannot use the API Nodes in a ComfyUI service started with the --listen parameter in a LAN environment.
• Able to access our API service normally (a proxy service may be required in some regions).
• Your account does not have enough credits.

Why can't I use API node even after logging in, or why does it keep asking me to log in while using?

• Currently, only 127.0.0.1 or localhost access is supported.
• Ensure your account has enough credits.

Can API Nodes be used for free?

API Nodes require credits for API calls to closed-source models, so they do not support free usage.

How to purchase credits?

Please refer to the following documentation:

1. Comfy Account: Find the User section in the settings menu to log in.
2. Credits: After logging in, the settings interface will show the credits menu. You can purchase credits in Settings → Credits. We use a prepaid system, so there will be no unexpected charges.
3. Complete the payment through Stripe.
4. Check if the credits have been updated. If not, try restarting or refreshing the page.

Are unused credits refundable?

Currently, we do not support refunds for credits. If you believe there is an error resulting in unused balance due to technical issues, please contact support.

Can credits go negative?

Credits cannot go negative, so please ensure you have enough credits before making the corresponding API calls.

Where can I check usage and expenses?

Please visit the Credits menu after logging in to check the corresponding credits.

Is it possible to use my own API Key?

Currently, the API Nodes are still in the testing phase and do not support this feature yet, but we have considered adding it.

Do credits expire?

No, your credits do not expire.

Can credits be transferred or shared?

No, your credits cannot be transferred to other users and are limited to the currently logged-in account, but we do not restrict the number of devices that can log in.

Can I use the same account on different devices?

We do not limit the number of devices that can log in; you can use your account anywhere you want.

How can I request for my account or information to be deleted??

Email a request to [e-mail] and we will delete your information