# Z-Image Turbo API via PiAPI

Base URL: https://api.piapi.ai
Auth: X-API-Key header (get your key at https://piapi.ai/workspace/key)

Documentation: https://piapi.ai/docs/z-image-api/text-to-image

## Model

- Qubico/z-image (Z-Image Turbo by Alibaba Tongyi-MAI): ultra-fast
  text-to-image, images in as little as one second. Text-to-image only —
  Z-Image Edit is a separate variant that is not released yet.

## Pricing (per image, by output megapixels)

1 Mega Pixel = 1024 × 1024 pixels. Total price = price × batch_size.

- pixels ≤ 0.5MP: $0.002
- 0.5MP < pixels ≤ 1MP: $0.004
- 1MP < pixels ≤ 1.5MP: $0.006
- 1.5MP < pixels: $0.008

## Text to Image

POST /api/v1/task
{
  "model": "Qubico/z-image",
  "task_type": "txt2img",
  "input": {
    "prompt": "Minimal vertical poster with bold bilingual typography",
    "width": 1024,
    "height": 1024
  }
}

Input parameters:
- prompt (string, required)
- negative_prompt (string, optional)
- width / height (integer, 64–1440, default 1024)
- seed (integer, -1 = random)
- flow_shift (number, 0.3–7, default 3 — increase if images look blurry/dark)
- batch_size (integer, optional)

## Get Task Result

GET /api/v1/task/{task_id}

Status: "pending" → "processing" → "completed" or "failed"
Image URL: response.data.output.image_url (or output.image_urls[])

## Quick Start

1. Get API key: https://piapi.ai/workspace/key
2. Top up: https://piapi.ai/workspace/billing (from $0.002/image)
3. POST /api/v1/task
4. Poll GET /api/v1/task/{task_id} until "completed" (often ~1s)
5. Get image from response.data.output.image_url