Z Image Turbo (custom model)
Z Image Turbo, but bring your own checkpoint
- seedImage
- maskImage
- outpaint
- lora
- controlNet
- ultralytics
- acceleratorOptions
- advancedFeatures.watermark.image
- image
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).
CFGScaletoggle +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,outpaintsockets - 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.
Inputs (37)
| Name | Type | Default | Description |
|---|---|---|---|
| model | STRING | runware:z-image@turbo | AIR of any checkpoint of this architecture. Use the search button to browse the catalog. |
| 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 | — | |
| controlNetopt | RUNWARE_CONTROLNET | — | |
| 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 | — |