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

# Usa Flux 2 in Hermes Agent.

Flux 2 di Black Forest Labs offre due livelli di qualità — Pro a 5 centesimi per immagine per generazione veloce, e Flex a 14 centesimi per fedeltà superiore. Entrambi supportano text-to-image e remix multi-sorgente a risoluzione 1k o 2k. Hermes Agent lo chiama tramite il provider custom:runapi — stessa key e base URL configurate per la chat.

## 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": "flux-2-pro-text-to-image",
    "prompt": "a ceramic vase with dried flowers on a linen tablecloth, natural window light, 35mm film grain",
    "aspect_ratio": "3:4",
    "output_resolution": "2k"
  }'

```

### Response

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

```

## How it works

1. **Configura RunAPI** — Imposta la variabile d'ambiente RUNAPI_API_KEY. Se hai già aggiunto RunAPI come provider custom:runapi in Hermes Agent per la chat, la stessa key e base_url funzionano per la generazione di immagini con Flux 2 — nessuna configurazione aggiuntiva necessaria.
2. **Chiama Flux 2** — Invia una richiesta POST all'endpoint text_to_image con model impostato su flux-2-pro-text-to-image. Includi un prompt e facoltativamente imposta aspect_ratio (1:1, 4:3, 16:9, ecc.) e output_resolution (1k o 2k). Per il remix multi-sorgente, usa l'endpoint remix_image con source_image_urls.
3. **Ottieni il risultato** — L'endpoint restituisce 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 dalla risposta. Gli SDK RunAPI e la CLI gestiscono il polling automaticamente.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obbligatorio. flux-2-pro-text-to-image, flux-2-flex-text-to-image, flux-2-pro-remix-image o flux-2-flex-remix-image. |
| `prompt` | `string` | Descrizione testuale dell'immagine da generare. |
| `aspect_ratio` | `string` | Facoltativo. Rapporto d'aspetto dell'output: 1:1, 4:3, 3:4, 16:9, 9:16, 3:2 o 2:3. Gli endpoint remix accettano anche auto. |
| `output_resolution` | `string` | Facoltativo. 1k (predefinito) o 2k. Una risoluzione più alta costa di più per immagine. |
| `source_image_urls` | `array` | Obbligatorio per remix_image. Array di URL di immagini sorgente da mixare o trasformare. |
| `callback_url` | `string` | Facoltativo. URL webhook per la notifica asincrona di completamento. |

## FAQ

### Qual è la differenza tra Flux 2 Pro e Flux 2 Flex?

Pro è il livello più veloce ed economico a 5 centesimi per immagine 1k. Flex produce output ad alta fedeltà a 14 centesimi per immagine 1k. Entrambi condividono gli stessi parametri API e supportano gli endpoint text_to_image e remix_image tramite il provider custom:runapi.

### Hermes Agent può chiamare l'endpoint remix_image di Flux 2?

Sì. Usa model flux-2-pro-remix-image o flux-2-flex-remix-image con l'endpoint remix_image. Passa source_image_urls come array di URL di immagini insieme a un prompt di testo. Il provider custom:runapi gestisce la richiesta nello stesso modo di text_to_image.

### La risoluzione di output di Flux 2 influisce sui prezzi?

Sì. Ogni variante fattura per immagine con prezzi basati sulla risoluzione. Ad esempio, Flux 2 Pro costa 5 centesimi a 1k e 7 centesimi a 2k. Flux 2 Flex costa 14 centesimi a 1k e 24 centesimi a 2k. Controlla la pagina dei prezzi di RunAPI per le tariffe aggiornate.

### Ho bisogno di una configurazione provider separata per la generazione di immagini con Flux 2?

No. Il provider custom:runapi che hai configurato per la chat funziona già per Flux 2 e tutti gli altri modelli RunAPI. La stessa RUNAPI_API_KEY, base_url e nome del provider gestiscono richieste LLM, immagini, video e musica.

### Come si confronta Flux 2 con Flux Kontext su RunAPI?

Flux Kontext si specializza nell'editing guidato da testo con una singola immagine di input e nella coerenza dei personaggi. Flux 2 si concentra sulla generazione text-to-image e sul remix multi-sorgente con livelli di qualità Pro/Flex selezionabili e opzioni di risoluzione 1k/2k. Entrambi sono di Black Forest Labs e condividono la stessa API key e fatturazione RunAPI.


## Links

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