# ChatGPT Images 2.6 API Riferimento completo dell’API per i modelli ChatGPT Images 2.6 Flare e Sunburst. ## Varianti dei modelli Questa API supporta quattro varianti di modelli: | Modello | ID | Descrizione | |-------|-----|-------------| | **ChatGPT Images 2.6 Flare** | `gpt-image-2.6-flare` | Generazione di immagini da testo con controlli di risoluzione e qualità | | **ChatGPT Images 2.6 Flare Edit** | `gpt-image-2.6-flare-edit` | Modifica delle immagini e composizione di più immagini | | **ChatGPT Images 2.6 Sunburst** | `gpt-image-2.6-sunburst` | Generazione di immagini da testo con controlli di risoluzione e qualità | | **ChatGPT Images 2.6 Sunburst Edit** | `gpt-image-2.6-sunburst-edit` | Modifica delle immagini e composizione di più immagini | ## Confronto rapido Flare e Sunburst condividono le seguenti opzioni di richiesta. | Funzionalità | Flare / Sunburst | Flare Edit / Sunburst Edit | |---------|-----------------|---------------------------| | Input | Prompt testuale | Immagine/i + prompt testuale | | Opzioni di risoluzione | `1k`, `2k`, `4k` | `1k`, `2k`, `4k` | | Opzioni di qualità | `low`, `medium`, `high`, `xhigh`, `max` | `low`, `medium`, `high`, `xhigh`, `max` | | Qualità predefinita | `medium` | `medium` | | Proporzioni | 10 opzioni | 10 opzioni | | Immagini in input | No | Obbligatorie (1–16 immagini) | | Formati di output | `png`, `jpeg`, `webp`, `gif`, `svg` | `png`, `jpeg`, `webp` | | Formato di output predefinito | `png` | `png` | ### Proporzioni supportate `16:9`, `9:16`, `1:1`, `3:2`, `2:3`, `3:4`, `4:3`, `5:4`, `4:5`, `21:9` ## ChatGPT Images 2.6 Flare (Da testo a immagine) ### Punto di accesso ``` POST /api/v1/image/task ``` ### Autenticazione ``` Authorization: Bearer YOUR_API_KEY ``` ### Parametri della richiesta #### Obbligatori | Parametro | Tipo | Descrizione | |-----------|------|-------------| | `model_name` | string | Deve essere `"gpt-image-2.6-flare"` | | `prompt` | string | Prompt per la generazione dell’immagine | | `width` | integer | Valore della larghezza nel rapporto, ad esempio `16` per `16:9`; non è una dimensione in pixel | | `height` | integer | Valore dell’altezza nel rapporto, ad esempio `9` per `16:9`; non è una dimensione in pixel | | `resolution` | string | `"1k"`, `"2k"` o `"4k"` | Il rapporto width:height deve corrispondere a una delle proporzioni supportate elencate sopra. #### Facoltativi | Parametro | Tipo | Valore predefinito | Descrizione | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"` o `"max"` | | `output_format` | string | `"png"` | Formato di output: `"png"`, `"jpeg"`, `"webp"`, `"gif"` o `"svg"`. Usa `"gif"` per le animazioni GIF o `"svg"` per l’output vettoriale SVG | | `frame_count` | integer | `9` | Numero di fotogrammi GIF, da `2` a `16`. Si applica solo quando `output_format` è `"gif"` | | `frame_duration_ms` | integer | `200` | Durata dei fotogrammi GIF in millisecondi, da `20` a `2000`. Si applica solo quando `output_format` è `"gif"` | ### Esempio di richiesta ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-flare', prompt: 'A looping animation of steam rising from a ceramic mug on a pale stone table, warm studio lighting', width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'gif', frame_count: 9, frame_duration_ms: 200 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## ChatGPT Images 2.6 Flare Edit (Modifica delle immagini) ### Punto di accesso ``` POST /api/v1/image/task ``` ### Parametri della richiesta #### Obbligatori | Parametro | Tipo | Descrizione | |-----------|------|-------------| | `model_name` | string | Deve essere `"gpt-image-2.6-flare-edit"` | | `prompt` | string | Descrizione delle modifiche desiderate | | `image_url_list` | string[] | URL delle immagini di input; almeno 1 e al massimo 16 immagini, ciascuna inferiore a 50 MB | | `width` | integer | Valore della larghezza nel rapporto, ad esempio `16` per `16:9`; non è una dimensione in pixel | | `height` | integer | Valore dell’altezza nel rapporto, ad esempio `9` per `16:9`; non è una dimensione in pixel | | `resolution` | string | `"1k"`, `"2k"` o `"4k"` | Il rapporto width:height deve corrispondere a una delle proporzioni supportate elencate sopra. #### Facoltativi | Parametro | Tipo | Valore predefinito | Descrizione | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"` o `"max"` | | `output_format` | string | `"png"` | Formato di output: `"png"`, `"jpeg"` o `"webp"` | ### Esempio di richiesta ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-flare-edit', prompt: 'Replace the background with a warm studio setting while keeping the product unchanged', image_url_list: ['https://example.com/product-photo.jpg'], width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'png' }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## ChatGPT Images 2.6 Sunburst (Da testo a immagine) ### Punto di accesso ``` POST /api/v1/image/task ``` ### Parametri della richiesta #### Obbligatori | Parametro | Tipo | Descrizione | |-----------|------|-------------| | `model_name` | string | Deve essere `"gpt-image-2.6-sunburst"` | | `prompt` | string | Prompt per la generazione dell’immagine | | `width` | integer | Valore della larghezza nel rapporto, ad esempio `16` per `16:9`; non è una dimensione in pixel | | `height` | integer | Valore dell’altezza nel rapporto, ad esempio `9` per `16:9`; non è una dimensione in pixel | | `resolution` | string | `"1k"`, `"2k"` o `"4k"` | Il rapporto width:height deve corrispondere a una delle proporzioni supportate elencate sopra. #### Facoltativi | Parametro | Tipo | Valore predefinito | Descrizione | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"` o `"max"` | | `output_format` | string | `"png"` | Formato di output: `"png"`, `"jpeg"`, `"webp"`, `"gif"` o `"svg"`. Usa `"gif"` per le animazioni GIF o `"svg"` per l’output vettoriale SVG | | `frame_count` | integer | `9` | Numero di fotogrammi GIF, da `2` a `16`. Si applica solo quando `output_format` è `"gif"` | | `frame_duration_ms` | integer | `200` | Durata dei fotogrammi GIF in millisecondi, da `20` a `2000`. Si applica solo quando `output_format` è `"gif"` | ### Esempio di richiesta ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-sunburst', prompt: 'A looping animation of steam rising from a ceramic mug on a pale stone table, warm studio lighting', width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'gif', frame_count: 9, frame_duration_ms: 200 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## ChatGPT Images 2.6 Sunburst Edit (Modifica delle immagini) ### Punto di accesso ``` POST /api/v1/image/task ``` ### Parametri della richiesta #### Obbligatori | Parametro | Tipo | Descrizione | |-----------|------|-------------| | `model_name` | string | Deve essere `"gpt-image-2.6-sunburst-edit"` | | `prompt` | string | Descrizione delle modifiche desiderate | | `image_url_list` | string[] | URL delle immagini di input; almeno 1 e al massimo 16 immagini, ciascuna inferiore a 50 MB | | `width` | integer | Valore della larghezza nel rapporto, ad esempio `16` per `16:9`; non è una dimensione in pixel | | `height` | integer | Valore dell’altezza nel rapporto, ad esempio `9` per `16:9`; non è una dimensione in pixel | | `resolution` | string | `"1k"`, `"2k"` o `"4k"` | Il rapporto width:height deve corrispondere a una delle proporzioni supportate elencate sopra. #### Facoltativi | Parametro | Tipo | Valore predefinito | Descrizione | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"` o `"max"` | | `output_format` | string | `"png"` | Formato di output: `"png"`, `"jpeg"` o `"webp"` | ### Esempio di richiesta ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-sunburst-edit', prompt: 'Replace the background with a warm studio setting while keeping the product unchanged', image_url_list: ['https://example.com/product-photo.jpg'], width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'png' }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Formato della risposta ### Risposta iniziale Tutte e quattro le varianti di ChatGPT Images 2.6 restituiscono un `task_id` per il polling: ```json { "code": 0, "data": { "task_id": "{task_id}", "task_status": "submitted", "response_url": "https://api.flaq.ai/api/v1/image/{task_id}" }, "message": "success" } ``` ### Risposta al polling Esegui il polling di `GET /api/v1/image/{task_id}` per verificare lo stato: ```json { "code": 0, "data": { "task_id": "{task_id}", "task_status": "succeed", "task_status_msg": null, "response_url": "https://api.flaq.ai/api/v1/image/{task_id}", "task_result": { "credit": 0.0997, "images": [ { "url": "https://example.com/generated-image.jpeg" } ] } }, "message": "success" } ``` ### Valori di stato - `submitted`: Attività accettata - `processing`: Generazione o modifica dell’immagine in corso - `succeed`: Attività completata correttamente - `failed`: Attività non riuscita ## Tempo di elaborazione Il tempo di elaborazione varia in base al modello, alle impostazioni di output, alla complessità del prompt e al numero di immagini di riferimento. Esegui il polling finché lo stato dell’attività non è `succeed` o `failed`; un’attività inviata o in elaborazione potrebbe non contenere ancora immagini risultanti. ## Buone pratiche 1. **Descrivi chiaramente la composizione**: ChatGPT Images 2.6 offre i risultati migliori quando i prompt descrivono chiaramente soggetto, inquadratura, illuminazione e stile desiderato. 2. **Adatta le proporzioni alla destinazione finale**: Imposta in anticipo le proporzioni per post sui social, banner, pagine prodotto o layout editoriali. 3. **Usa immagini di partenza nitide per le modifiche**: Immagini nitide e ben illuminate migliorano la conservazione dell’identità e la qualità delle modifiche locali. 4. **Limita le richieste con più immagini ai riferimenti più utili**: Per le richieste di modifica, fornisci solo le immagini rilevanti per evitare indicazioni visive contrastanti.