Z Image Turbo Lora

Z-image with LoRA support for unique styles and personalised generations

Overview

Z-Image-Turbo-LoRA extends the fast generation capabilities of Z-Image-Turbo with support for LoRA (Low-Rank Adaptation) weights. Load custom LoRA models from HuggingFace or other sources to apply unique artistic styles, characters, or concepts to your generations. Supports multiple LoRAs simultaneously with adjustable scales.

Rate Limit: 150 requests per minute

Category: Image Generation

Price: 0.008$ / image


Quickstart

Basic Image Generation (Asynchronous)

curl -X POST 'https://api.pruna.ai/v1/predictions' \
  -H 'Content-Type: application/json' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Model: z-image-turbo-lora' \
  -d '{
    "input": {
      "prompt": "Portrait of a warrior in epic fantasy armor"
    }
  }'

Basic Image Generation (Synchronous)

curl -X POST 'https://api.pruna.ai/v1/predictions' \
  -H 'Content-Type: application/json' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Model: z-image-turbo-lora' \
  -H 'Try-Sync: true' \
  -d '{
    "input": {
      "prompt": "Portrait of a warrior in epic fantasy armor"
    }
  }'

Single LoRA Customization

curl -X POST 'https://api.pruna.ai/v1/predictions' \
  -H 'Content-Type: application/json' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Model: z-image-turbo-lora' \
  -d '{
    "input": {
      "prompt": "Anime style portrait of a young woman",
      "lora_weights": ["https://huggingface.co/your-user/your-lora/resolve/main/lora.safetensors"],
      "lora_scales": [0.8],
      "seed": 42
    }
  }'

Multiple LoRA Combination

curl -X POST 'https://api.pruna.ai/v1/predictions' \
  -H 'Content-Type: application/json' \
  -H 'apikey: YOUR_API_KEY' \
  -H 'Model: z-image-turbo-lora' \
  -d '{
    "input": {
      "prompt": "Fantasy landscape with watercolor painting style",
      "lora_weights": [
        "https://huggingface.co/user1/style-lora/resolve/main/lora1.safetensors",
        "https://huggingface.co/user2/concept-lora/resolve/main/lora2.safetensors"
      ],
      "lora_scales": [0.7, 0.5],
      "width": 1440,
      "height": 768,
      "output_format": "png"
    }
  }'

Parameters

Required Parameters

ParameterTypeDescription
promptstringText prompt for image generation

Optional Parameters

ParameterTypeDefaultDescription
heightinteger1024Height of the generated image (64-1440)
widthinteger1024Width of the generated image (64-1440)
num_inference_stepsinteger8Number of inference steps. This actually results in (num_inference_steps - 1) DiT forwards (1-50)
guidance_scalefloat0.0Guidance scale. Should be 0 for Turbo models (0.0-20.0)
seedinteger(optional)Random seed. Set for reproducible generation
lora_weightsarray of strings(optional)LoRA weights as an array of URLs. Supports .safetensors URLs, tar files, and zip files from HuggingFace or other sources (e.g., 'https://huggingface.co/user/model/resolve/main/lora.safetensors')
lora_scalesarray of floats(optional)Scales for each LoRA as an array of floats. Must match the number of lora_weights. Defaults to 1.0 for each if not provided
output_formatstring"jpg"Format of the output images. Options: "png", "jpg", "webp"
output_qualityinteger80Quality when saving the output images, from 0 to 100. 100 is best quality, 0 is lowest quality. Not relevant for .png outputs

This is your starter page content.