ComfyUI Node

Z-Image-Turbo

The 6B model that killed the FLUX 2 hype

By Runware·Created 2 years ago·Updated about a month ago· 140
Z-Image-Turbo
  • seedImage
  • maskImage
  • outpaint
  • lora
  • controlNet
  • 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-Turbo is Alibaba's 6B image model, and it's the one that quietly won the community's heart in late 2025 by being small at exactly the right moment. While FLUX 2 Dev shipped 32B parameters and a heavy censorship load, Z-Image shipped a tiny, fast, uncensored, Apache-2.0 model that runs on a 12GB card - near-FLUX quality at a fraction of the size, and the community called it SDXL 2.0 before it even had a trainable base. In the Runware pack it's the sensible middle ground: better detail than the distilled tiers, cheaper per image than the 20B flagships, and Turbo specifically means it does it in very few steps.

It's not perfect. Complex-prompt adherence is weaker than FLUX 2, there's a persistent Asian face bias, and the native ceiling is around 2MP - you won't be printing billboards. But for fast, good-looking, no-drama generation, this is the node people keep coming back to.

What you set

Required: positivePrompt, width, height (128–2048, step 16).

Then it's the familiar Runware image-node spread:

  • CFGScale - off by default and leave it off. Z-Image-Turbo is guidance-distilled; the whole point is low CFG at few steps.
  • steps - the default handles it. Adding steps on a Turbo model is throwing money at a ceiling.
  • seedImage / maskImage - image-to-image and inpainting, standard.
  • controlNet, lora, outpaint sockets - Z-Image has a real ControlNet ecosystem (Alibaba's Fun ControlNet), so this is one of the more expandable models in the pack.
  • negativePrompt (ignored at CFGScale ≤ 1), seed, scheduler, numberResults (up to 20), outputFormat, outputQuality.

Output is image (IMAGE).

How it works

Same pack machinery as every node here: build a request with the model AIR and taskType, ship it over REST through the Runware SDK, download the IMAGE back. The model runs on Runware's hardware, so the 12GB-VRAM sweet spot that made Z-Image famous locally doesn't even matter - you could run this on a Raspberry Pi's worth of client and get identical results. The node prints cost per run on its title bar; Z-Image-Turbo's cost is low enough that batch experimentation stops feeling like a budget decision.

Installing

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

No model downloads; dependencies are runware-sdk, pillow, soundfile. API key needed: Settings → Runware API key, RUNWARE_API_KEY, or runware auth login.

Troubleshooting

The missing-key error is the usual first stop. If you came from SDXL habits and set CFG 7 and 30 steps, you'll get overcooked output - trust the defaults, they're the distillation-correct values. And if you need ultra-detailed photorealism, Z-Image-Turbo isn't lying to you about being a turbo; the base model (or the FLUX nodes) is the step up.

CategoryRunware/Image/runware

Inputs (36)

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
controlNetoptRUNWARE_CONTROLNET
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