ComfyUI Node

Z Image Turbo (custom model)

Z Image Turbo, but bring your own checkpoint

By Runware·Created 2 years ago·Updated about a month ago· 140
Z Image Turbo (custom model)
  • seedImage
  • maskImage
  • outpaint
  • lora
  • controlNet
  • ultralytics
  • acceleratorOptions
  • advancedFeatures.watermark.image
  • image
modelrunware:z-image@turbo
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

If you've already met the dedicated Z-Image-Turbo node, this is its sibling with a twist: RunwareArch_z_image_turbo is the custom-model version, so instead of being pinned to the stock checkpoint, the model field is yours to fill with any Z-Image-Turbo-architecture model from the Runware catalog. Same 6B family that became the community's SDXL 2.0 - near-FLUX quality, tiny, uncensored, Apache 2.0 - but now you can point it at the specific checkpoint you actually want.

Why would you reach for the Arch version over the fixed node? Fine-tunes, mostly. Z-Image built a LoRA and fine-tune ecosystem faster than almost any model in recent memory, and the dedicated node is stuck with the base. This one lets you load a community Z-Image checkpoint or a merged variant and get its exact behavior in the cloud - no 3GB download, no VRAM negotiation. It's the same "doorway node" pattern as the pack's other RunwareArch_* entries, applied to the hottest small model of the year.

What you set

Required: model (default runware:z-image@turbo - search button to browse), positivePrompt, width, height (128–2048, step 16).

  • CFGScale toggle + CFGScale_value - Z-Image-Turbo is guidance-distilled, so the same advice as the fixed node: keep it low, usually leave it off.
  • steps - the Turbo architecture wants few steps; the default is the distillation-correct value.
  • controlNet, lora, outpaint sockets - Z-Image's real ControlNet ecosystem (Alibaba's Fun ControlNet) plugs in here.
  • seedImage, maskImage, negativePrompt (ignored at CFGScale ≤ 1), scheduler, seed, numberResults (up to 20), outputFormat, outputQuality.

Output is image (IMAGE).

How it works

Standard pack machinery: request with the model AIR + taskType over REST via the Runware SDK, IMAGE downloaded back, cost on the title bar. Because the architecture is known to the catalog, sampler handling is automatic - and for a distilled model like Turbo, "automatic" is doing a lot of work, because the correct few-steps/low-CFG settings are exactly what beginners get wrong locally. The cloud also means the 12GB-VRAM sweet spot that made Z-Image famous is irrelevant here; a potato laptop drives this node identically.

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 via Settings → Runware API key, RUNWARE_API_KEY, or runware auth login.

Troubleshooting

Search, don't type the AIR - a stale or mistyped model string is the classic request failure. If a fine-tune behaves differently than its page promised, remember cloud runs may use the catalog's sampler defaults; nudge CFGScale and steps to the values the checkpoint page recommends. And the negative-prompt-at-low-CFG thing applies here too, so don't fight it.

CategoryRunware/Custom models

Inputs (37)

NameTypeDefaultDescription
modelSTRINGrunware:z-image@turboAIR of any checkpoint of this architecture. Use the search button to browse the catalog.
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