Usa GPT Image in OpenClaw.
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. Gli agenti OpenClaw lo chiamano tramite la stessa API key RunAPI e l'endpoint /v1 usati per la chat, senza skill aggiuntive da installare.
Usa RunAPI per generare un'immagine con OpenAI GPT Image 2.
Requisiti:
- Usa l'API RunAPI su https://runapi.ai/v1/text_to_image.
- Leggi la API key dalla variabile d'ambiente RUNAPI_API_KEY.
- Imposta il model su "gpt-image-2-text-to-image".
- Scrivi un prompt descrittivo. GPT Image 2 segue attentamente le istruzioni in linguaggio naturale — descrivi layout, stile, sovrapposizioni di testo e necessità di trasparenza.
- Facoltativamente imposta output_resolution su 1k, 2k o 4k. Il valore predefinito è 1k.
- La risposta restituisce un task_id. Esegui il polling dell'endpoint di stato del task finché il task non viene completato, poi recupera l'URL di output.
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"
}'
{
"task_id": "tsk_abc123",
"status": "pending",
"model": "gpt-image-2-text-to-image"
}
Usa GPT Image in OpenClaw in tre passaggi
Configura RunAPI
Imposta la variabile d'ambiente RUNAPI_API_KEY nel tuo profilo shell. Se RunAPI è già configurato in OpenClaw per la chat, la stessa key funziona per GPT Image — nessuna configurazione aggiuntiva necessaria.
export RUNAPI_API_KEY=runapi_xxx
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.
POST /v1/text_to_image
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.
task_id: tsk_abc123
Parametri API GPT Image
| Parametro | Tipo | Descrizione |
|---|---|---|
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. |
Cos'è GPT Image su OpenClaw?
GPT Image 2 è il modello di immagine dedicato di OpenAI che funziona più come un assistente di design strutturato che come un generatore guidato da parole chiave. Gli fornisci un brief di produzione -- layout, posizionamento del testo, vincoli di stile -- e segue le istruzioni da vicino. Gli utenti riportano forte coerenza dei personaggi, rendering del testo pulito e layout leggibili, sebbene la qualità possa degradarsi attraverso più passaggi di raffinamento iterativo. Gli agenti OpenClaw lo chiamano tramite lo stesso endpoint RunAPI usato per la chat.
Casi d'uso di GPT Image
Mockup UI e wireframe di design delle app
Generare mockup UI dettagliati da descrizioni scritte, inclusi layout di pulsanti, barre di navigazione e contenuto segnaposto che si legge correttamente.
Poster ricchi di testo e presentazioni
Creare poster con testo esatto, infografiche e slide di presentazione dove il contenuto testuale è specificato nel prompt e renderizzato con layout puliti e leggibili.
Schede di design dei personaggi
Generare schede di design dei personaggi con viste di rotazione da una singola descrizione, mantenendo caratteristiche coerenti su più angolazioni.
Domande su GPT Image + OpenClaw
Sì. Gli agenti OpenClaw chiamano 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 che usi per la chat. Nessuna skill o plugin aggiuntivo richiesto.
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.
Sì. GPT Image 2 può produrre immagini con sfondo trasparente quando indicato nel prompt. Questo è utile per foto di prodotti, loghi ed elementi UI. Specifica la trasparenza nel prompt — ad esempio, "foto prodotto con sfondo trasparente".
GPT Image 2 è fatturato per immagine in base alla risoluzione di output: 1k è il costo più basso, 2k è nella fascia media e 4k è il più costoso. La stessa tariffa si applica sia a text_to_image che a edit_image. Controlla la pagina dei prezzi di RunAPI per le tariffe aggiornate. Le generazioni fallite non vengono addebitate.
Sì. Usa l'endpoint edit_image con model impostato su gpt-image-2-image-to-image. Passa gli URL delle immagini sorgente in source_image_urls e descrivi la modifica nel prompt — ad esempio, "cambia lo sfondo con un tramonto sulla spiaggia" o "aggiungi un cappello rosso alla persona". GPT Image 2 segue le istruzioni di modifica in linguaggio naturale.
Configurazione generale di OpenClaw
Non ancora configurato? Inizia con la guida di configurazione RunAPI per OpenClaw.
Guida di configurazione di OpenClaw →Catalogo modelli GPT Image
Vedi tutte le varianti, i prezzi e la documentazione API di GPT Image.
Modelli GPT Image →Prova GPT Image in OpenClaw oggi.
Ottieni una API key RunAPI gratuita, incolla il prompt in OpenClaw e inizia a generare e modificare immagini con OpenAI GPT Image 2.