Vai al contenuto principale

Filtrato — Questo modello rifiuta apertamente le richieste oltre i suoi limiti. È un dato misurato, non presunto: i modelli che non abbiamo misurato non portano alcuna etichetta.Vedi tutti i modelli con questo livello di filtraggio
openai/gpt-image-2.5-sunburst/edit

La modifica immagini GPT Image 2.5 Sunburst di OpenAI accetta da 1 a 16 immagini di partenza e una descrizione testuale della modifica. Una maschera PNG facoltativa limita il ritocco a un’area e gli sfondi possono essere trasparenti; output da 1K a 4K.

Da $0.0018/immagine20% sotto il prezzo di listino del produttore del modello
Esegui il modello

Playground

Invia una richiesta

Guida rapida

Gli esempi usano le definizioni pubbliche dei parametri dell’endpoint selezionato. Sostituisci la chiave API e i media di esempio, poi invia la richiesta dal tuo server.

SDK e integrazioni
POSThttps://api.spicyapi.ai/api/v1/jobs/createTask

Autenticazione dell’API

Tieni la chiave API nella variabile d’ambiente del server SPICY_API_KEY. Per le richieste JSON usa l’autenticazione Bearer e Content-Type: application/json.

Authorization: Bearer $SPICY_API_KEY
GPT Image 2.5 Sunburst · Image Editing · Risultato di esempio
Risultato di esempioUsa questo esempio
# 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.5-sunburst/edit",
  "input": {
    "aspect_ratio": "1:1",
    "background": "auto",
    "image_urls": [
      "https://example.com/reference.png"
    ],
    "input_fidelity": "low",
    "num_outputs": 1,
    "output_format": "png",
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
  }
}'

# 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"

Generato dallo schema di input di questo modello, lo stesso su cui l’API valida ogni richiesta.

Parametri di input

Metti questi campi dentro l’oggetto input del corpo della richiesta. Nomi e tipi corrispondono all’API. Quando un valore predefinito non è indicato, non darlo per scontato.

image_urlsarray<string>ObbligatorioIncide sul prezzo

Da 1 a 16 immagini sorgente. Richiamale nel prompt in base all’ordine (la prima immagine, la seconda immagine). Ogni sorgente aggiunge un costo fisso di input a ogni immagine prodotta.

Predefinito
Non specificato
Vincoli
minItems:1
maxItems:16
promptstringObbligatorio

Fino a 5.000 caratteri. Metti tra virgolette doppie ogni parola che deve comparire nell’immagine e indica dove va; il resto viene letto come descrizione. I primi 100 token di input del prompt sono inclusi nel prezzo dell’immagine; i prompt più lunghi aggiungono un piccolo costo per ogni token in più, visibile nel preventivo. Il testo in cinese, giapponese o coreano conta circa un token per carattere, il resto circa un token ogni quattro caratteri.

Predefinito
Non specificato
Vincoli
minLength:1
maxLength:5000
official_fallbackbooleanFacoltativo

Attivo per impostazione predefinita. Una richiesta per una sola modifica PNG in qualità high e dimensione 1k, nel formato 1:1, 3:2, 2:3, 4:3, 3:4, 16:9 o 9:16, senza maschera, con input fidelity low e background auto passa prima dal percorso economico. Se quel percorso non riesce a completarla, per esempio perché rifiuta il prompt, la richiesta viene rieseguita sul percorso ufficiale e addebitata al prezzo ufficiale invece che a quello economico. Tutte le altre richieste passano dal percorso ufficiale fin dall’inizio. Disattivalo per pagare solo il prezzo economico: le richieste che il percorso economico non può servire vengono rifiutate, e quelle che accetta possono comunque essere rifiutate o fallire.

Predefinito
true
output_qualityintegerFacoltativo

Qualità di compressione per jpeg e webp, da 0 a 100: valori alti conservano più dettaglio e producono file più pesanti. Non si usa con png e non cambia il prezzo.

Predefinito
Non specificato
Vincoli
minimum:0
maximum:100
output_formatstringFacoltativo

png (predefinito), jpeg o webp. Non cambia il prezzo.

Predefinito
"png"
Valori ammessi
"png""jpeg""webp"
backgroundstringFacoltativo

auto (predefinito), transparent o opaque. Transparent richiede output png o webp e restituisce un vero canale alfa.

Predefinito
"auto"
Valori ammessi
"auto""transparent""opaque"
input_fidelitystringFacoltativo

low (predefinito) o high. High mantiene più fedelmente volti, tessuti e dettagli stampati delle sorgenti. Non cambia il prezzo.

Predefinito
"low"
Valori ammessi
"low""high"
num_outputsintegerFacoltativoIncide sul prezzo

Da 1 a 10 immagini per richiesta, 1 per impostazione predefinita. Ogni immagine è fatturata separatamente.

Predefinito
1
Vincoli
minimum:1
maximum:10
qualitystringFacoltativoIncide sul prezzo

low, medium, high (predefinito), xhigh o max. Ogni livello aggiunge dettaglio, tempo e costo; tieni xhigh e max per le versioni finali.

Predefinito
"high"
Valori ammessi
"low""medium""high""xhigh""max"
resolutionstringFacoltativoIncide sul prezzo

1k (predefinito), 2k o 4k. Un’immagine quadrata misura 1024, 2048 o 2880 pixel di lato; un livello più alto costa di più per immagine. Sul percorso economico un’immagine 1k può uscire un po’ più grande.

Predefinito
"1k"
Valori ammessi
"1k""2k""4k"
aspect_ratiostringFacoltativoIncide sul prezzo

Quindici formati da 1:3 a 3:1, 1:1 per impostazione predefinita. Il risultato prende il formato che scegli, non quello della sorgente, e il formato cambia il prezzo.

Predefinito
"1:1"
Valori ammessi
"1:1""1:2""1:3""2:1""2:3""3:1""3:2""3:4""4:3""4:5""5:4""9:16""9:21""16:9""21:9"
mask_urlstringFacoltativo

PNG facoltativo della stessa dimensione della prima immagine sorgente. I pixel trasparenti indicano la zona da ridipingere; quelli opachi restano. Senza maschera il modello decide dal prompt cosa cambiare.

Predefinito
Non specificato
Vincoli
format:"uri"
contentMediaType:["image/jpeg","image/png","image/webp","image/gif"]

Segui l’attività

HTTP 202 significa che l’attività è stata accettata, non che sia finita. Salva il taskId restituito e interroga quell’attività. Non crearne un’altra mentre aspetti il risultato.

Risposta di accettazione
HTTP/1.1 202 Accepted
Location: /api/v1/jobs/recordInfo?taskId=job_01k3m8x9q2z4v7n5p6r8s0t1w3

{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_create",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "state": "queued",
    "estimatedCost": "0.750000"
  }
}

La risposta di accettazione include la stima, così la tua applicazione può mostrare lo stesso importo nella cronologia delle attività e nella fatturazione.

Leggi l’attività
curl --get "https://api.spicyapi.ai/api/v1/jobs/recordInfo" \
  --data-urlencode "taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Comincia a interrogare ogni 2 secondi circa e allunga l’intervallo man mano. Fermati a uno stato terminale. Dopo una caduta di connessione, interroga il taskId originale. Ripeti la creazione solo con la chiave di idempotenza e il corpo originali.

Oppure lascia che sia la callback a trovarti
import { verifyWebhook } from "@spicyapi/sdk";

// express.raw keeps the bytes we signed; express.json never matches.
app.post("/hooks/spicy", express.raw({ type: "application/json" }), (req, res) => {
  const { payload } = verifyWebhook({
    rawBody: req.body,
    timestamp: req.header("X-Webhook-Timestamp"),
    signature: req.header("X-Webhook-Signature"),
    payloadVersion: Number(req.header("X-Webhook-Payload-Version")),
    secret: process.env.SPICY_WEBHOOK_SECRET,
  });
  res.status(200).end();
  void handleFinishedTask(payload);
});

Passa callBackUrl quando crei l’attività e il record finito ti arriva via POST: nessun ciclo di polling. Ogni consegna porta X-Webhook-Timestamp, X-Webhook-Signature e X-Webhook-Payload-Version. La firma è un HMAC-SHA256 in base64 su taskId.timestamp.sha256(body), quindi va verificata sui byte grezzi: se analizzi il JSON e lo riserializzi i byte cambiano e la verifica fallisce. Le consegne fallite vengono ritentate, quindi lo stesso taskId può arrivare due volte: rendi idempotente il gestore. Rispondi prima con un 2xx e fai il lavoro dopo; un gestore lento viene trattato come una consegna fallita.

Leggi il risultato

Usa l’output solo quando lo stato è succeeded. In caso di fallimento, indaga con errorCode, errorMessage e request_id. Costi e stati degli esempi non rappresentano un addebito reale.

Esempio di risposta completata
{
  "code": 200,
  "msg": "success",
  "request_id": "req_example_record",
  "data": {
    "taskId": "job_01k3m8x9q2z4v7n5p6r8s0t1w3",
    "model": "openai/gpt-image-2.5-sunburst/edit",
    "state": "succeeded",
    "output": {
      "assets": [
        {
          "key": "tasks/2026/08/28/job_01k3m8x9q2z4v7n5p6r8s0t1w3/3f7a1c9e5b2d48f0a6c1e3d5b7f9a1c3.png",
          "mime": "image/png",
          "url": "https://example.r2.cloudflarestorage.com/results/job_01k3m8x9q2z4v7n5p6r8s0t1w3/result.png?X-Amz-Signature=SIGNATURE_FROM_RESPONSE",
          "expiresAt": "2026-08-28T12:20:08.000Z"
        }
      ]
    },
    "cost": "0.750000",
    "settled": true,
    "createdAt": "2026-08-28T12:00:00Z",
    "completedAt": "2026-08-28T12:00:30Z"
  }
}

Per ogni asset disponibile, apri o scarica assets[].url direttamente, senza l’header Authorization dell’API. L’URL firmato scade a expiresAt; interroga di nuovo l’attività per rinnovarlo finché l’asset resta entro il periodo di conservazione. Un asset in attesa o non disponibile non ha URL. Tratta gli URL firmati come privati.

SDK e integrazioni

Usa SpicyAPI nella tua app, nel terminale, con un assistente IA o in un workflow visivo. Scegli una guida di configurazione.

SDKs
TypeScript · Python · Go · PHP · Java
CLI
Comandi da terminale e script di automazione.
MCP
Claude Code · Cursor · Codex
Agent Skill
Istruzioni riutilizzabili per il tuo assistente IA.
n8n
Nodi della community per installazioni self-hosted e template HTTP Request importabili per n8n Cloud.
ComfyUI
Workflow di immagini, video e audio su una tela a nodi.

Altre integrazioni

SillyTavernTelegram / DiscordApp proxyOpenAI SDKLangChainVercel AI SDK
Esplora i workflow pronti all’uso

Usalo in ComfyUI

Installa i nodi SpicyAPI da ComfyUI Manager o con il comando qui sotto, poi cerca GPT Image 2.5 Sunburst · Image Editing sulla tela. Il nodo ha le stesse opzioni di questa pagina e mostra il prezzo prima dell’esecuzione.

cd ComfyUI/custom_nodes
git clone https://github.com/spicyapi-ai/comfyui-spicyapi
Esempi di workflowGuida all’installazioneCodice sorgente su GitHub