GPT Image 2.6

GPT Image 2.6 accetta prompt testuali e immagini di riferimento facoltative. Invia una volta a POST /v1/images/generations, conserva l’ID attività e interroga GET /v1/tasks/{id} per il risultato. I file finiti vengono restituiti come URL.

ID modello e prezzi

Usa GET /v1/models per scoprire i modelli disponibili per la tua chiave. Gli ID Sunburst configurati sono gpt-image-2.6-sunburst-official e gpt-image-2.6-sunburst. Gli ID Flare, quando elencati, usano lo stesso contratto dei parametri. L’ID modello senza suffisso usa il proprio gruppo Default; i gruppi aggiuntivi usano l’ID model:group indicato dalla ricerca dei modelli.

Consulta prezzi attuali e Playground. I modelli fatturati a token vengono saldati in base all’utilizzo effettivo; quelli per immagine usano il prezzo configurato per immagine. Le risposte SVG riportano separatamente i token del modello che ne scrive il codice in svg_usage, fatturati al prezzo SeedRouter di quel modello.

Generare un’immagine

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-sunburst-official",
    "prompt": "A red paper crane on a pale blue table, soft daylight",
    "size": "1024x1024",
    "quality": "low",
    "complexity": "high"
  }'

La risposta contiene un id. Interroga quell’ID invece di inviare di nuovo la generazione:

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Al completamento, output.data contiene oggetti con un url. Scarica l’URL per conservare il formato originale e, per le GIF, ogni fotogramma dell’animazione. Un’attività fallita contiene un error e non viene addebitata. Vedi stati delle attività e polling.

Parametri

Ci sono 18 campi di primo livello. Solo model e prompt sono obbligatori. I campi facoltativi accettano null, equivalente all’omissione. I campi sconosciuti vengono scartati. Valori supportati ma non validi non superano la convalida prima della generazione dell’immagine.

Gli URL di riferimento devono usare HTTP o HTTPS e non devono contenere credenziali. ID di file, base64 incorporato e caricamenti multipart non sono accettati; carica prima i file e fornisci i loro URL pubblici. Le richieste usano il polling di attività asincrone anziché stream o partial_images. input_fidelity, response_format e prompt_rewriter non sono esposti da questo contratto.

Dimensioni dell’immagine

Per la generazione di immagini di riferimento PNG, JPEG e SVG, ogni dimensione deve essere divisibile per 16 e non superare 3840 pixel. Il totale dei pixel deve essere 655.360–8.294.400 e il rapporto d’aspetto tra 1:3 e 3:1. Esempi: 1024x1024, 1536x1024, 2160x3840, 2880x2880.

Le dimensioni GIF devono essere multipli positivi di 16, oppure usa auto. GIF ha un budget totale di pixel separato, condiviso tra numero di fotogrammi, dimensioni dei fotogrammi e n; OpenAI non ne ha pubblicato il limite numerico. Una GIF 512x512 non usa la regola del minimo di pixel delle immagini statiche.

GIF animata

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A red paper crane flapping its wings in a seamless loop on pale blue",
  "output_format": "gif",
  "size": "512x512",
  "quality": "low",
  "frame_count": 4,
  "frame_duration_ms": 200
}

Le GIF possono essere generate da un prompt o richieste da immagini di riferimento. Non combinarle con una maschera o compressione. La disponibilità dell’anteprima può dipendere dall’accesso al modello selezionato.

Discrepanza nella documentazione, verificata il 5 novembre 2026: la guida alla generazione di immagini di OpenAI indica 2–64 fotogrammi e 20–2000 ms e afferma che l’endpoint di modifica non restituisce GIF. Il riferimento dell’API Images indica 2–16 fotogrammi, nessun limite massimo di durata e include l’output GIF nelle modifiche. Le richieste a monte del 5 novembre 2026 corrispondevano al riferimento: 17 fotogrammi sono stati rifiutati e un fotogramma da 3.000 ms è stato accettato. Questa API segue il riferimento.

SVG

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A simple geometric red paper-crane logo, clean editable vector paths",
  "output_format": "svg",
  "n": 1
}

SVG è disponibile solo in generazione e richiede n: 1. Non inviare immagini, maschera, annotazioni o compressione. Il file è XML UTF-8 statico contenente forme vettoriali; script, risorse esterne e immagini raster incorporate non sono supportati.

Quando è disponibile la scelta del modello di scrittura, aggiungi svg: {"model":"YOUR_AUTHOR_MODEL_ID"}. Un oggetto svg fornito esplicitamente richiede un model non vuoto. Puoi anche impostare svg.reasoning.effort su none, minimal, low, medium, high, xhigh o max; il modello di scrittura selezionato determina quali valori supporta. Ometti reasoning per usare il valore predefinito. OpenAI non pubblica un elenco di modelli di scrittura consentiti né un valore predefinito universale. Se la scelta non è disponibile, ometti l’intero oggetto svg.

Il risultato completato può includere svg_usage con model, input_tokens, output_tokens, reasoning_tokens e total_tokens. È separato dall’usage dell’immagine e non è un conteggio aggiuntivo di token immagine.

Immagini di riferimento, maschera e annotazioni

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "Replace the marked background with a pale blue studio backdrop",
  "images": [{"image_url":"https://example.com/reference.png"}],
  "markup": {"image_url":"https://example.com/transparent-markup.png"},
  "output_format": "png",
  "complexity": "low"
}

Le immagini di riferimento supportano PNG, JPEG e WebP, al massimo 50 MB ciascuna. Maschera e annotazioni devono essere PNG e corrispondere alle dimensioni della prima immagine di riferimento dopo l’orientamento. Le annotazioni devono contenere pixel trasparenti; sia le annotazioni sia la prima immagine di riferimento possono contenere al massimo 16.777.216 pixel e le annotazioni possono pesare al massimo 50 MB. Maschera e annotazioni si escludono a vicenda.

Campi di risposta

L’output immagine completato contiene created, data: [{url}] e, quando riportati, size, quality, background, output_format, usage, svg_usage e safety_identifier. usage può distinguere token testuali e immagine di input e output e input in cache. Nell’output pubblico non sono inclusi byte di immagine in base64 né campi di costo.

Schema OpenAPI · Riferimento di generazione OpenAI · Riferimento di modifica OpenAI · Guida alle immagini OpenAI