ComfyUI Node

UNI-1

The image model that will Google for you before it draws

By Runware·Created 2 years ago·Updated about a month ago· 140
UNI-1
  • seedImage
  • referenceImages
  • advancedFeatures.watermark.image
  • image
positivePrompt
size3K (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
safetyfalse
safety.checkContentfalse
settings.searchfalse
settings.styleauto
ttlfalse
ttl_value60
outputFormatJPG
outputQuality95

Luma's UNI-1 is a text-to-image model with one feature nobody else in the pack has: a settings.search toggle that makes it search the web for visual references before it generates. Turn it on, prompt a specific landmark or product, and instead of hallucinating a plausible-looking wrong version, the model grounds itself in what's actually out there. For "generate a poster of the Sydney Opera House" work, that's a genuinely useful difference.

The catch is the same one that greets every Luma model in this community: it's closed. When a UNI-1 announcement hit the local-generation subreddit, the top reply was basically "not local, not open source, not relevant." Fair. This node doesn't change that - it's the hosted model rented by the generation through Runware's cloud, part of the ComfyUI-Runware pack. You get Luma's quality and its search grounding, and in exchange you take its alignment and its meter.

How it works

The node sends model AIR luma:uni@1 with an imageInference task over REST via the runware-sdk, and the image returns as a native IMAGE output. The inputs worth knowing:

  • positivePrompt - required.
  • seedImage - an IMAGE socket for image-guided generation; referenceImages for additional conditioning.
  • settings.search - the headline toggle: web search for visual references before generating. Good for real-world subjects, landmarks, products.
  • settings.style - a style preset, default auto.
  • width / height - 1024 default; numberResults 1–4.
  • watermark socket for watermarked output.

Output is one image socket, type IMAGE, into Preview Image or Save Image. Default format JPG at quality 95; PNG for lossless.

Installing it

Standard pack install:

cd ComfyUI/custom_nodes
git clone https://github.com/Runware/ComfyUI-Runware
pip install -r ComfyUI-Runware/requirements.txt

Restart, set your key via ComfyUI Settings → Runware API key, RUNWARE_API_KEY, or runware auth login. No model files - only the SDK, pillow, and soundfile.

Where people get burned

Expecting local behavior from a hosted model. settings.search is a network call inside a generation - it makes the queue slower and possibly pricier, so keep it off for abstract or fictional subjects where there's nothing to search. And don't assume UNI-1's look matches Luma's public demo reels exactly; hosted image tiers drift from marketing. If a prompt comes back softer than the hype, that's the alignment/compression reality of renting a closed model, and the Max tier is the pack's upgrade path.

CategoryRunware/Image/luma

Inputs (21)

NameTypeDefaultDescription
positivePromptSTRINGText prompt describing elements to include in the generated output.
seedImageoptIMAGE
referenceImagesoptIMAGE
advancedFeatures.watermark.imageoptIMAGE
sizeoptCOMBO3K (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.
safetyoptBOOLEANfalseEnable to set safety. Off uses the model's default.
safety.checkContentoptBOOLEANfalseEnable or disable content safety checking.
settings.searchoptBOOLEANfalseWhen enabled, the model searches the web for visual references before generating. This improves accuracy for prompts that reference real-world subjects, landmarks, or products.
settings.styleoptCOMBOautoApplies a style preset to the generation.
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