Z-Image
Z-Image in the cloud — the 'SDXL 2.0' you can also afford to skip local for
- seedImage
- maskImage
- outpaint
- lora
- ultralytics
- acceleratorOptions
- advancedFeatures.watermark.image
- image
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- aRUNWARE_OUTPAINTbuilder 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.
Inputs (35)
| Name | Type | Default | Description |
|---|---|---|---|
| positivePrompt | STRING | Text prompt describing elements to include in the generated output. | |
| width | INT | 1024128–2048 | Width of the generated media in pixels. |
| height | INT | 1024128–2048 | Height of the generated media in pixels. |
| seedImageopt | IMAGE | — | |
| maskImageopt | IMAGE | — | |
| outpaintopt | RUNWARE_OUTPAINT | — | |
| loraopt | RUNWARE_LORA | — | |
| ultralyticsopt | RUNWARE_ULTRALYTICS | — | |
| acceleratorOptionsopt | RUNWARE_ACCELERATOROPTIONS | — | |
| advancedFeatures.watermark.imageopt | IMAGE | — | |
| negativePromptopt | STRING | Prompt to guide what to exclude from generation. Ignored when guidance is disabled (CFGScale ≤ 1). | |
| seedopt | INT | 00–9223372036854776000 | Random seed for reproducible generation. When not provided, a random seed is generated in the unsigned 32-bit range. |
| stepsopt | BOOLEAN | false | Enable to set steps. Off uses the model's default. |
| steps_valueopt | INT | 11–50 | Total number of denoising steps. Higher values generally produce more detailed results but take longer. |
| scheduleropt | COMBO | (default) | Scheduler to use for the diffusion process. |
| CFGScaleopt | BOOLEAN | false | Enable to set CFGScale. Off uses the model's default. |
| CFGScale_valueopt | FLOAT | 0.000–20 | Guidance scale representing how closely the output will resemble the prompt. Higher values produce results more aligned with the prompt. |
| strengthopt | BOOLEAN | false | Enable to set strength. This setting has usage rules in this model, so it is off unless you enable it. |
| strength_valueopt | FLOAT | 0.800–1 | Strength of the transformation. Lower values result in more influence from the original input. |
| maskMarginopt | BOOLEAN | false | Enable to set maskMargin. Off uses the model's default. |
| maskMargin_valueopt | INT | 3232–128 | Extra context pixels around the masked region during inpainting. The model zooms into the masked area with these additional pixels for better integration. |
| 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. | |
| 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 | — |