# Z-Image Turbo

> Pruna's ultra-fast Z-Image Turbo (48M+ runs). Megapixel-priced image generation up to 2048x2048 — great price/performance for high-volume use.

- **Provider**: replicate
- **Model ID**: prunaai/z-image-turbo
- **Category**: image_generation
- **Credits**: 40 per request
- **Pricing Type**: formula

## 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

- `output_quality` (integer, optional): Quality when saving the output images, from 0 to 100. 100 is best quality, 0 is lowest quality. Not relevant for .png outputs (Default: `80`; Range: min: 0, max: 100)
- `guidance_scale` (number, optional): Guidance scale. Should be 0 for Turbo models (Default: `0`; Range: min: 0, max: 20)
- `seed` (integer, optional): Random seed. Set for reproducible generation
- `prompt` (string, **required**): Text prompt for image generation
- `width` (integer, optional): Width of the generated image (Default: `1024`; Range: min: 64, max: 2048)
- `num_inference_steps` (integer, optional): Number of inference steps. (Default: `8`; Range: min: 1, max: 50)
- `output_format` (string, optional): Format of the output images (Default: `jpg`; Options: `png`, `jpg`, `webp`)
- `height` (integer, optional): Height of the generated image (Default: `1024`; Range: min: 64, max: 2048)
- `go_fast` (boolean, optional): Apply additional optimizations for faster generation (Default: `False`)

## Example Request

```json
{
  "model": "prunaai/z-image-turbo",
  "input": {
    "output_format": "jpg",
    "guidance_scale": 0,
    "width": 1024,
    "prompt": "A hyper-realistic, close-up portrait of a tribal elder from the Omo Valley, painted with intricate white chalk patterns and adorned with a headdress made of dried flowers, seed pods, and rusted bottle caps. The focus is razor-sharp on the texture of the skin, showing every pore, wrinkle, and scar that tells a story of survival. The background is a blurred, smoky hut interior, with the warm glow of a cooking fire reflecting in the subject's dark, soulful eyes. Shot on a Leica M6 with Kodak Portra 400 film grain aesthetic.",
    "output_quality": 80,
    "height": 768,
    "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

url

## Tags

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

## Documentation

https://replicate.com/prunaai/z-image-turbo