# z-image-turbo

> Z-Image Turbo: fast text-to-image generation

This file is intended for AI coding agents wiring an application to this specific Chutes model.

## Important URLs

- Model page: https://chutes.ai/app/chute/vonkaiser-z-image-turbo
- Model llms.txt: https://chutes.ai/app/chute/vonkaiser-z-image-turbo/llms.txt
- Global Chutes llms.txt: https://chutes.ai/llms.txt
- Full Chutes docs export: https://chutes.ai/llms-full.txt
- OpenAPI schema: https://api.chutes.ai/openapi.json

## Model Identifiers

- Name: `z-image-turbo`
- Chute ID: `2cc39ac2-4e9f-50de-849f-e99e45729396`
- Slug: `vonkaiser-z-image-turbo`
- Owner: `vonkaiser`

## Authentication

- Use `Authorization: Bearer $CHUTES_API_KEY` for inference calls.
- Send JSON request bodies with `Content-Type: application/json` unless the endpoint documentation says otherwise.
- The request body is FLAT — send the request fields at the top level (no `input_args`/`args` wrapper).
- This model is served on its own host (`https://vonkaiser-z-image-turbo.chutes.ai`). Call the endpoint paths listed below directly.
- For base64 media fields, send raw base64 strings in API requests. The web playground may use temporary Blob upload references internally for large files before proxying to Chutes.

## Playground Notes

- Use short negative prompts for obvious exclusions rather than long lists.
- Keep dimensions moderate while iterating, then increase quality settings for final runs.

## Endpoints

### 1. POST /generate

- Base URL: `https://vonkaiser-z-image-turbo.chutes.ai`
- Output content type: `image/png`
- Playground note: Start with a concrete subject, style, composition, lighting, and output constraints.

Request fields:

- `seed` (integer, optional) Default: null.
- `shift` (number, optional) Default: 3.
- `width` (integer, optional) Default: 1024.
- `height` (integer, optional) Default: 1024.
- `prompt` (string, required)
- `guidance_scale` (number, optional) Default: 0.
- `max_sequence_length` (integer, optional) Default: 512.
- `num_inference_steps` (integer, optional) Default: 9.

Example call:

```bash
curl -X POST "https://vonkaiser-z-image-turbo.chutes.ai/generate" \
  -H "Authorization: Bearer $CHUTES_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "seed": 42,
  "shift": 3,
  "width": 1024,
  "height": 1024,
  "prompt": "a serene mountain lake at sunset",
  "guidance_scale": 0,
  "max_sequence_length": 512,
  "num_inference_steps": 9
}' \
  --output output.png
```

Playground presets:

- Clean product render
- Editorial illustration

## Agent Integration Checklist

- Pick the endpoint path that matches the desired task.
- Set `CHUTES_API_KEY` in the server-side environment only.
- Validate required fields before sending requests.
- For media models, keep file upload, base64 conversion, and output preview/download handling explicit in the app UI.