GPT Image 1 Mini
The cheap seat on the text-rendering train
- referenceImages
- advancedFeatures.watermark.image
- image
GPT Image 1 Mini is the budget member of OpenAI's image family, and the Runware pack wraps it in exactly the same node shape as its bigger siblings. Same required inputs, same IMAGE output, same wiring. What changes is the price and the ceiling: Mini is dramatically cheaper per image and correspondingly less ambitious. You use it when you want GPT's reliable text rendering and clean composition for a quick asset - a mockup, a thumbnail, an inpainting pass - without paying full-fat rates.
The honest framing from the KB's closed-source-models essay: these closed models win on things like legible text, and you trade away open weights, control, and (with OpenAI's guardrails) some prompts. Mini is the version of that trade where at least the bill is small.
What you actually set
positivePrompt- required. Mini handles straightforward instructions fine; don't ask it for a 17-element scene it has to cram in.width/height- default 1024×1024.referenceImages-IMAGEsocket, so it still does image-to-image and natively multimodal edits.providerSettings.openai.quality-auto,high,medium,low. Sethighif you're using Mini for something that actually needs to be good.providerSettings.openai.background-auto,opaque,transparent.providerSettings.openai.moderation-autoorlow.numberResults- up to 4 variations.
Output: one image socket, type IMAGE, into Preview or Save. Two-node workflow, same as the other OpenAI image nodes.
Install
The pack-wide routine, one time: ComfyUI Manager → search Runware → install → restart, or
cd ComfyUI/custom_nodes
git clone https://github.com/Runware/ComfyUI-Runware
pip install -r ComfyUI-Runware/requirements.txt
Then a Runware API key into ComfyUI Settings → Runware API key (or RUNWARE_API_KEY). Nothing else installs; the models live on Runware's side.
Where people get burned
- "Mini" is a quality promise, not just a price tag. If you're used to GPT Image 1 and drop Mini in, the detail gap on complex scenes will surprise you. Use it for what it's for - cheap, decent images - not for hero shots.
- Moderation still applies.
moderation: autowill refuse prompts the same way its pricier sibling does. The filter doesn't get cheaper. - Default JPG. If you enabled
background: transparent, flipoutputFormattoPNGor your alpha silently disappears.
The takeaway: this is the node to reach for when the image is a means to an end - a placeholder, a draft, a comp - and you'd rather not spend full-size money on it. When the image is the deliverable, step up.
Inputs (21)
| Name | Type | Default | Description |
|---|---|---|---|
| positivePrompt | STRING | Text prompt describing elements to include in the generated output. | |
| referenceImagesopt | IMAGE | — | |
| advancedFeatures.watermark.imageopt | IMAGE | — | |
| sizeopt | COMBO | 1K (1:1) | Output size. Only one of resolution or dimensions is sent. |
| numberResultsopt | INT | 11–20 | Number of results to generate. Each result uses a different seed, producing variations of the same parameters. |
| advancedFeaturesopt | BOOLEAN | false | Enable to set advancedFeatures. Off uses the model's default. |
| advancedFeatures.watermark.bgColoropt | STRING | Background color in hex format. | |
| advancedFeatures.watermark.displayPositionopt | COMBO | (default) | Watermark position. |
| advancedFeatures.watermark.fontColoropt | STRING | Text color in hex format. | |
| advancedFeatures.watermark.opacityopt | BOOLEAN | false | Enable to set advancedFeatures.watermark.opacity. Off uses the model's default. |
| advancedFeatures.watermark.opacity_valueopt | FLOAT | 0.100.1–1 | Watermark opacity. |
| advancedFeatures.watermark.textopt | STRING | Watermark text. | |
| providerSettings.openai.backgroundopt | COMBO | auto | Background handling in generated images. |
| providerSettings.openai.moderationopt | COMBO | auto | Content moderation level. |
| providerSettings.openai.qualityopt | COMBO | auto | Image quality level. |
| safetyopt | BOOLEAN | false | Enable to set safety. Off uses the model's default. |
| safety.checkContentopt | BOOLEAN | false | Enable or disable content safety checking. |
| ttlopt | BOOLEAN | false | Enable to set ttl. Off uses the model's default. |
| ttl_valueopt | INT | 60 | Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`. |
| outputFormatopt | COMBO | JPG | File format for the generated image. |
| outputQualityopt | INT | 9520–99 | Compression quality of the output. Higher values preserve quality but increase file size. |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| image | IMAGE | — |