---
title: "Usa Z Image in Hermes Agent tramite RunAPI — Guida API Immagini"
url: "https://runapi.ai/it/hermes-z-image.md"
canonical: "https://runapi.ai/it/hermes-z-image"
locale: "it"
model: "z-image"
---

# Usa Z Image in Hermes Agent.

Z Image è il modello di generazione rapida di immagini di Alibaba con rendering bilingue del testo in cinese e inglese. Hermes Agent lo chiama tramite l'endpoint RunAPI personalizzato — la stessa base_url e API key che usi per la chat, senza plugin aggiuntivi o noleggio GPU.

## API example

```bash
curl -X POST https://runapi.ai/v1/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "z-image",
    "prompt": "A neon-lit Tokyo street at night with Japanese shop signs, cinematic lighting, 8K detail"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "z-image"
}

```

## How it works

1. **Configura RunAPI** — Imposta la tua API key RunAPI come variabile d'ambiente. Se hai già configurato RunAPI come provider personalizzato in Hermes Agent, la stessa key e base_url funzionano per la generazione di immagini.
2. **Chiama Z Image** — Invia una richiesta POST all'endpoint text_to_image con model impostato su z-image e un prompt di testo. Z Image supporta prompt in cinese e inglese con rendering preciso del testo.
3. **Ottieni il risultato** — L'API restituisce immediatamente un task_id. Esegui il polling dell'endpoint di stato del task finché lo stato non cambia in completed, poi recupera l'URL dell'immagine generata dall'output della risposta.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obbligatorio. Usa z-image. |
| `prompt` | `string` | Descrizione testuale. Supporta cinese e inglese. |
| `negative_prompt` | `string` | Facoltativo. Cosa evitare nell'immagine. |
| `size` | `string` | Facoltativo. Dimensioni dell'output, es. 1024x1024. |

## FAQ

### Posso usare Z Image in Hermes Agent?

Sì. Se hai RunAPI configurato come provider personalizzato in Hermes Agent, la stessa API key e base_url gestiscono le richieste Z Image. Invia un POST all'endpoint text_to_image con model impostato su z-image.

### Ho bisogno di una API key separata per Z Image?

No. La stessa RUNAPI_API_KEY che usi per la chat e altri modelli funziona anche per Z Image. Tutti i modelli RunAPI condividono una sola key e un saldo crediti.

### Z Image è asincrono o sincrono?

Z Image è asincrono. L'API restituisce immediatamente un task_id. Esegui il polling dell'endpoint di stato del task o usa un webhook callback per sapere quando l'immagine è pronta. Gli SDK RunAPI gestiscono il polling automaticamente.

### Quanto costa Z Image?

Z Image usa prezzi pay-as-you-go con fatturazione per task. Controlla la pagina dei prezzi di RunAPI per la tariffa aggiornata. Non c'è abbonamento mensile o spesa minima.


## Links

- [Guida di configurazione di Hermes Agent →](https://runapi.ai/it/hermes-agent)
- [Modelli Z Image →](https://runapi.ai/it/models/z-image)
- [Model catalog](https://runapi.ai/it/models)
- [API docs](https://runapi.ai/it/docs)