> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hoox.video/llms.txt
> Use this file to discover all available pages before exploring further.

# Z-Image Turbo

> Z-Image · `z-image-turbo` · image

## Identifier

Use the model identifier `z-image-turbo` in the `model` field when calling [`/asset/start`](/api-reference/assets/start).

## Capabilities

| Property         | Value                                                |
| ---------------- | ---------------------------------------------------- |
| Reference inputs | 0–1                                                  |
| Aspect ratios    | `16:9`, `9:16`, `1:1`, `4:3`, `3:4` (default `16:9`) |

## Inputs

Pass reference media in the `references` array (0–1 item). Optional. Each item accepts exactly one of:

* `url` — a direct, publicly accessible file URL
* `asset_id` — the ID of an existing asset in your Hoox space (e.g. a previous generation)
* `avatar_id` — the ID of an avatar defined in your Hoox space

## Pricing

Default parameters: **\~0.1 credits / generation**.

For exact pricing with your own parameters, call [`/asset/pricing`](/api-reference/assets/pricing) with the `model` and any parameters that affect cost.

## Example request

```json theme={null}
{
  "type": "image",
  "model": "z-image-turbo",
  "prompt": "Describe what you want to generate",
  "aspect_ratio": "16:9"
}
```

See [`/asset/start`](/api-reference/assets/start) for the full request/response reference, error codes, and code samples in cURL / Python / JavaScript.