ComfyUI Node

GPT Image 1 Mini

The cheap seat on the text-rendering train

By Runware·Created 2 years ago·Updated about a month ago· 140
GPT Image 1 Mini
  • referenceImages
  • advancedFeatures.watermark.image
  • image
positivePrompt
size1K (1:1)
numberResults1
advancedFeaturesfalse
advancedFeatures.watermark.bgColor
advancedFeatures.watermark.displayPosition(default)
advancedFeatures.watermark.fontColor
advancedFeatures.watermark.opacityfalse
advancedFeatures.watermark.opacity_value0.10
advancedFeatures.watermark.text
providerSettings.openai.backgroundauto
providerSettings.openai.moderationauto
providerSettings.openai.qualityauto
safetyfalse
safety.checkContentfalse
ttlfalse
ttl_value60
outputFormatJPG
outputQuality95

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 - IMAGE socket, so it still does image-to-image and natively multimodal edits.
  • providerSettings.openai.quality - auto, high, medium, low. Set high if you're using Mini for something that actually needs to be good.
  • providerSettings.openai.background - auto, opaque, transparent.
  • providerSettings.openai.moderation - auto or low.
  • 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: auto will refuse prompts the same way its pricier sibling does. The filter doesn't get cheaper.
  • Default JPG. If you enabled background: transparent, flip outputFormat to PNG or 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.

CategoryRunware/Image/openai

Inputs (21)

NameTypeDefaultDescription
positivePromptSTRINGText prompt describing elements to include in the generated output.
referenceImagesoptIMAGE
advancedFeatures.watermark.imageoptIMAGE
sizeoptCOMBO1K (1:1)Output size. Only one of resolution or dimensions is sent.
numberResultsoptINT11–20Number of results to generate. Each result uses a different seed, producing variations of the same parameters.
advancedFeaturesoptBOOLEANfalseEnable to set advancedFeatures. Off uses the model's default.
advancedFeatures.watermark.bgColoroptSTRINGBackground color in hex format.
advancedFeatures.watermark.displayPositionoptCOMBO(default)Watermark position.
advancedFeatures.watermark.fontColoroptSTRINGText color in hex format.
advancedFeatures.watermark.opacityoptBOOLEANfalseEnable to set advancedFeatures.watermark.opacity. Off uses the model's default.
advancedFeatures.watermark.opacity_valueoptFLOAT0.100.1–1Watermark opacity.
advancedFeatures.watermark.textoptSTRINGWatermark text.
providerSettings.openai.backgroundoptCOMBOautoBackground handling in generated images.
providerSettings.openai.moderationoptCOMBOautoContent moderation level.
providerSettings.openai.qualityoptCOMBOautoImage quality level.
safetyoptBOOLEANfalseEnable to set safety. Off uses the model's default.
safety.checkContentoptBOOLEANfalseEnable or disable content safety checking.
ttloptBOOLEANfalseEnable to set ttl. Off uses the model's default.
ttl_valueoptINT60Time-to-live (TTL) in seconds for generated content. Only applies when `outputType` is `URL`.
outputFormatoptCOMBOJPGFile format for the generated image.
outputQualityoptINT9520–99Compression quality of the output. Higher values preserve quality but increase file size.

Outputs (1)

NameTypeDescription
imageIMAGE