# Z-Image Turbo (fal)

> Tongyi-MAI's Z-Image Turbo — a 6B-parameter text-to-image model tuned for speed, producing a full image in as few as 8 steps. Megapixel-priced, making it one of the cheapest options for high-volume generation.

- **Provider**: fal
- **Model ID**: fal-ai/z-image/turbo
- **Category**: image_generation
- **Credits**: 9 per request
- **Pricing Type**: input_based

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `enable_safety_checker` (boolean, optional): If set to true, the safety checker will be enabled. (Default: `True`)
- `acceleration` (string, optional): The acceleration level to use. (Default: `regular`; Options: `none`, `regular`, `high`)
- `seed` (integer, optional): The same seed and the same prompt given to the same version of the model will output the same image every time.
- `output_format` (string, optional): The format of the generated image. (Default: `png`; Options: `jpeg`, `png`, `webp`)
- `image_size` (string, optional): The size of the generated image. Charged per output megapixel, so smaller presets cost proportionally less. (Default: `landscape_4_3`; Options: `square_hd`, `square`, `portrait_4_3`, `portrait_16_9`, `landscape_4_3`, `landscape_16_9`)
- `prompt` (string, **required**): The prompt to generate an image from.
- `num_images` (integer, optional): The number of images to generate. Charged per image. (Default: `1`; Range: min: 1, max: 4)
- `num_inference_steps` (integer, optional): The number of inference steps to perform. (Default: `8`; Range: min: 1, max: 8)

## Example Request

```json
{
  "model": "fal-ai/z-image/turbo",
  "input": {
    "acceleration": "regular",
    "output_format": "png",
    "prompt": "A hyper-realistic close-up portrait of a weathered lighthouse keeper, salt-crusted beard, storm light raking across his face, shot on a Leica M6 with Kodak Portra 400 grain",
    "image_size": "landscape_4_3",
    "num_images": 1,
    "num_inference_steps": 8
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

json

## Tags

text-to-image, fast, low-cost, z-image, tongyi

## Documentation

https://fal.ai/models/fal-ai/z-image/turbo