GPT Image 1

ID:openai/gpt-image-1

API di generazione immagini GPT Image 1 di OpenAI — il primo modello immagine nativo GPT-4o di OpenAI con forte aderenza al prompt e fino a 5 immagini di riferimento.

Text to imageEditing immaginiImmagini di riferimento

Panoramica

API di generazione immagini GPT Image 1 di OpenAI — il primo modello immagine nativo GPT-4o di OpenAI con forte aderenza al prompt e fino a 5 immagini di riferimento.

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",
    "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",
    "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`
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	Ungültige Anfrage – fehlende oder fehlerhafte Parameter
401	Authentifizierung fehlgeschlagen – fehlender oder ungültiger API-Schlüssel
402	Unzureichendes Guthaben
403	Zugriff verweigert – IP nicht erlaubt oder Ausgabenlimit des API-Schlüssels überschritten
404	Ausführung nicht gefunden
429	Rate-Limit überschritten
500	Interner Serverfehler