ComfyUI Node

Qwen-Image-Layered

Compositing layers out of thin air (PNG-keepers, this is for you)

By Runware·Created 2 years ago·Updated about a month ago· 140
Qwen-Image-Layered
  • referenceImages
  • lora
  • acceleratorOptions
  • advancedFeatures.watermark.image
  • image
positivePrompt
negativePrompt
seed0
stepsfalse
steps_value5
scheduler(default)
CFGScalefalse
CFGScale_value0.00
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.trueCFGScalefalse
settings.trueCFGScale_value0.00
ttlfalse
ttl_value60
outputFormatTIFF
outputQuality95

Qwen-Image-Layered is the image model that made the community joke that Photoshop's days were numbered. Instead of generating a flat JPEG, it outputs an RGBA image decomposed into layers - the foreground subject separated from the background with transparency, ready for compositing. The KB nails the framing: the release "read to the community as the beginning of the end for Photoshop." For anyone doing cutouts, character sheets, or sticker-style assets, a model that just returns a layered result is a workflow revolution compared to running an image through a background-removal node afterward.

The original Qwen-Image-Layered weights are Apache 2.0, so you could run this locally - but the node in front of you is the cloud version, served through Runware. The layered output lands back as a TIFF, which is exactly what you want for RGBA work.

What you set

referenceImages and positivePrompt are both required - this is an image-input model, not pure T2I. You feed it a picture and describe the layered result you want.

  • lora - a RUNWARE_LORA socket for community LoRAs (the open family has a real LoRA ecosystem).
  • steps / scheduler / CFGScale - gated diffusion controls. scheduler is a monster dropdown (76 entries) because it exposes the underlying diffusers schedulers by name. Leave them at defaults until you know what you're doing.
  • settings.trueCFGScale - a separate, "true" CFG scale; the tooltip says higher values improve prompt adherence at the cost of quality. This is the Qwen-Image quirk: it uses a non-standard guidance formulation, hence the "true" CFG slot.
  • seed - exposed and reproducible.
  • numberResults - up to 20 per run.

Output is image as IMAGE in TIFF format - save as TIFF and you keep the layers. outputFormat is locked to TIFF here (one choice), which is the giveaway that this node is fundamentally about preserving transparency.

Installing

Part of the Runware/ComfyUI-Runware pack.

ComfyUI Manager: search Runware, install, restart.

Manual:

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

Deps are runware-sdk, pillow, soundfile. Runware API key from runware.ai/api-keys (Settings panel or RUNWARE_API_KEY).

Where people get burned

Two things. First: since this is a cloud call, "send the image to Runware" means your source image leaves your machine - a real consideration for proprietary or sensitive art. Second, the output being TIFF-only catches people: if you wire this into a normal image pipeline that expects JPG/PNG, you may get a surprise, and downstream nodes that can't read multi-layer TIFFs will flatten it anyway. If you want the layers, save the TIFF immediately; if you just wanted a cutout, a background-removal node might be cheaper than a billed layered generation.

CategoryRunware/Image/alibaba

Inputs (28)

NameTypeDefaultDescription
referenceImagesIMAGE
positivePromptSTRINGText prompt describing elements to include in the generated output.
loraoptRUNWARE_LORA
acceleratorOptionsoptRUNWARE_ACCELERATOROPTIONS
advancedFeatures.watermark.imageoptIMAGE
negativePromptoptSTRINGPrompt to guide what to exclude from generation. Ignored when guidance is disabled (CFGScale ≤ 1).
seedoptINT00–9223372036854776000Random seed for reproducible generation. When not provided, a random seed is generated in the unsigned 32-bit range.
stepsoptBOOLEANfalseEnable to set steps. Off uses the model's default.
steps_valueoptINT55–50Total number of denoising steps. Higher values generally produce more detailed results but take longer.
scheduleroptCOMBO(default)Scheduler to use for the diffusion process.
CFGScaleoptBOOLEANfalseEnable to set CFGScale. Off uses the model's default.
CFGScale_valueoptFLOAT0.000–10Guidance scale representing how closely the output will resemble the prompt. Higher values produce results more aligned with the prompt.
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.trueCFGScaleoptBOOLEANfalseEnable to set settings.trueCFGScale. Off uses the model's default.
settings.trueCFGScale_valueoptFLOAT0.00True Classifier-Free Guidance scale. Higher values increase prompt adherence at the cost of quality.
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`.
outputFormatoptCOMBOTIFFFile format for the generated image.
outputQualityoptINT9520–99Compression quality of the output. Higher values preserve quality but increase file size.

Outputs (1)

NameTypeDescription
imageIMAGE