---
title: "Usa Imagen 4 in Hermes Agent tramite RunAPI — Guida API Immagini"
url: "https://runapi.ai/it/hermes-imagen-4.md"
canonical: "https://runapi.ai/it/hermes-imagen-4"
locale: "it"
model: "imagen-4"
---

# Usa Imagen 4 in Hermes Agent.

Imagen 4 è il modello di generazione di immagini di Google DeepMind con rendering del testo preciso e alta fedeltà ai prompt. Hermes Agent lo chiama tramite lo stesso endpoint RunAPI che usi per la chat — senza ComfyUI o configurazione 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": "imagen-4",
    "prompt": "A ceramic coffee mug on a wooden table with morning light, the text HELLO printed on the side in serif font, photorealistic"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "imagen-4"
}

```

## How it works

1. **Configura RunAPI** — Imposta la variabile d'ambiente RUNAPI_API_KEY. Se hai già configurato RunAPI come provider custom:runapi in Hermes Agent per la chat, la stessa key e base_url funzionano per la generazione di immagini.
2. **Chiama Imagen 4** — Invia una richiesta POST all'endpoint text_to_image con model impostato su imagen-4. Includi un prompt descrittivo. Aggiungi aspect_ratio o negative_prompt se necessario.
3. **Ottieni il risultato** — La risposta include un task_id. Esegui il polling dell'endpoint di stato del task finché lo stato non cambia in completed. La risposta finale contiene l'URL dell'immagine generata.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obbligatorio. imagen-4, imagen-4-fast o imagen-4-ultra. |
| `prompt` | `string` | Descrizione testuale dell'immagine desiderata. |
| `aspect_ratio` | `string` | Facoltativo. Es. 1:1, 16:9, 9:16. |
| `negative_prompt` | `string` | Facoltativo. Cosa evitare nell'immagine generata. |

## FAQ

### Posso usare Imagen 4 in Hermes Agent?

Sì. Hermes Agent chiama Imagen 4 tramite l'endpoint text_to_image di RunAPI. Imposta il campo model su imagen-4 e invia la richiesta con la stessa RUNAPI_API_KEY che hai configurato per il provider custom:runapi. Non è richiesto ComfyUI o noleggio GPU.

### Ho bisogno di una API key separata per Imagen 4?

No. La stessa RUNAPI_API_KEY funziona per tutti i 113+ modelli tra chat, immagini, video e musica. Una sola key, un solo account di fatturazione.

### Imagen 4 è asincrono o sincrono?

Imagen 4 è asincrono. La richiesta iniziale restituisce un task_id con stato pending. Esegui il polling dell'endpoint di stato del task finché non si completa, poi recupera l'URL dell'immagine dalla risposta. Gli SDK RunAPI gestiscono il polling automaticamente.

### Quanto costa Imagen 4 tramite RunAPI?

Il prezzo di Imagen 4 è pay-as-you-go senza minimo mensile. Il costo varia per livello: imagen-4-fast è il più economico, imagen-4 è standard e imagen-4-ultra è la qualità più alta. Controlla la pagina dei prezzi di RunAPI per le tariffe aggiornate per immagine.


## Links

- [Guida di configurazione di Hermes Agent →](https://runapi.ai/it/hermes-agent)
- [Modelli Imagen 4 →](https://runapi.ai/it/models/imagen-4)
- [Model catalog](https://runapi.ai/it/models)
- [API docs](https://runapi.ai/it/docs)