GPT Image 1.5

ID:openai/gpt-image-1.5

API di generazione immagini GPT Image 1.5 di OpenAI — 4 volte più veloce della v1 con rendering testo superiore, 3 aspect ratio e modalità di qualità medium/high.

Text to imageEditing immaginiImmagini di riferimentoRendering testo

Panoramica

API di generazione immagini GPT Image 1.5 di OpenAI — 4 volte più veloce della v1 con rendering testo superiore, 3 aspect ratio e modalità di qualità medium/high.

Autenticazione

Tutte le richieste API richiedono una chiave API valida passata tramite l'header Authorization con lo schema Bearer.

Avvio rapido

Credenziali

Imposta la variabile d'ambiente RUNBASE_API_KEY.

Shell

export RUNBASE_API_KEY=your-api-key

Crea un'esecuzione

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-1.5",
    "input": {
      "prompt": "A cinematic product photo of a ceramic lamp"
    }
  }'

Esecuzioni

Le esecuzioni vengono elaborate in modo asincrono. Invia una richiesta, poi interroga per il risultato.

Crea un'esecuzione

Shell

curl -s https://runbase.net/api/v1/runs \
  -H "Authorization: Bearer $RUNBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-image-1.5",
    "input": { "prompt": "A cinematic product photo of a ceramic lamp" }
  }'

Stato dell'esecuzione

Shell

curl -s https://runbase.net/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer $RUNBASE_API_KEY"

Ottieni risultato

Interroga l'endpoint di stato finche status non e "succeeded", poi leggi output.urls dalla risposta.

Schema input

Parametro	Tipo	Obbligatorio	Descrizione
prompt	string	Obbligatorio	Prompt
aspect_ratio	string	Facoltativo	Aspect ratioOpzioni: `1:13:22:3`
quality	string	Facoltativo	QualityOpzioni: `mediumhigh`
image_urls	string[]	Facoltativo	Reference images

Schema output

Campo	Tipo	Descrizione
urls	string[]	URL degli output generati

Errori

L'API utilizza codici di stato HTTP standard per indicare successo o errore.

Codice di stato	Descrizione
400	Richiesta non valida - parametri mancanti o malformati
401	Autenticazione fallita - chiave API mancante o non valida
402	Crediti insufficienti
403	Accesso negato - IP non consentito o limite di spesa della chiave API superato
404	Esecuzione non trovata
429	Limite di frequenza superato
500	Errore interno del server