CoolFace
Modelpublic

DownFlow/Z-Image-Turbo-Fuli

sourceHugging Faceapache-2.0updated 6mo agoView on Hugging Face
0likes7downloads
Model Card

Z-Image-Turbo × Fuliji — Merged Model

Z-Image Turbo with Fuliji artist LoRA baked in. The LoRA weights have been permanently merged into the base transformer via merge_and_unload(), so no PEFT dependency is needed at inference time.

Want the standalone LoRA adapter instead? Use DownFlow/Z-Image-Turbo-Fuli-LoRA to apply the adapter on top of any Z-Image-Turbo checkpoint.

What This Is

This model is Tongyi-MAI/Z-Image-Turbo (an 8-step flow-matching image generation model) fine-tuned with a LoRA trained on art from 8 Chinese anime/illustration artists in the DownFlow/fuliji dataset.

Trigger the artist style by prepending by <artist>, to your prompt.

Quick Start (Python)

bash
pip install diffusers transformers accelerate safetensors
python
import torch
from diffusers import DiffusionPipeline

pipe = DiffusionPipeline.from_pretrained(
    "DownFlow/Z-Image-Turbo-Fuli",
    torch_dtype=torch.bfloat16,
).to("cuda")

image = pipe(
    prompt="by 蠢沫沫, 1girl, solo, smile, soft lighting",
    num_inference_steps=8,
    guidance_scale=0.0,   # Z-Image Turbo uses CFG=0
    height=512,
    width=512,
).images[0]

image.save("output.png")

Serving with vLLM

vLLM (≥ 0.8) can serve this model via an OpenAI-compatible /v1/images/generations endpoint.

1 — Start the server

bash
pip install "vllm>=0.8.0"

vllm serve DownFlow/Z-Image-Turbo-Fuli \
    --task generate \
    --dtype bfloat16 \
    --max-model-len 512 \
    --port 8000

2 — Generate via curl

bash
curl http://localhost:8000/v1/images/generations \
  -H "Content-Type: application/json" \
  -d '{
    "model": "DownFlow/Z-Image-Turbo-Fuli",
    "prompt": "by 蠢沫沫, 1girl, smile, soft watercolour style",
    "n": 1,
    "size": "512x512"
  }'

3 — Generate via OpenAI Python SDK

python
from openai import OpenAI

client = OpenAI(base_url="http://localhost:8000/v1", api_key="not-needed")

response = client.images.generate(
    model="DownFlow/Z-Image-Turbo-Fuli",
    prompt="by 年年, 1girl, white dress, cherry blossoms",
    n=1,
    size="512x512",
)
print(response.data[0].url)

Artist Trigger Tokens

Prepend by <artist>, at the start of your prompt.

TokenTraining images
萌芽儿o030
年年26
封疆疆v26
焖焖碳26
星之迟迟25
蠢沫沫23
雨波HaneAme23
清水由乃21

Model Details

PropertyValue
Base modelTongyi-MAI/Z-Image-Turbo
Fine-tuning methodLoRA rank=32, alpha=32 — merged into weights
Target modulesto_q, to_k, to_v, w1, w2, w3
Training steps5 000 (3 000 at lr=1e-4 + 2 000 continued at lr=5e-5, EMA decay=0.9999)
Training resolution512 × 512
Inference steps8
CFG scale0.0 (CFG-free)
Precisionbfloat16
DatasetDownFlow/fuliji (8 artists, ~200 images)

Related