Runbase

Command Palette

Search for a command to run...

OpenAI

GPT Image 2

ID:openai/gpt-image-2

GPT Image 2 Bilderzeugung-API von OpenAI - bis zu 4K mit nativem Reasoning, mehrsprachigem Textrendering und referenzgesteuerter Bearbeitung.

Text zu BildBildbearbeitungReferenzbilderKommerzielle Nutzung

Übersicht

GPT Image 2 Bilderzeugung-API von OpenAI - bis zu 4K mit nativem Reasoning, mehrsprachigem Textrendering und referenzgesteuerter Bearbeitung.

Authentifizierung

Alle API-Anfragen erfordern einen gültigen API-Schlüssel im Authorization-Header mit dem Bearer-Schema.

Schnellstart

Zugangsdaten

Setze die Umgebungsvariable RUNBASE_API_KEY.

Shell
export RUNBASE_API_KEY=your-api-key

Ausführung erstellen

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"
    }
  }'

Ausführungen

Ausführungen werden asynchron verarbeitet. Sende eine Anfrage und frage dann das Ergebnis ab.

Ausführung erstellen

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" }
  }'

Ausführungsstatus abrufen

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

Ergebnis abrufen

Frage den Status-Endpunkt ab, bis status den Wert "succeeded" hat, und lies dann output.urls aus der Antwort.

Input-Schema

ParameterTypErforderlichBeschreibung
promptstringErforderlichPrompt
aspect_ratiostringOptionalAspect ratioOptionen: 1:12:33:23:44:34:55:49:1616:921:9
resolutionstringOptionalResolutionOptionen: 1K2K4K
image_urlsstring[]OptionalReference images

Output-Schema

FeldTypBeschreibung
urlsstring[]Generierte Ausgabe-URLs

Fehler

Die API verwendet Standard-HTTP-Statuscodes zur Anzeige von Erfolg oder Fehlern.

StatuscodeBeschreibung
400無效請求 - 缺少或格式錯誤的參數
401驗證失敗 - 缺少或無效的 API 金鑰
402點數不足
403禁止存取 - IP 不被允許或 API 金鑰消費上限已超過
404找不到執行紀錄
429超過速率限制
500內部伺服器錯誤