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

# Usa Flux Kontext in OpenClaw.

Flux Kontext di Black Forest Labs gestisce editing e generazione di immagini guidati da testo con coerenza dei personaggi. Gli agenti OpenClaw lo chiamano tramite RunAPI con la stessa API key usata per la chat — invia un prompt, ricevi un URL dell'immagine.

## 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-kontext-pro",
    "prompt": "a matte-black water bottle on a beige stone surface, soft side light, studio photography"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "flux-kontext-pro"
}

```

## 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 — nessuna configurazione aggiuntiva necessaria.
2. **Chiama Flux Kontext** — Invia una richiesta POST all'endpoint text_to_image con model impostato su flux-kontext-pro. Includi un prompt di testo che descrive l'immagine desiderata. Facoltativamente passa un image_url per l'editing in-context.
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.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `model` | `string` | Obbligatorio. flux-kontext-pro o flux-kontext-max. |
| `prompt` | `string` | Istruzione testuale per la generazione o l'editing. |
| `image_url` | `string` | URL dell'immagine sorgente per l'editing in-context. |
| `aspect_ratio` | `string` | Facoltativo. Rapporto d'aspetto dell'output. |

## FAQ

### Posso usare Flux Kontext in OpenClaw?

Sì. Configura RunAPI come provider compatibile con OpenAI in OpenClaw, poi chiama l'endpoint text_to_image con model impostato su flux-kontext-pro. La stessa RUNAPI_API_KEY che usi per la chat gestisce la generazione di immagini.

### Ho bisogno di una API key separata per Flux Kontext?

No. La stessa RUNAPI_API_KEY funziona per tutti i modelli RunAPI — LLM, immagini, video e musica. Una sola key, un solo account di fatturazione.

### Flux Kontext è asincrono o sincrono?

Asincrono. L'API restituisce immediatamente un task ID. Esegui il polling dell'endpoint di stato del task o usa un webhook callback per ricevere l'URL dell'immagine completata.

### Quanto costa Flux Kontext?

Flux Kontext Pro parte da 2,5 centesimi per immagine. Flux Kontext Max costa di più per una fedeltà maggiore. Controlla la pagina dei prezzi di RunAPI per le tariffe aggiornate — la fatturazione è pay-as-you-go senza abbonamento.


## Links

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