--- title: "Usa GPT Image in OpenClaw tramite RunAPI — Guida API Immagini" url: "https://runapi.ai/it/openclaw-gpt-image.md" canonical: "https://runapi.ai/it/openclaw-gpt-image" locale: "it" model: "gpt-image" --- # 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. ## 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": "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" }' ``` ### Response ```json { "task_id": "tsk_abc123", "status": "pending", "model": "gpt-image-2-text-to-image" } ``` ## How it works 1. **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. 2. **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. 3. **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. ## Parameters | Parameter | Type | Description | |-----------|------|-------------| | `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. | ## FAQ ### Posso usare GPT Image 2 in 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. ### Qual è la differenza tra GPT Image 2 e GPT-4o Image? 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. ### GPT Image 2 supporta gli sfondi trasparenti? 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". ### Come funziona il prezzo di GPT Image 2 su RunAPI? 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. ### Posso modificare un'immagine esistente con GPT Image 2? 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. ## Links - [Guida di configurazione di OpenClaw →](https://runapi.ai/it/openclaw) - [Modelli GPT Image →](https://runapi.ai/it/models/gpt-image) - [Model catalog](https://runapi.ai/it/models) - [API docs](https://runapi.ai/it/docs)