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

# Usa GPT Image in Hermes Agent.

GPT Image 2 è il modello dedicato di OpenAI per la generazione di immagini — text-to-image e modifica immagini basata su istruzioni con risoluzione di output fino a 4K e supporto per sfondo trasparente. Hermes Agent lo chiama tramite lo stesso provider custom RunAPI e la stessa API key usati per la chat, senza necessità di ComfyUI o 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": "gpt-image-2-text-to-image",
    "prompt": "A product photo of a glass perfume bottle on a marble surface, transparent background, studio lighting, the label reads AURORA in gold serif font",
    "output_resolution": "2k",
    "aspect_ratio": "3:4"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "gpt-image-2-text-to-image"
}

```

## How it works

1. **Configura RunAPI** — Imposta la variabile d'ambiente RUNAPI_API_KEY nel tuo profilo shell. Se il provider custom:runapi è già configurato in Hermes Agent per la chat, la stessa key e base_url funzionano per GPT Image — nessuna configurazione aggiuntiva necessaria.
2. **Chiama GPT Image 2** — Invia una richiesta POST all'endpoint text_to_image con model impostato su gpt-image-2-text-to-image. Includi un prompt descrittivo con istruzioni di layout e stile. Imposta output_resolution su 2k o 4k per maggiore dettaglio. Per modificare immagini esistenti, usa l'endpoint edit_image con gpt-image-2-image-to-image e fornisci source_image_urls.
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 di output dalla risposta. GPT Image 2 in genere completa entro 10–30 secondi a seconda della risoluzione.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obbligatorio. gpt-image-2-text-to-image per la generazione, gpt-image-2-image-to-image per la modifica. |
| `prompt` | `string` | Obbligatorio. Descrizione in linguaggio naturale dell'immagine desiderata. Supporta istruzioni dettagliate per layout, sovrapposizioni di testo e stile. |
| `output_resolution` | `string` | Facoltativo. Risoluzione di output — 1k (predefinito), 2k o 4k. Una risoluzione più alta costa di più per immagine. |
| `aspect_ratio` | `string` | Facoltativo. Il valore predefinito è auto. Supporta 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16 e altro. |
| `source_image_urls` | `array` | Obbligatorio per l'endpoint edit_image. Uno o più URL di immagini sorgente da modificare. |

## FAQ

### Posso usare GPT Image 2 in Hermes Agent?

Sì. Hermes Agent chiama GPT Image 2 tramite l'endpoint RunAPI text_to_image. Imposta il campo model su gpt-image-2-text-to-image e invia la richiesta con la stessa RUNAPI_API_KEY configurata per il provider custom:runapi. Nessun ComfyUI o GPU in affitto richiesti.

### Qual è la differenza tra GPT Image 2 e GPT-4o Image?

GPT Image 2 è il modello dedicato di OpenAI per la generazione di immagini con qualità superiore, output 4K e supporto per sfondo trasparente. GPT-4o Image genera immagini all'interno di un contesto chat ma è limitato ai rapporti d'aspetto 1:1, 3:2 o 2:3. Entrambi sono disponibili tramite RunAPI — usa gpt-image-2-text-to-image per la generazione autonoma e gpt-4o-image per l'output di immagini integrato nella chat.

### GPT Image 2 supporta gli sfondi trasparenti?

Sì. GPT Image 2 può produrre immagini con sfondo trasparente quando indicato nel prompt. Questo è utile per foto di prodotti, loghi ed elementi UI che necessitano di compositing. Descrivi la trasparenza nel prompt — ad esempio, "foto prodotto su sfondo trasparente".

### Come differisce il prezzo di GPT Image 2 da GPT-4o Image?

GPT Image 2 è fatturato per immagine in base alla risoluzione di output: 1k, 2k o 4k. GPT-4o Image è fatturato per immagine in base al numero di output — generare 2 o 4 immagini in una singola richiesta costa di più per immagine. Entrambi usano la fatturazione pay-as-you-go senza minimo mensile. Controlla la pagina dei prezzi di RunAPI per le tariffe aggiornate.

### Hermes Agent può modificare immagini con GPT Image 2 invece di ComfyUI?

Sì. Usa l'endpoint edit_image con model impostato su gpt-image-2-image-to-image. Passa le immagini sorgente in source_image_urls e descrivi la modifica in linguaggio naturale — "rimuovi lo sfondo," "aggiungi occhiali da sole," "cambia il testo in HELLO." Nessun grafico di flusso ComfyUI, nessuna istanza GPU, nessuna maschera di inpainting necessaria.


## Links

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