GPT Image 2

ID:openai/gpt-image-2

API di generazione immagini GPT Image 2 di OpenAI - fino a 4K con ragionamento nativo, rendering testo multilingue ed editing guidato da riferimenti.

Text to imageEditing immaginiImmagini di riferimentoUso commerciale

Panoramica

API di generazione immagini GPT Image 2 di OpenAI - fino a 4K con ragionamento nativo, rendering testo multilingue ed editing guidato da riferimenti.

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-2",
    "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-2",
    "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:12:33:23:44:34:55:49:1616:921:9`
resolution	string	Facoltativo	ResolutionOpzioni: `1K2K4K`
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, account bannato o limite di spesa della chiave API superato
404	Esecuzione non trovata
429	Limite di frequenza superato
500	Errore interno del server