OpenAI · API media

GPT-Image 2.5 API

GPT-Image 2.5 è il modello immagine più recente di OpenAI su OmniaKey: generazione da testo e modifiche con Base64 inline, restituendo esattamente la dimensione richiesta.

Ottieni la tua chiave API Leggi i documenti

ID modello: gpt-image-2.5
Fornitore: OpenAI
Modalità: Immagine AI
Per chiamata riuscita: $0,10
Ultimo verificato: 2026-09-11

Quando usarlo

Usa GPT-Image 2.5 per generazioni più fedeli e modifiche con riferimento in cui conta rispettare la dimensione di output richiesta; scegli GPT-Image 2 quando la priorità è il prezzo per chiamata più basso.

Cosa fa

Testo in immagine

Trasforma un prompt testuale in una nuova immagine.

Modifica immagine

Modifica un'immagine esistente da un prompt e un riferimento.

Come chiamarlo

I modelli media funzionano in modo asincrono: crea un'attività, interrogala fino al termine, poi scarica l'URL firmato dell'asset.

Crea, interroga, scarica

# 1. Create the job. 202 Accepted; the body carries the task id,
#    the pre-charged price, and a poll_url. Reuse one Idempotency-Key
#    across retries so a timeout never starts a second paid job.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: gpt-image-2.5-001" \
  -d '{
    "model": "gpt-image-2.5",
    "type": "image",
    "operation": "generate",
    "input": {"prompt": "a paper boat on a quiet lake at sunset"},
    "parameters": {"size": "1024x1024", "quality": "medium"}
  }'

# 2. Poll GET /v1/media/tasks/{id} until status is
#    succeeded | failed | canceled. Progress carries percent and stage.
curl --fail-with-body https://api.omniakey.com/v1/media/tasks/TASK_ID \
  -H "Authorization: Bearer $OMNIAKEY_API_KEY"

# 3. Download assets[0].url before expires_at, or poll again for a
#    fresh signed URL. Failed and canceled jobs are refunded.
curl -sS -o out.png "$(jq -r '.assets[0].url' result.json)"

Prezzo

I lavori immagine sono fatturati per chiamata riuscita, non per token. I lavori falliti o annullati vengono rimborsati automaticamente.

Per chiamata riuscita

$0,10per chiamata

Altri modelli immagine OpenAI

GPT-Image 2

gpt-image-2

Domande frequenti

Come chiamo GPT-Image 2.5 su OmniaKey?

Invia una POST a /v1/media/tasks con l'id del modello, type "image" e operation "generate" o "edit". Riutilizza la stessa Idempotency-Key nei tentativi, così un timeout non avvia un secondo lavoro a pagamento.

Quanto costa GPT-Image 2.5?

GPT-Image 2.5 viene fatturato $0,10 per chiamata. Alla creazione l'importo viene pre-addebitato dal saldo prepagato e i lavori falliti o annullati vengono rimborsati automaticamente.

Perché l'API restituisce un id attività invece dell'immagine?

La latenza dei fornitori va da pochi secondi a circa un minuto, quindi OmniaKey normalizza tutte le rotte immagine in un unico flusso asincrono. Interroga GET /v1/media/tasks/{id} finché lo stato è succeeded, poi leggi l'URL firmato dell'asset.