z_image model family
Tasks
Supported architectures and task heads
The Hugging Face values below are copied from checkpoint metadata at the recorded revision. The TRTMC task contract comes from the exact E2E recipe. Architecture identity selects or describes a source graph; it does not imply that TRTMC reproduces every Hugging Face head with the same model_type. For example, an encoder recipe may consume the base model and intentionally return hidden states instead of the checkpoint's pretraining or classification logits.
HF model_type | HF architecture / pipeline class | TRTMC task contract | Exact recipe profiles |
|---|---|---|---|
| — | ZImagePipelineSource: model_index._class_nameMetadata: model_index.json at f332072aa78b | diffusion_media_generation | z-image-turboz-image-turbo-l0z-image-turbo-l0-tp2 |
Declared recipes
Each row comes from a model-owned E2E manifest. It declares a test recipe; it is not a live pass receipt for every hardware target.
| Recipe | Exact Hugging Face checkpoint | Task | Build configuration | Declared E2E cases | Manifest |
|---|---|---|---|---|---|
z-image-turbo | Tongyi-MAI/Z-Image-Turbo | fp16; single device FP32 layers: 2, 3, 4, 7, 8 | z-image-turbo | tests/e2e/models/z_image/manifests/z-image-turbo.json | |
z-image-turbo-l0 | Tongyi-MAI/Z-Image-Turbo | fp16; single device FP32 layers: 2, 3, 4, 7, 8 | z-image-turbo-l0 | tests/e2e/models/z_image/manifests/z-image-turbo-l0.json | |
z-image-turbo-l0-tp2 | Tongyi-MAI/Z-Image-Turbo | family default; TP2 | z-image-turbo-l0-tp2 | tests/e2e/models/z_image/manifests/z-image-turbo-l0-tp2.json |
Family-owned configuration
This family does not declare a family-owned --set namespace. Use the explicit CLI options shown below and the shared configuration namespaces documented in Configure Runtime Behavior.
Family-specific CLI contracts
Inputs and options below are filtered by the declared E2E task and the methods and configuration fields used by that family's native runtime implementation. The global CLI parser accepts a wider union of flags; flags absent here are not declared for this family.
trtmc run
Generate an image from a text prompt.
Declared recipes: z-image-turbo, z-image-turbo-l0, z-image-turbo-l0-tp2
trtmc run <bundle.bundle> --prompt "<text>" --output <output.png> [generation options]| Supported input or option | Requirement | Runtime behavior |
|---|---|---|
--prompt <TEXT> | Required | Text conditioning input. |
--output <PATH> | Optional | Output PNG path or directory. |
--num-images <N> | Optional | Generate an image batch from one prompt. |
--prompts-file <PATH> | Optional | Generate one image per line in a prompt file. |
--seed <N> | Optional | Set the sampling or diffusion seed. |
--num-steps <N> | Optional | Set the number of diffusion or flow-matching steps. |
--guidance-scale <F> | Optional | Set classifier-free guidance strength. |
--initial-latents-raw <PATH> | Optional | Load packed float32 initial latents. |
Code basis
Runtime provider: z_image
include/trtmc/pipeline.hsrc/cli/main.cppsrc/runtime/models/z_image/pipeline.cppsrc/runtime/models/z_image/pipeline.htests/e2e/models/z_image/manifests/z-image-turbo-l0-tp2.jsontests/e2e/models/z_image/manifests/z-image-turbo-l0.jsontests/e2e/models/z_image/manifests/z-image-turbo.json
Bundle lifecycle commands
These commands apply to every declared recipe in this family; they do not add task inputs or model capabilities.
trtmc build
Build one exact checkpoint into a TensorRT-Model-Connect bundle.
trtmc build <hf-id> --output <bundle.bundle>trtmc inspect
Inspect bundle metadata, runtime identity, and packaged sections.
trtmc inspect <bundle.bundle>See the CLI Reference for all options and limitations.