# Z-Image Turbo

> Tongyi-MAI's 6-billion parameter distilled text-to-image model optimized for speed, achieving high-quality generation in 8 steps or fewer with support for bilingual text rendering

## Quick Reference

- Model ID: z-image-turbo
- Creator: Alibaba
- Status: active
- Family: z-image
- Base URL: https://api.lumenfall.ai/openai/v1

## Specifications

- Max Resolution: 2048x2048
- Input Modalities: text, image
- Output Modalities: image
- Supported Modes: Text to Image, Image Edit

## API Parameters

The compiled parameter schema for this model is available via the API: `GET /v1/models/z-image-turbo?schema=true`.

### Core Parameters

- `prompt` (string) — REQUIRED: Edit instruction for the image. Modes: Image Edit, Text to Image
- `seed` (integer): Random seed for reproducibility. Modes: Image Edit, Text to Image

### Size & Layout

- `size` (string): Image dimensions as WxH pixels (e.g. "1024x1024") or aspect ratio (e.g. "16:9"). Modes: Image Edit, Text to Image
- `aspect_ratio` (string): Aspect ratio of the output image (e.g. "16:9", "1:1"). Modes: Image Edit, Text to Image
- `resolution` (string): Output resolution tier (e.g. "1K", "4K"). Modes: Image Edit, Text to Image

### Media Inputs

- `image` (file) — REQUIRED: Input image(s) to edit. Modes: Image Edit

### Output & Format

- `response_format` (string): How to return the image. Default: url. Values: url, b64_json. Modes: Image Edit, Text to Image
- `output_format` (string): Output image format. Values: png, jpeg, gif, webp, avif. Modes: Image Edit, Text to Image
- `output_compression` (integer): Compression level for lossy formats (JPEG, WebP, AVIF). Modes: Image Edit, Text to Image
- `n` (integer): Number of images to generate. Default: 1. Modes: Image Edit, Text to Image

### Additional Parameters

- `cfg_scale` (number): Classifier-free guidance scale — higher values stick more closely to the prompt. Modes: Image Edit, Text to Image
- `strength` (number): How much to transform the input image: 0 keeps it unchanged, 1 fully regenerates from the prompt. Modes: Image Edit
- `acceleration` (string): The acceleration level to use.. Values: high, none, regular. Modes: Image Edit, Text to Image. Only available via fal
- `enable_prompt_expansion` (boolean): Whether to enable prompt expansion. Note: this will increase the price by 0.0025 credits per request.. Modes: Image Edit, Text to Image. Only available via fal
- `enable_safety_checker` (boolean): If set to true, the safety checker will be enabled.. Modes: Image Edit, Text to Image. Only available via fal
- `go_fast` (boolean): Apply additional optimizations for faster generation. Modes: Text to Image. Only available via replicate
- `height` (integer): Height of the generated image. Modes: Text to Image. Only available via replicate
- `num_inference_steps` (integer): The number of inference steps to perform.. Modes: Image Edit, Text to Image
- `output_quality` (integer): Quality when saving the output images, from 0 to 100. 100 is best quality, 0 is lowest quality. Not relevant for .png outputs. Modes: Text to Image. Only available via replicate
- `sync_mode` (boolean): If `True`, the media will be returned as a data URI and the output data won't be available in the request history.. Modes: Image Edit, Text to Image. Only available via fal
- `width` (integer): Width of the generated image. Modes: Text to Image. Only available via replicate


## Model Identifiers

- Primary Slug: z-image-turbo


## Tags

image-generation, text-to-image, fast, open-weights

## Available Providers

### fal.ai

- Config Key: fal/z-image-turbo-edit
- Provider Model ID: fal-ai/z-image/turbo/image-to-image
- Pricing: $0.0050/megapixel
  - Source: https://fal.ai/models/fal-ai/z-image/turbo

### fal.ai

- Config Key: fal/z-image-turbo
- Provider Model ID: fal-ai/z-image/turbo
- Pricing: $0.0050/megapixel
  - Source: https://fal.ai/models/fal-ai/z-image/turbo

### Alibaba Cloud

- Config Key: alibaba/z-image-turbo
- Provider Model ID: z-image-turbo
- Pricing: $0.015/image, $0.030/image
  - Source: https://modelstudio.console.alibabacloud.com/ap-southeast-1?tab=doc#/doc/?type=model&url=2840914_2&modelId=z-image-turbo

### Replicate

- Config Key: replicate/z-image-turbo
- Provider Model ID: prunaai/z-image-turbo
- Pricing: $0.0050/megapixel
  - Note: PrunaAI optimized version of Tongyi-MAI Z-Image-Turbo
  - Note: Sub-second generation with 8 steps
  - Source: https://replicate.com/prunaai/z-image-turbo


## Performance Metrics

Provider performance over the last 30 days.

### fal

- Median Generation Time (p50): 2169ms
- 95th Percentile Generation Time (p95): 7485ms
- Average Generation Time: 3418ms
- Success Rate: 100.0%
- Total Requests: 20
- Time to First Byte (p50): 2068ms
- Time to First Byte (p95): 7049ms

### alibaba

- Median Generation Time (p50): 6092ms
- 95th Percentile Generation Time (p95): 54449ms
- Average Generation Time: 12516ms
- Success Rate: 75.3%
- Total Requests: 89
- Time to First Byte (p50): 5705ms
- Time to First Byte (p95): 55626ms


## Arena Benchmarks

### Modern Clean Menu

- Elo: 1255
- Record: 10W / 20L / 4T (34 battles)
- Rank: #4 of 19

### Fantasy Warrior

- Elo: 1201
- Record: 11W / 4L / 3T (18 battles)
- Rank: #9 of 21

### Heroic Super Hero Portrait

- Elo: 1186
- Record: 6W / 1L / 2T (9 battles)
- Rank: #9 of 21

### Adorable Baby Animals in Sunny Meadow

- Elo: 1183
- Record: 11W / 5L / 0T (16 battles)
- Rank: #9 of 25

### Geometric Composition

- Elo: 1180
- Record: 16W / 14L / 5T (35 battles)
- Rank: #13 of 22

### Victorian Greenhouse Oasis

- Elo: 1179
- Record: 14W / 14L / 4T (32 battles)
- Rank: #12 of 17

### Vintage Cafe Logo

- Elo: 1154
- Record: 10W / 9L / 3T (22 battles)
- Rank: #17 of 21

### Candid Street Photography

- Elo: 1143
- Record: 9W / 10L / 5T (24 battles)
- Rank: #18 of 24

### Fantasy Warrior

- Elo: 1137
- Record: 6W / 0L / 1T (7 battles)
- Rank: #3 of 14

### Isometric Miniature Diorama Scenes

- Elo: 1111
- Record: 7W / 18L / 2T (27 battles)
- Rank: #20 of 21

### Night Sky Transformation

- Elo: 1034
- Record: 1W / 29L / 0T (30 battles)
- Rank: #16 of 16

### Bald man challenge

- Elo: 1000
- Record: 0W / 28L / 0T (28 battles)
- Rank: #15 of 15


## Use Cases & Category Performance

### Portrait (Text-to-Image)

- Rank: #8 of 21
- Elo: 1206
- Record: 11W / 4L / 3T (18 battles)
- Win Rate: 61.1%

### Product, Branding & Commercial (Text-to-Image)

- Rank: #9 of 21
- Elo: 1185
- Record: 10W / 9L / 3T (22 battles)
- Win Rate: 45.5%

### Text Rendering (Text-to-Image)

- Rank: #15 of 23
- Elo: 1210
- Record: 20W / 29L / 7T (56 battles)
- Win Rate: 35.7%

### Photorealism (Text-to-Image)

- Rank: #15 of 23
- Elo: 1181
- Record: 9W / 10L / 5T (24 battles)
- Win Rate: 37.5%

### Portrait (Image Editing)

- Rank: #15 of 15
- Elo: 1034
- Record: 0W / 28L / 0T (28 battles)
- Win Rate: 0.0%

### Photorealism (Image Editing)

- Rank: #16 of 16
- Elo: 1053
- Record: 1W / 57L / 0T (58 battles)
- Win Rate: 1.7%


## Image Gallery

16 images available for this model. Browse all at https://lumenfall.ai/models/alibaba/z-image-turbo/gallery

### Curated Examples

- [A cinematic, wide-angle shot of a high-end, boutique camera store at twilight. The centerpiece is...](https://assets.lumenfall.ai/F_pNuEh6mQgRyeNCi3IrVyKVWtMDzgxicpoHat7kE5M/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/c532qbjhwkhnim55zg4qsrd2dilw@jpeg)
- [A hyper-realistic close-up of an elderly artisan’s weathered hands meticulously carving intricate...](https://assets.lumenfall.ai/8ZNty3pq8UYGBIL-OK0t3Q6MEO7wqhWir0A0FZ2I-f8/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/2hzwh8sp1t8uo9aev6qqliq4u176@jpeg)
- [A hyper-realistic, macro close-up of a weathered leather craftsman's workbench. In the center, a ...](https://assets.lumenfall.ai/2PcqY8hiU4m5qW_mnNtu-oEwPPnPjsDCs1uEh2NBzPs/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/53n63uopp08xbqf2zlnfffilr1b9@jpeg)
- [A cozy street-side chalkboard sign with elegant, hand-lettered chalk typography that reads "Fresh...](https://assets.lumenfall.ai/JLxO-MSASsgQO_tmBoXXqNaiCjGDWCXN7_0b8eJGIAY/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/dy11eqyegaex38lty96o3be78pcq@jpeg)

### Arena Competition Results

- [Modern Clean Menu](https://assets.lumenfall.ai/taPLQg2z1jguFhb7vpatK4QVm9oHOI2BTXrM1mMt3SI/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/r4ozotleozyer67yuseapf9mdqwx@jpeg): #4 of 19 (Elo 1255)
- [Fantasy Warrior](https://assets.lumenfall.ai/Bt3uKTsqHzoUd1P9OLW540yDB8k8IdJXFew0IdPzHPU/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/wbcrsifwtznj5tzc75pbw9azogq7@jpeg): #9 of 21 (Elo 1201)
- [Heroic Super Hero Portrait](https://assets.lumenfall.ai/x3GTpcMXTvdfzW1aEce9eKz4UwhxOeTiG9K31aommVA/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/16y2nbznvqg0x07fb1kn9b0hzvfd@jpeg): #9 of 21 (Elo 1186)
- [Adorable Baby Animals in Sunny Meadow](https://assets.lumenfall.ai/Rsx2JowMxJSl6apEB5yiPofyYOhfq-2K8Nb6a4Jm6gU/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/g0pgboqwbq6l2vqxm3dl2939u4wa@jpeg): #9 of 25 (Elo 1183)
- [Geometric Composition](https://assets.lumenfall.ai/P53NLrjQb7W10NV4O3P3qIutE0741l778ooZF8AaRnU/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/jhnlkvzgtho8aonj9x70iiwz6svc@jpeg): #13 of 22 (Elo 1180)
- [Victorian Greenhouse Oasis](https://assets.lumenfall.ai/hZqrd46eQtWskXJzX8GDforSgDPR22r6oPcRdpORMR4/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/wgzsy0fpu7c1nf7srv8kn7u9c5wu@jpeg): #12 of 17 (Elo 1179)
- [Vintage Cafe Logo](https://assets.lumenfall.ai/j2NEi1kDrJfA6fZ00Vt1cQJz5WmzGAGbtJBe-jFKx1k/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/m0gw3afu31gulu7rtq8byg6g7jlv@jpeg): #17 of 21 (Elo 1154)
- [Candid Street Photography](https://assets.lumenfall.ai/jBj_nMgUSCEVQksxW9LsaSSIxh6pDy9_1BZi848zEPA/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/agy2jsed81vt1i21duvoddh0ow5w@jpeg): #18 of 24 (Elo 1143)
- [Fantasy Warrior](https://assets.lumenfall.ai/H1lTxrrM1qPEv7uXut6XznH8RE2s7BIOSgJfebZR0Mg/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/6292wk89j6nl6gr3jgrfcy6il77z@jpeg): #3 of 14 (Elo 1137)
- [Isometric Miniature Diorama Scenes](https://assets.lumenfall.ai/KqVC-6Yax45PCHafoDUMEUjzO0-BfdGz4PgMuOoD5vU/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/iw4kqxexfvc16vbds4qkwtqd23ut@jpeg): #20 of 21 (Elo 1111)
- [Night Sky Transformation](https://assets.lumenfall.ai/gZOdw9-EvelSdePkKkLeIkgQm46NF5St6CAaz4HpB0w/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/3rg0dhx83agi26fsv885yk2gv2ft@jpeg): #16 of 16 (Elo 1034)
- [Bald man challenge](https://assets.lumenfall.ai/ZVVNgopEgW3mQWaksNgwVnkOqJW0kdFLCXvsSsBMW3Y/rs:fit:1500:1500/plain/gs://lumenfall-prod-assets/z654u9zbbnq9n9qg5r2urv95srwa@jpeg): #15 of 15 (Elo 1000)

## Example Prompt

The following prompt was used to generate an example image in our playground:

A cozy street-side chalkboard sign with elegant, hand-lettered chalk typography that reads "Fresh Coffee & Warm Cookies." Sunlight filters through autumn leaves, while a capybara calmly nps on a wooden bench in the soft-focus background.

## Code Examples

### Text to Image (/v1/images/generations)

#### cURL

curl -X POST \
  https://api.lumenfall.ai/openai/v1/images/generations \
  -H "Authorization: Bearer $LUMENFALL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "z-image-turbo",
    "prompt": "",
    "size": "1024x1024"
  }'

# Response:
# { "created": 1234567890, "data": [{ "url": "https://...", "revised_prompt": "..." }] }

#### JavaScript

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.lumenfall.ai/openai/v1'
});

const response = await client.images.generate({
  model: 'z-image-turbo',
  prompt: '',
  size: '1024x1024'
});

// { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
console.log(response.data[0].url);

#### Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.lumenfall.ai/openai/v1"
)

response = client.images.generate(
    model="z-image-turbo",
    prompt="",
    size="1024x1024"
)

# { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
print(response.data[0].url)

### Image Edit (/v1/images/edits)

#### cURL

curl -X POST \
  https://api.lumenfall.ai/openai/v1/images/edits \
  -H "Authorization: Bearer $LUMENFALL_API_KEY" \
  -F "model=z-image-turbo" \
  -F "image=@source.png" \
  -F "prompt=Add a starry night sky to this image" \
  -F "size=1024x1024"

# Response:
# { "created": 1234567890, "data": [{ "url": "https://...", "revised_prompt": "..." }] }

#### JavaScript

import OpenAI from 'openai';
import fs from 'fs';

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.lumenfall.ai/openai/v1'
});

const response = await client.images.edit({
  model: 'z-image-turbo',
  image: fs.createReadStream('source.png'),
  prompt: 'Add a starry night sky to this image',
  size: '1024x1024'
});

// { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
console.log(response.data[0].url);

#### Python

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.lumenfall.ai/openai/v1"
)

response = client.images.edit(
    model="z-image-turbo",
    image=open("source.png", "rb"),
    prompt="Add a starry night sky to this image",
    size="1024x1024"
)

# { created: 1234567890, data: [{ url: "https://...", revised_prompt: "..." }] }
print(response.data[0].url)


## About

## Overview
Z-Image Turbo is a 6-billion parameter text-to-image model developed by Alibaba’s Tongyi-MAI team. It distinguishes itself by utilizing distillation techniques to enable high-quality image synthesis in eight steps or fewer, making it significantly faster than standard diffusion models. The model is specifically optimized for bilingual text rendering, supporting both Chinese and English characters within generated imagery.

## Strengths
*   **Inference Latency:** By reducing the required sampling steps to a range of 1 to 8, the model provides near-instantaneous image generation suitable for real-time applications.
*   **Bilingual Text Rendering:** The model excels at accurately rendering complex Chinese characters and English text, a task where many Western-centric models often fail or produce "gibberish."
*   **Visual Fidelity at Low Step Counts:** Despite the aggressive distillation for speed, the model maintains high structural integrity and aesthetic consistency that typically requires 25-50 steps in non-distilled models.
*   **Multimodal Input Support:** It can process both text prompts and image-based references (image-to-image) to guide the generation process, offering flexibility beyond simple text descriptors.

## Limitations
*   **Fine Detail Saturation:** While excellent for rapid generation, the model may lack the extreme micro-detail or complex texture depth found in larger, 12B+ parameter models that utilize longer sampling chains.
*   **Step Count Sensitivity:** Moving beyond the 8-step threshold does not necessarily improve quality and can sometimes lead to visual artifacts, as the model is strictly tuned for low-step schedules.
*   **Stylistic Range:** Compared to broader foundation models, the output may lean toward a specific "polished" aesthetic favored by its distillation process, which might require more aggressive prompting to deviate from.

## Technical Background
Z-Image Turbo is part of the Z-Image model family and utilizes a distilled architecture derived from a larger latent diffusion framework. To achieve its speed, the developers employed a consistency-based distillation approach that maps the probability flow of the original model into a single or few-step inference trajectory. The integration of a specialized text encoder allows the model to handle bilingual tokens more effectively than models trained solely on English datasets.

## Best For
This model is ideal for interactive applications such as live drawing assistants, rapid prototyping for UI/UX design, and social media content creation where speed is prioritized over granular control. It is also a leading choice for projects requiring accurate Chinese typography within images. Z-Image Turbo is available for integration and testing through Lumenfall’s unified API and interactive playground.

## Frequently Asked Questions

### How much does Z-Image Turbo cost?

Z-Image Turbo starts at $0.005 per image through Lumenfall. Pricing varies by provider. Lumenfall does not add any markup to provider pricing.

### How do I use Z-Image Turbo via API?

You can use Z-Image Turbo through Lumenfall's OpenAI-compatible API. Send requests to the unified endpoint with model ID "z-image-turbo". Code examples are available in Python, JavaScript, and cURL.

### Which providers offer Z-Image Turbo?

Z-Image Turbo is available through fal.ai, Alibaba Cloud, and Replicate on Lumenfall. Lumenfall automatically routes requests to the best available provider.

### What is the maximum resolution for Z-Image Turbo?

Z-Image Turbo supports images up to 2048x2048 resolution.

## Links

- Model Page: https://lumenfall.ai/models/alibaba/z-image-turbo
- About: https://lumenfall.ai/models/alibaba/z-image-turbo/about
- Providers, Pricing & Performance: https://lumenfall.ai/models/alibaba/z-image-turbo/providers
- API Reference: https://lumenfall.ai/models/alibaba/z-image-turbo/api
- Benchmarks: https://lumenfall.ai/models/alibaba/z-image-turbo/benchmarks
- Use Cases: https://lumenfall.ai/models/alibaba/z-image-turbo/use-cases
- Gallery: https://lumenfall.ai/models/alibaba/z-image-turbo/gallery
- Playground: https://lumenfall.ai/playground?model=z-image-turbo
- API Documentation: https://docs.lumenfall.ai