# Iris-Z (`iris_z`)

> Iris-Z, a FLUX.2-based RGB and depth image model: text-to-image up to 1280x1024, or an image that follows a depth, disparity or colorized depth map at the 512 or 1024 tier.

- Capability: Images (tool `image`) — Text to image, Image to image
- Price: from $0.10 per run (1 credit = $0.01). Exact price for a request: POST https://api.varg.ai/v2/estimate
- Typical time: ~20 s
- JSON Schema: https://api.varg.ai/v2/tools/image?model=iris_z (public, no key)
- Try it: https://varg.ai/dashboard/tools/playground?model=iris_z

## Call it

REST: `POST https://api.varg.ai/v2/tools/image/call` with `Authorization: Bearer $VARG_API_KEY` (create a key at https://varg.ai/dashboard/api).
It answers `202` with a job right away. Poll `GET /v2/jobs/{id}` until `status` is `completed`, then read `output.outputs[0].url` — or pass `options.webhook_url` and get the finished job POSTed to you.

```bash
curl -X POST https://api.varg.ai/v2/tools/image/call \
  -H "Authorization: Bearer $VARG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "iris_z",
  "prompt": "a lighthouse on a rocky cliff at dusk, waves crashing below"
}'
```

MCP: the varg server `https://mcp.varg.ai/mcp` (OAuth sign-in, no key) runs it with `call_tool`:

```json
{
  "tool": "image",
  "input": {
    "model": "iris_z",
    "prompt": "a lighthouse on a rocky cliff at dusk, waves crashing below"
  },
  "wait": true
}
```

## Inputs

| field | type | required | default | allowed | description |
|---|---|---|---|---|---|
| `model` | string | yes | — | `iris_z` or a route key below | Which model runs the job. |
| `prompt` | string | no | — | — | — |
| `files` | array of { url } | no | — | — | — |
| `aspect_ratio` | string | no | — | e.g. 16:9 \| 9:16 \| 1:1 \| 4:3 \| 3:4 \| 21:9 \| auto | — |

Media inputs are URLs. Upload a local file first with `POST /v2/files` and pass the returned URL.

## Provider options

Optional, per provider, under `provider_options.<provider>`. Only the options of the provider that runs the job apply — pin a route to choose it.

### provider_options.fal

| field | type | required | default | allowed | description |
|---|---|---|---|---|---|
| `prompt` | string | no | — | — | The prompt to generate an image from. Prompts are truncated to 512 text-encoder tokens. |
| `image_size` | string | no | — | square_hd \| square \| portrait_4_3 \| portrait_16_9 \| landscape_4_3 \| landscape_16_9 | — |
| `output_format` | string | no | — | png \| jpeg | — |
| `num_inference_steps` | integer | no | — | 1–50 | The number of inference steps to perform. |
| `enable_safety_checker` | boolean | no | — | — | If set to true, the safety checker will be enabled. Disabling it requires account authorization; unauthorized requests are always checked, and images flagged as unsafe are returned as black images. |
| `resolution` | string | no | — | 512 \| 1024 | — |
| `depth_format` | string | no | — | depth \| disparity \| colorized | — |
| `depth_image_url` | string (URL) | no | — | — | URL of the depth map to paint an image from. |

## Routes

`"model": "iris_z"` picks a route automatically (priority order, then the inputs you send). To pin one, pass its key as `model`.

| model key | provider | modality | price from | typical time |
|---|---|---|---|---|
| `fal:speridlabs/iris-z/text-to-image` | fal | text-to-image | $0.10 | ~20 s |
| `fal:speridlabs/iris-z/depth-to-image` | fal | image-to-image | $0.14 | ~20 s |

---

Catalog version 2026-11-18T14:50:12.919827+00:00. All models: https://varg.ai/models/llms.txt
