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	Requête invalide - paramètres manquants ou malformés
401	Échec de l'authentification - clé API manquante ou invalide
402	Crédits insuffisants
403	Interdit - IP non autorisée ou limite de crédits de la clé API dépassée
404	Exécution introuvable
429	Limite de requêtes dépassée
500	Erreur interne du serveur