Z Image Base
The open model without the open-GPU requirement
- api_config
- image
- request_id
- urls
Z-Image is Alibaba's hybrid MMDiT image model, the one that took the local photorealism crown from Flux in late 2025, and Z-Image Base is the full-quality edition that opened up fine-tuning when it shipped in January 2026. This node gives you that model as an API call inside ComfyUI - no weights to download, no VRAM to budget, and no reason to skip it because your card can't hold a 6B-parameter transformer comfortably.
It ships in the BizyAirPlus pack under a category that matters: Self-Hosted. Where the Wan nodes in the pack talk to bizyair.ai's hosted model service, this one is grouped as a self-hosted service - and the api_config input, which overrides base_url and api_key for a single request, is the strong hint that you point this at an endpoint you run. The README is silent on standing up that server, so expect to know what you're connecting to.
How it works
The core job is familiar: prompt in, image out (plus request_id and urls). But where the Wan API nodes hide their sampling settings server-side, this one hands you the dials - which is exactly what you'd expect from a node aimed at a model you serve yourself. The defaults are sensible for Base: 28 steps, guidance_scale 3.0, 1024×1024, and a seed of 0 (-1 = server-random).
The inputs that matter
- prompt / negative_prompt - the standard pair. This model is known for a strong text encoder, so push it: it handles typography and specific content well.
- width / height - 256–2048, default 1024 each.
- steps - 4–50, default 28. Full-quality diffusion pacing; this is the Base model, not the distilled one, so give it the steps.
- guidance_scale - 0.1–8, default 3.0. Low-ish CFG is the Z-Image norm; don't crank it like you might an SDXL checkpoint.
- seed -
-1for random, or pin it to reproduce a look.
Plus skip_error and api_config (the endpoint/key override that makes "Self-Hosted" real).
Installation
Standard BizyAirPlus install, once:
cd ComfyUI/custom_nodes
git clone https://github.com/siliconflow/BizyAirPlus.git
cd BizyAirPlus
python -m pip install -r requirements.txt
Or ComfyUI Manager, search BizyAirPlus. Restart, add your API key, and confirm which endpoint this node is pointed at via api_config if you're self-hosting.
Common issues
- "Works in the app, not here" - this node needs a reachable endpoint. Check
api_config'sbase_urland that your server is up. - Blocky or underspecified results at default settings - give Base its steps (28 is the floor for good quality, not a suggestion).
- Guidance fights you - 3.0 is the sweet spot; pushing toward 8 often hurts more than helps with this architecture.
- Cloud failures - key validity and network first, then the ComfyUI console for the detailed error.
Inputs (9)
| Name | Type | Default | Description |
|---|---|---|---|
| prompt | STRING | Prompts | |
| negative_promptopt | STRING | Negative prompts | |
| widthopt | INT | 1024256–2048 | Image width |
| heightopt | INT | 1024256–2048 | Image height |
| seedopt | INT | 0-1–2147483647 | Seeds |
| guidance_scaleopt | FLOAT | 3.00.1–8 | Guidance |
| stepsopt | INT | 284–50 | Number of steps |
| api_configopt | BIZYAIR_OPENAPI_CONFIG | 单次请求覆盖base_url和api_key | |
| skip_erroropt | BOOLEAN | false | 开启后遇到错误不中断工作流,输出对应类型的错误占位符 |
Outputs (3)
| Name | Type | Description |
|---|---|---|
| image | IMAGE | — |
| request_id | STRING | — |
| urls | STRING | — |