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

# Usa Flux 2 in OpenClaw.

Flux 2 di Black Forest Labs offre due livelli di qualità — Pro per generazione veloce ed economica a 5 centesimi per immagine, e Flex per output ad alta fedeltà. Entrambi supportano text-to-image e remix multi-sorgente a risoluzione 1k o 2k. Gli agenti OpenClaw lo chiamano tramite la stessa API key RunAPI usata 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à configurato RunAPI come provider OpenClaw per la chat, la stessa key funziona 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.

### Posso fare remix di più immagini sorgente con Flux 2?

Sì. Usa l'endpoint remix_image con model flux-2-pro-remix-image o flux-2-flex-remix-image. Passa un array di URL di immagini sorgente in source_image_urls insieme a un prompt di testo che descrive l'output desiderato.

### 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.

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

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

### Flux 2 è asincrono o sincrono?

Asincrono. L'API restituisce immediatamente un task ID. Esegui il polling dell'endpoint di stato del task o imposta un webhook callback_url per ricevere l'URL dell'immagine completata. Gli SDK RunAPI e la CLI gestiscono il polling automaticamente.


## Links

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