---
title: "Usa Nano Banana in Hermes Agent tramite RunAPI — Guida API Immagini"
url: "https://runapi.ai/it/hermes-nano-banana.md"
canonical: "https://runapi.ai/it/hermes-nano-banana"
locale: "it"
model: "nano-banana"
---

# Usa Nano Banana in Hermes Agent.

Nano Banana è il modello di generazione di immagini nativo Gemini di Google con un rendering del testo nelle immagini generate senza eguali nel settore. Pro produce output fino a 4K di risoluzione, Nano Banana 2 è ottimizzato per la velocità con rapporti d'aspetto estesi, ed Edit modifica le immagini esistenti. Hermes Agent chiama tutte e tre tramite il provider personalizzato RunAPI — nessuna configurazione ComfyUI o GPU necessaria.

## API example

```bash
curl -X POST https://runapi.ai/api/v1/nano_banana/text_to_image \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-pro",
    "prompt": "A minimalist product card for a coffee brand, the text DARK ROAST in bold sans-serif across the top, a steaming cup below, warm studio lighting",
    "aspect_ratio": "4:3",
    "output_resolution": "4k",
    "output_format": "png"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "nano-banana-pro"
}

```

## 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 Nano Banana.
2. **Chiama Nano Banana** — Invia una POST all'endpoint text_to_image con model impostato su nano-banana-pro per la massima qualità, nano-banana-2 per la velocità, o nano-banana per la variante base. Imposta output_resolution su 4k su Pro o 2 per il massimo dettaglio. Per la modifica, invia una POST a edit_image con nano-banana-edit e includi un image_url.
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. Gli SDK RunAPI e la CLI gestiscono automaticamente il polling.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obbligatorio. nano-banana-pro (massima qualità, 4K), nano-banana-2 (veloce, rapporti estesi), nano-banana (base), o nano-banana-edit (modifica). |
| `prompt` | `string` | Descrizione testuale dell'immagine desiderata. Includi qualsiasi testo che vuoi renderizzato nell'immagine — Nano Banana gestisce la tipografia nativamente. |
| `image_url` | `string` | URL dell'immagine sorgente. Obbligatorio per nano-banana-edit, ignorato per le varianti text_to_image. |
| `aspect_ratio` | `string` | Facoltativo. Rapporto d'aspetto dell'output. Pro accetta: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, auto. Nano Banana 2 aggiunge 1:4, 1:8, 4:1, 8:1. |
| `output_resolution` | `string` | Facoltativo. Solo Pro e 2. Valori accettati: 1k, 2k, 4k. Il valore predefinito è 1k. |
| `output_format` | `string` | Facoltativo. Formato del file di output. Valori accettati: png, jpeg, jpg. |
| `callback_url` | `string` | Facoltativo. URL webhook che riceve una POST quando il task è completato. |

## FAQ

### Qual è la differenza tra Nano Banana Pro, 2 e la variante base?

Nano Banana Pro offre la massima qualità dell'immagine con una risoluzione di output fino a 4K. Nano Banana 2 è ottimizzato per la velocità e supporta rapporti d'aspetto aggiuntivi come 1:4 e 8:1 per formati banner e verticali. La variante base nano-banana è l'opzione più conveniente a risoluzione standard. Tutte e tre condividono lo stesso endpoint text_to_image.

### Come passo tra la generazione text-to-image e la modifica di immagini in Hermes Agent?

Per la generazione text-to-image, invia una POST a /api/v1/nano_banana/text_to_image con qualsiasi variante di generazione (nano-banana-pro, nano-banana-2, o nano-banana). Per la modifica, invia una POST a /api/v1/nano_banana/edit_image con model nano-banana-edit e includi il source image_url. Entrambi gli endpoint usano lo stesso provider custom:runapi e RUNAPI_API_KEY.

### Come funziona il pricing dell'output 4K di Nano Banana?

Il pricing di Nano Banana Pro varia in base a output_resolution: 1k e 2k hanno la stessa tariffa, mentre 4k costa di più per immagine. Nano Banana 2 segue una struttura a livelli simile. Consulta la pagina dei prezzi di RunAPI per le tariffe esatte per immagine. Non è previsto un minimo mensile.

### Nano Banana può renderizzare testo leggibile nelle immagini generate?

Sì. Nano Banana è specificamente progettato per un rendering del testo accurato nelle immagini. Includi le parole esatte che vuoi nel prompt — il modello gestisce nativamente il posizionamento dei caratteri e la leggibilità, a differenza della maggior parte dei modelli di diffusione che distorcono le forme delle lettere.

### Hermes Agent ha bisogno di ComfyUI o di una GPU per usare Nano Banana?

No. Hermes Agent chiama Nano Banana tramite l'endpoint del provider RunAPI custom:runapi. RunAPI gestisce tutta l'infrastruttura GPU lato server. Nessun workflow ComfyUI, nessun noleggio GPU cloud, nessun requisito VRAM locale — invia un prompt e ricevi un URL di immagine.


## Links

- [Guida di configurazione di Hermes Agent →](https://runapi.ai/it/hermes-agent)
- [Modelli Nano Banana →](https://runapi.ai/it/models/nano-banana)
- [Model catalog](https://runapi.ai/it/models)
- [API docs](https://runapi.ai/it/docs)