Generazione di immagini GPT-Image-2

• Modello: gpt-image-2
• Endpoint: POST https://apimaster.ai/v1/images/generations
• Modalità: Asincrona — restituisce task_id, poi interroga il task
• Funzionalità: Testo-immagine; immagine-immagine con fino a 16 immagini di riferimento (URL + base64 mix)

Autenticazione

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Parametri del corpo

Campo	Tipo	Obbligatorio	Note
model	string	sì	gpt-image-2
prompt	string	sì	Descrizione della scena; si applica la moderazione di sicurezza
n	integer	no	Solo 1 (numerico, senza virgolette)
size	string	no	Rapporto d'aspetto, default 1:1
resolution	string	no	1k / 2k / 4k, default 1k
image_urls	array	no	Immagini di riferimento → immagine-immagine
official_fallback	boolean	no	Fallback canale ufficiale, default false

Valori size

auto, 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 2:1, 1:2, 3:1, 1:3, 21:9, 9:21, o stringhe di pixel come 3840x2160.

risoluzione (pixel di esempio)

size	1k	2k	4k
1:1	1024×1024	2048×2048	2880×2880
16:9	1536×864	2048×1152	3840×2160

Tutti i 15 rapporti supportano il 4K.

image_urls

• Massimo 16 immagini
• URL pubblici e URI dati base64 possono essere mescolati
• Ometti size per seguire la risoluzione di input; imposta size per forzare il rapporto d'aspetto dell'output

Esempi

Testo-immagine minimale

{
  "model": "gpt-image-2",
  "prompt": "An orange cat on a windowsill at sunset, watercolor"
}

16:9 @ 2K

curl -s "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a corgi astronaut on the moon, cinematic",
    "size": "16:9",
    "resolution": "2k"
  }'

Risposta di invio

{
  "code": 200,
  "data": [{ "status": "submitted", "task_id": "task_01KPQ7J7DWB7QZ3WCEK3YVPBRA" }]
}

HTTP	Significato
400	Parametri non validi
401	Chiave API errata
402	Saldo insufficiente
429	Limite di velocità superato

Interrogazione del risultato del task

curl -s "https://apimaster.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

URL immagine: data.result.images[0].url[0]

stato	Significato
submitted	In coda
processing	In esecuzione
completed	Pronto
failed	Vedi errore

Interroga dopo 10–20 secondi, ogni 3–5 secondi. Batch: POST https://apimaster.ai/v1/tasks/batch con {"task_ids":[...]}.

Note

• Solo asincrono — nessun URL immagine sincrono nella risposta di creazione.
• Preferisci size per il rapporto d'aspetto; evita di ripetere il rapporto in prompt.
• Fatturazione per livello di risoluzione; consulta la console per il tuo account.

Confronta con canale ufficiale.