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	Некорректный запрос — отсутствующие или неверные параметры
401	Ошибка аутентификации — отсутствующий или недействительный API-ключ
402	Недостаточно средств
403	Доступ запрещён — IP не разрешён или превышен лимит API-ключа
404	Запуск не найден
429	Превышен лимит запросов
500	Внутренняя ошибка сервера