ComfyUI Node

Z-Image

Z-Image in the cloud — the 'SDXL 2.0' you can also afford to skip local for

By Runware·Created 2 years ago·Updated about a month ago· 140
Z-Image
  • seedImage
  • maskImage
  • outpaint
  • lora
  • ultralytics
  • acceleratorOptions
  • advancedFeatures.watermark.image
  • image
positivePrompt
width1024
height1024
negativePrompt
seed0
stepsfalse
steps_value1
scheduler(default)
CFGScalefalse
CFGScale_value0.00
strengthfalse
strength_value0.80
maskMarginfalse
maskMargin_value32
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
ttlfalse
ttl_value60
outputFormatJPG
outputQuality95

Z-Image is the rare case where this pack wraps a model you can actually run yourself. Alibaba Tongyi-MAI's 6B image model is Apache 2.0, fits on a 12GB card, and generated the "Z-Image on 3060, 30 sec per gen" moment that killed Flux 2's launch hype. The community literally started calling it SDXL 2.0. So why use it through Runware? Because the model being small is exactly why the cloud version is cheap and instant - no 30-second local waits, no VRAM juggling, no scheduler fights, and the same quality if you're not married to local.

This node appears to track the distilled side of the family (the gated steps defaulting to 1 is a giveaway - the Turbo is guidance-distilled to a handful of steps). Either way, it's Z-Image quality behind an API, with the full editing toolkit the model is known for.

What you set

positivePrompt, width, and height are required (128–2048, step 16). The inputs that make this more than a T2I node:

  • seedImage / maskImage - image + mask for inpainting. maskMargin (gated, 32–128px) adds context pixels around the masked region so the edit blends instead of smearing.
  • outpaint - a RUNWARE_OUTPAINT builder socket for extending the canvas.
  • lora - community LoRA socket; the Z-Image Turbo LoRA ecosystem exploded before the base even shipped.
  • ultralytics - object-detection input, for workflows where you detect then generate.
  • strength - gated, 0.8 default: lower = more of the original input survives.
  • steps / scheduler - gated; with a distilled model, few steps is the point, not a compromise.
  • seed - exposed, so local-familiar reproducibility carries over.

Output is image (IMAGE) → Preview/Save, outputFormat JPG/PNG/WEBP.

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

The honest question this node forces: why pay per image for a model that's free on your own GPU? The answer is "when you can't run it" - a 6GB laptop, a quick burst of batch work, or a workflow you want to hand off. If you own a 12GB card and use Z-Image daily, running it locally is still the better economics; this node is the convenience tier. And watch the usual cloud rules: everything you send goes to Runware's servers, and each numberResults is a separate billed generation.

CategoryRunware/Image/runware

Inputs (35)

NameTypeDefaultDescription
positivePromptSTRINGText prompt describing elements to include in the generated output.
widthINT1024128–2048Width of the generated media in pixels.
heightINT1024128–2048Height of the generated media in pixels.
seedImageoptIMAGE
maskImageoptIMAGE
outpaintoptRUNWARE_OUTPAINT
loraoptRUNWARE_LORA
ultralyticsoptRUNWARE_ULTRALYTICS
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_valueoptINT11–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–20Guidance scale representing how closely the output will resemble the prompt. Higher values produce results more aligned with the prompt.
strengthoptBOOLEANfalseEnable to set strength. This setting has usage rules in this model, so it is off unless you enable it.
strength_valueoptFLOAT0.800–1Strength of the transformation. Lower values result in more influence from the original input.
maskMarginoptBOOLEANfalseEnable to set maskMargin. Off uses the model's default.
maskMargin_valueoptINT3232–128Extra context pixels around the masked region during inpainting. The model zooms into the masked area with these additional pixels for better integration.
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.
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