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.
Use RunAPI to generate an image with Flux Kontext Pro.
Requirements:
- Call the RunAPI text_to_image endpoint at https://runapi.ai/v1/text_to_image
- Set model to "flux-kontext-pro"
- Use the RUNAPI_API_KEY environment variable for authorization
- The response is async — poll the task status endpoint until the task completes, then retrieve the image URL
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"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "flux-kontext-pro"
}
Usa Flux Kontext in OpenClaw in tre passaggi
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.
export RUNAPI_API_KEY=runapi_xxx
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.
text_to_image
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.
task_id: tsk_abc123
Parametri API Flux Kontext
| Parametro | Tipo | Descrizione |
|---|---|---|
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. |
Cos'è Flux Kontext su OpenClaw?
Flux Kontext di Black Forest Labs è un modello di modifica delle immagini continua che gli utenti dicono essere "migliore di ChatGPT e Gemini" per modifiche precise. Descrivi cosa cambiare in testo semplice, e modifica quella parte mantenendo tutto il resto intatto -- il volto rimane lo stesso quando si cambia un outfit, il prodotto rimane in posizione quando si sostituisce lo sfondo. Gli agenti OpenClaw lo chiamano tramite l'endpoint text_to_image di RunAPI.
Casi d'uso di Flux Kontext
Sostituzione dello sfondo mantenendo i soggetti
Cambiare gli sfondi di prodotti o ritratti mentre il soggetto rimane nella stessa posizione esatta -- nessun mascheramento, nessun inpainting, solo un'istruzione testuale.
Cambiamenti di abbigliamento e aspetto
Cambiare outfit, colore dei capelli o accessori su un personaggio preservando l'identità del viso, utile per mockup di moda e iterazione del design dei personaggi.
Sostituzione del testo su insegne ed etichette
Sostituire il testo su insegne, etichette di prodotti o vetrine nelle immagini esistenti -- digitare il nuovo testo nel prompt e Flux Kontext lo renderizza al suo posto.
Domande su Flux Kontext + 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.
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.
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.
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.
Configurazione generale di OpenClaw
Non ancora configurato? Inizia con la guida di configurazione RunAPI per OpenClaw.
Guida di configurazione di OpenClaw →Catalogo modelli Flux Kontext
Vedi tutte le varianti, i prezzi e la documentazione API di Flux Kontext.
Modelli Flux Kontext →Prova Flux Kontext in OpenClaw oggi.
Ottieni una API key RunAPI gratuita, incolla il prompt in OpenClaw e inizia a generare immagini con Flux Kontext.