Introduzione
Il text-to-image di Sunburst parte dalla tua descrizione, senza un’immagine in input. Il livello di precisione offre cinque impostazioni di qualità per controllare il dettaglio e dimensioni di output fino a circa 8,3 megapixel.
| Campo | Valore |
|---|---|
| Input | Testo |
| Output | Immagine |
| Editore | OpenAI |
| Data di rilascio | 2026-11-05 |
| Modello API | gpt-image-2.6-sunburst |
| Endpoint pubblici | openai/gpt-image-2.6-sunburst/text-to-image; openai/gpt-image-2.6-sunburst/edit |
| Qualità | low, medium (predefinito), high, xhigh, max |
| Risoluzione | 1k: circa 1 MP; 2k: circa 3,7 MP; 4k: circa 8,3 MP |
| Dimensioni in 16:9 | 2k: 2560 x 1440; 4k: 3840 x 2160 |
| Proporzioni | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21, 2:1, 1:2, 3:1, 1:3, 5:4, 4:5 |
| Numero di output | 1–10 immagini per richiesta |
| Sorgenti per le modifiche | 1–16 immagini in input |
| Maschera | PNG facoltativo, con le dimensioni della prima immagine; i pixel trasparenti indicano dove ridipingere |
| Sfondo | auto, opaque, transparent; la trasparenza richiede PNG o WebP |
| Formati dei file | PNG (predefinito), JPEG, WebP; GIF (solo da testo a immagine) |
Caratteristiche principali
Giro sul balcone
Il loop di Sunburst segue il giro dal panorama urbano a un sorriso verso la fotocamera sul balcone notturno. La sequenza di azioni definita aiuta Sunburst a pianificare il loop con precisione.
Brindisi al jazz club
L’animazione di Sunburst unisce il brindisi, un occhiolino giocoso e un sorriso al bar del jazz club. La sequenza di azioni definita aiuta Sunburst a pianificare il loop con precisione.
Revisione del cappotto a Parigi
La modifica con Sunburst specifica prima il soggetto da conservare, poi richiede un cappotto e un’ambientazione piovosa.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Fornisci la descrizione obbligatoria della scena per Sunburst, entro 5.000 caratteri; non è previsto testo predefinito e i token del prompt vengono addebitati, quindi i prompt S… almeno 1 caratteri · al massimo 5000 caratteri |
aspect_ratio | No | Sunburst usa 1:1 per impostazione predefinita nelle immagini statiche e offre 15 proporzioni da 1:3 a 3:1; per i GIF devi indicare |
resolution | No | Sunburst: per le immagini statiche scegli 1k, 2k o 4k; nei GIF resolution indica la dimensione di un fotogramma: 512 (circa 0,26 MP) ammette fino a 16 fotogrammi e 768 (circa 0,… |
quality | No | Imposta il dettaglio di Sunburst su low, medium (predefinito), high, xhigh o max; i livelli superiori aumentano dettaglio, tempo di rendering e prezzo. |
reasoning_effort | No | Sunburst: |
num_outputs | No | Richiedi a Sunburst 1–10 immagini per richiesta; qui non è specificato un numero predefinito e ogni immagine in output viene addebitata. |
background | No | Sunburst accetta auto, opaque e transparent; la trasparenza richiede PNG o WebP ed è incompatibile con GIF. |
output_format | No | Sunburst restituisce png per impostazione predefinita e supporta anche jpeg, webp e gif; i GIF animati sono disponibili solo da testo a immagine e non ammettono uno sfondo trasp… |
frame_count | No | Sunburst: |
frame_duration_ms | No | Sunburst: |
output_quality | No | Imposta la compressione JPEG o WebP di Sunburst da 0 a 100: valori alti conservano più dettagli in un file più pesante, PNG e GIF la ignorano e il prezzo di Sunburst non cambia. |
Prezzi
Sunburst addebita i token effettivamente usati da ogni richiesta: il testo del prompt e i token immagine del risultato finale. Il prezzo indicato per un livello di qualità e risoluzione si riferisce a un’immagine quadrata di Sunburst, quindi le altre proporzioni costano in genere meno. Richiedere più immagini Sunburst somma i token di ciascuna, e i token del prompt vengono conteggiati di nuovo per ogni immagine. Sunburst riserva l’importo massimo all’avvio di un processo e restituisce la parte inutilizzata al termine. Le richieste rifiutate da Sunburst non vengono addebitate. I GIF di Sunburst seguono lo stesso criterio: i fotogrammi condividono i fogli, quindi più fotogrammi richiedono in genere più token immagine.
| Risoluzione | Qualità: low | Qualità: medium | Qualità: high | Qualità: xhigh | Qualità: max |
|---|---|---|---|---|---|
| $0.02232 / immagine | $0.03915 / immagine | $0.04743 / immagine | $0.08433 / immagine | $0.18972 / immagine |
| $0.027 / immagine | $0.04752 / immagine | $0.05742 / immagine | $0.10206 / immagine | $0.22941 / immagine |
| $0.04131 / immagine | $0.07299 / immagine | $0.08847 / immagine | $0.15723 / immagine | $0.35379 / immagine |
| $0.04392 / immagine | $0.07776 / immagine | $0.09432 / immagine | $0.1674 / immagine | $0.37638 / immagine |
| $0.07479 / immagine | $0.13221 / immagine | $0.16011 / immagine | $0.28512 / immagine | $0.64044 / immagine |
Casi d’uso
Immagini per campagne turistiche
Crea un manifesto sul mare con una destinazione specifica, un titolo breve e una palette controllata.
Immagini per menu di caffetterie
Descrivi l’impaginazione di una lavagna con voci del menu tra virgolette e un’ambientazione mattutina ben definita.
Revisioni di ritratti
Sposta un ritratto fornito in una strada sotto la pioggia, chiedendo di mantenere la continuità con la sorgente.
Consigli avanzati
Definisci il brief visivo
Descrivi il soggetto, i materiali e la luce, poi metti tra virgolette le brevi scritte da inserire.
Scegli dettaglio e dimensioni
Parti dalla qualità medium e seleziona 1k, 2k o 4k in base alla destinazione dell’immagine.
Definisci la revisione
Per una modifica, inserisci prima la sorgente e descrivi cosa conservare prima di indicare cosa sostituire.
Seleziona un’area precisa
Se la modifica riguarda una zona specifica, fornisci una maschera PNG con le dimensioni della prima immagine.
Introduzione
Con Sunburst, descrivi con precisione la scena e la sequenza dei movimenti prima di generare.
Funzioni
- Sunburst offre 1k, 2k e 4k per immagini statiche, con cinque livelli di qualità.
- GIF in loop con Sunburst: descrivi movimento e ripetizione, scegli
output_format: gif e indicaaspect_ratio. - Sunburst: per le immagini statiche scegli 1k, 2k o 4k; nei GIF resolution indica la dimensione di un fotogramma: 512 (circa 0,26 MP) ammette fino a 16 fotogrammi e 768 (circa 0,59 MP) fino a 12.
- Sunburst:
frame_countaccetta da 2 a 16 fotogrammi, con 9 come valore predefinito; il limite dipende dalla dimensione del fotogramma scelta. - Sunburst:
frame_duration_msimposta da 20 a 2000 ms per fotogramma, con 200 ms come valore predefinito. - In Sunburst, i GIF sono fatturati per fogli da 8 fotogrammi in base al livello di qualità: 9 fotogrammi richiedono 2 fogli.
- Sunburst restituisce png per impostazione predefinita e supporta anche jpeg, webp e gif; i GIF animati sono disponibili solo da testo a immagine e non ammettono uno sfondo trasparente.
Consigli
- Per Sunburst, adatta
reasoning_effortalla composizione: high è il valore predefinito e aiuta con testi densi; una pianificazione maggiore richiede più tempo, senza cambiare il costo.
Avvio rapido dell’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "openai/gpt-image-2.6-sunburst/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "medium",
"background": "auto",
"resolution": "1k",
"num_outputs": 1,
"aspect_ratio": "1:1"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
