OpenAI
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:
- You are not using the latest Development (Nightly) version of ComfyUI.
- You are using the Stable (Release) version or Desktop version of ComfyUI (which does not include the latest feature updates).
- You are using the latest Commit version of ComfyUI, but some nodes failed to import during startup.
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?
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?
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.1orlocalhost, which may mean that you cannot use the API Nodes in a ComfyUI service started with the--listenparameter 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?
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.1orlocalhostaccess is supported. - Ensure your account has enough credits.
Can API Nodes be used for free?
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?
How to purchase credits?
Please refer to the following documentation:
- Comfy Account: Find the
Usersection in the settings menu to log in. - 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. - Complete the payment through Stripe.
- Check if the credits have been updated. If not, try restarting or refreshing the page.
Are unused credits refundable?
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?
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?
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?
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?
Do credits expire?
No, your credits do not expire.
Can credits be transferred or shared?
Can credits be transferred or shared?
Can I use the same account on different devices?
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??
How can I request for my account or information to be deleted??
Email a request to support@comfy.org and we will delete your information