OpenAI

GPT Image 2

gpt-image-2/image-to-image

OpenAIs Modell zur Bilderzeugung und -bearbeitung mit Schwerpunkt auf fotorealistischer Wiedergabe, hochpräziser Textdarstellung und nativer 4K-Ausgabe, geeignet für kommerzielle Materialien mit Text und Produktbilder

Route

default ext beta

gpt-image-2/image-to-image gpt-image-2/text-to-image

gpt-image-2/image-to-image ausprobieren

Eingabe

Galerie

Alle Arbeiten ansehen

Ausgabe

image

Fülle die Parameter aus und generiere – die Ergebnisse erscheinen hier.

Preise

gpt-image-2/image-to-image per image

Spezifikationen	Einzelpreis
1K	$0.030
2K	$0.040
4K	$0.060

gpt-image-2/image-to-image @ext per image

Spezifikationen	low	medium	high
1K	$0.007	$0.061	$0.245
2K	$0.015	$0.132	$0.535
4K	$0.022	$0.217	$0.760

Einordnung

gpt-image-2/image-to-image ist eine auf Bildwiedergenerierung und -bearbeitung ausgerichtete Linie innerhalb der OpenAI-Bildmodellfamilie. Sie nimmt 1 bis 16 Referenzbilder sowie einen Text-Prompt entgegen und gibt ein rekonstruiertes Bild aus. Sie eignet sich für Entwicklungs-Szenarien, in denen vorhandenes Material als Grundlage für Umformulierung, Outpainting, Stilvereinheitlichung oder Layout-Austausch dienen soll, und ermöglicht die Auswahl von Bildformat und einer Auflösung von bis zu 4K je nach Auslieferungsspezifikation. Im Vergleich zur reinen Text-zu-Bild-Generierung liegt der Mehrwert dieser Linie darin, dass das Generierungsergebnis an den vom Entwickler bereitgestellten Referenzbildern verankert wird.

Kernhighlights

Eingabe mit mehreren Referenzbildern – pro Aufruf können 1 bis 16 Referenzbilder übermittelt werden, um die Materialkollektion als Generierungsgrundlage zu nutzen statt sich nur auf Textbeschreibungen zu verlassen.
Bildformat nach Auslieferungsspezifikation wählbar – integriert sind über zehn Seitenverhältnisse von 1:1 und 16:9 bis 21:9 und 9:21, die sich direkt an Landingpages, Feeds und Hochformat-Material ausrichten lassen.
Auflösung bis 4K – unterstützt drei Ausgabestufen: 1K, 2K und 4K; das 1:1-Format unterstützt kein 4K; hohe Auflösungen eignen sich für Druckqualität oder Großbild-Material.
Unterstützung transparenter Hintergrundausgabe – bei 1K-Auflösung kann zwischen transparentem, opakem oder automatischem Hintergrundmodus gewählt werden, was das direkte Einfügen in andere Designebenen erleichtert.

Funktionsbeschreibung

Referenzbildgestützte Bildumformulierung: Erzeugt auf Basis der Eingabebilder neue Bilder, geeignet zum Austauschen von Stilen, Anpassen der Komposition oder Erstellen von Varianten auf Grundlage vorhandenen Materials; das Ergebnis übernimmt die visuellen Hinweise der Referenzbilder.

Kombinierte Steuerung von Format und Auflösung: Die Ausgabespezifikation wird über die Parameter aspect_ratio und resolution festgelegt; bei Auswahl von auto oder speziellen Seitenverhältnissen ist das Format auf 1K beschränkt, was vorab in den Parametern berücksichtigt werden muss.

Steuerung des Hintergrundmodus: Der Parameter background bietet die drei Werte auto, opaque und transparent und wirkt nur bei 1K-Auflösung; geeignet für nachgelagerte Prozesse, die Freistellung oder geschichtete Komposition erfordern.

Beschränkung langer Prompts: Der Prompt ist auf 20000 Zeichen begrenzt; mehrere Einschränkungen, Layoutangaben und Textinhalte können auf einmal eingegeben werden, wodurch mehrfache ergänzende Beschreibungen reduziert werden.

Zusammenführung mehrerer Bildmaterialien: input_urls unterstützt die gleichzeitige Übergabe mehrerer Bilder; Motiv, Stilreferenz und Layout-Beispiele können getrennt bereitgestellt werden, und das Modell fasst sie zu einer Ausgabe zusammen.

Anwendungsszenarien

Design-Teams erstellen Mehrformat-Erweiterungen auf Basis vorhandener Key Visuals – Key Visual und unterschiedliche Formatvorgaben hochladen, um stapelweise Versionen für Feeds, Splashscreens und Hochformat zu erzeugen, die direkt in die Auslieferungs-Mediathek gelangen.
E-Commerce-Betrieb erzeugt szenenbezogene Neugenerierungen von Produktbildern – reale Produktfotos übergeben und Fertigbilder mit unterschiedlichen Hintergründen und Lichtverhältnissen erzeugen, die für Detailseiten und Werbeflächen eingesetzt werden.
Iteration von Bild-Text-Layouts im Visual Design – vorhandene Layout-Entwürfe als Referenz nutzen, per Prompt Texte und Grafikelemente austauschen und eine neue Design-Version zur Freigabe erstellen.
Kompositionsprozesse mit transparentem Hintergrundmaterial – bei 1K die Ausgabe mit transparentem Hintergrund aktivieren und das Ergebnis direkt auf andere Ebenen oder Szenen legen, wodurch manuelles Freistellen entfällt.

Einschränkungen und Auswahlhinweise

Diese Linie gibt ausschließlich Bilder aus und umfasst keine anderen Modalitäten wie Video oder Text. Zwischen Auflösung und Format besteht eine Kopplung: Automatische oder spezielle Seitenverhältnisse unterstützen nur 1K, 1:1 unterstützt kein 4K, und ein transparenter Hintergrund ist ebenfalls nur bei 1K verfügbar; bei hohen Spezifikationen und Hintergrundsteuerung ist daher eine Abwägung in den Parametern erforderlich. Hohe Auflösungen und mehrere Referenzbilder erhöhen die Generierungsdauer und die Aufrufkosten und eignen sich nicht für Echtzeit-Interaktionsszenarien mit sehr geringen Latenzanforderungen; wenn ausschließlich eine direkte Bilderzeugung aus Text ohne Referenzmaterial benötigt wird, sollte die Text-zu-Bild-Linie derselben Familie gewählt werden.

Neuigkeiten

Changelog ansehen →

Parameteränderung gpt-image-2: Neue Auflösungsstufen 1K / 2K / 4K Apr 30, 2026

Häufige Fragen

Alle Fragen ansehen →

Was ist GPT Image 2?

GPT Image 2 ist ein Text-zu-Bild-Modell von OpenAI, geeignet für Poster, Wissenskarten, Produktvisuals und Bildgenerierung mit klaren Anforderungen an Text und Layout.
Sind GPT Image 2 und GPT Image 2.0 dasselbe Modell?

GPT Image 2.0 ist eine gängige Suchabkürzung; verwenden Sie die genaue Modell-ID, die auf der GPT Image 2-Seite und in der API-Dokumentation aufgeführt ist.
Welcher Endpunkt und welche Modell-ID werden für die GPT Image 2 API verwendet?

Sende eine Anfrage an POST /v1/tasks, setze für die Text-zu-Bild-Generierung model auf gpt-image-2/text-to-image und übergebe prompt, aspect_ratio und resolution in input. Die Schnittstelle gibt zunächst eine taskId zurück, anschließend erhältst du das endgültige Bild über die Aufgabenabfrage oder einen callback.
Wie verwende ich GPT Image 2?

Beschreibe im Playground das Motiv, die Szene, das Layout und den Text, der unbedingt erscheinen muss, wähle dann Bildformat, Auflösung und Hintergrund, klicke auf Ausführen und sieh dir das Ergebnis an.

Generierungsaufgabe erstellen

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringPflicht

Account-API-Schlüssel. Bei jeder Anfrage erforderlich. Beispiel: Bearer YOUR_HIAPI_API_KEY. API-Schlüssel holen

Content-TypestringOptional

Der Anfragekörper wird immer als JSON geparst; beim Senden ist nur application/json (optional mit charset) zulässig — andere Werte liefern 415. Beispiel: application/json.

Idempotency-KeystringOptional

Idempotenz-Schlüssel, bis 255 Bytes. Wiederholungen mit demselben Schlüssel desselben Kontos erstellen die Aufgabe nur einmal; Replays liefern die ursprüngliche taskId.

Idempotenz-Schlüssel

Bei Netzwerk-Timeouts oder Client-Wiederholungen erstellt derselbe Schlüssel die Aufgabe nur einmal — keine doppelte Abbuchung (Geltungsbereich = das Konto des API-Schlüssels). Empfohlen: geschäftsseitig eindeutige Kennung (z. B. "order-42"); Replays liefern die ursprüngliche taskId, Schlüssel laufen 24 Stunden nach der ersten Anfrage ab. Die vollständige Szenariomatrix steht in der Übersicht der Unified Async API.

Body

modelstringPflicht

Aktueller Festwert: gpt-image-2/image-to-image

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

Geschäftsparameter für gpt-image-2/image-to-image und Route default — siehe Parametertabelle unten.

promptstringPflichtminLength 1maxLength 20000

Text-Prompt, erforderlich, maximale Länge 20.000 Zeichen, beschreibt den gewünschten Bildinhalt.

backgroundstringOptional

Hintergrundmodus, steuert die Hintergrundverarbeitung des generierten Bildes; dieser Parameter wird nur bei 1K-Auflösung unterstützt.

Optionen:autoopaquetransparent

input_urlsarrayPflichtminItems 1maxItems 16

Array von Referenzbild-URLs, stellt ein oder mehrere Bilder als Referenz für die Bild-zu-Bild-Generierung bereit; unterstützt 1 bis 16 Bilder.

Array [ string ]

resolutionstringOptionalStandard: "1K"

Auflösung des generierten Bildes, Standard 1K. Wenn aspect_ratio auf auto gesetzt ist, muss 1K verwendet werden; 1:1 unterstützt kein 4K; wenn aspect_ratio 3:1/1:3/9:21 ist, wird nur 1K unterstützt; wenn background auto/opaque/transparent ist, wird nur 1K unterstützt.

Optionen:1K2K4K

aspect_ratiostringOptionalStandard: "auto"

Seitenverhältnis des generierten Bildes, Standard auto. Bei auto oder Weglassen wird nur die 1K-Auflösung unterstützt.

Optionen:auto1:13:22:34:33:45:44:5

Alle anzeigen (8)

16:99:162:11:23:11:321:99:21

callbackobjectOptional

Konfiguration der Endzustands-Benachrichtigung. Ohne Angabe wird kein Callback gesendet — selbst abfragen.

Callbacks (Webhook)

Beim Erstellen callback.url angeben, dann POSTet HiAPI im Endzustand an Ihren Service — kein Polling nötig. Der Callback-Body entspricht der Aufgaben-Detailstruktur; Signaturprüfung, Wiederholungen und Idempotenz sind in der Übersicht der Unified Async API beschrieben.

urlstringPflicht

Pflicht, wenn callback angegeben ist. Nach dem Endzustand wird an diese URL gepostet; muss eine gültige http(s)-URL sein.

whenstringOptionalStandard: "final"

Derzeit wird nur final unterstützt — Benachrichtigung bei success und fail.

Optionen:final

storagestringOptionalStandard: "temp"

Speicherstufe für Artefakte: temp (Standard, ca. 7 Tage) oder persistent (langfristig, nach Größe abgerechnet). Bei unzureichendem Guthaben oder Überschreitung des Speicherlimits erfolgt ein stiller Downgrade auf temp; die wirksame Stufe steht in der Aufgaben-Detailantwort.

Optionen:temppersistent

Anfragebeispiele

# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2/image-to-image",
  "input": {
    "prompt": "…",
    "input_urls": "…",
    "resolution": "1K",
    "aspect_ratio": "auto"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gpt-image-2/image-to-image",
    input: {
      "prompt": "…",
      "input_urls": "…",
      "resolution": "1K",
      "aspect_ratio": "auto"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "gpt-image-2/image-to-image",
        "input": {
          "prompt": "…",
          "input_urls": "…",
          "resolution": "1K",
          "aspect_ratio": "auto"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

# Asynchrone Aufgabe senden; gibt sofort eine taskId zurück (wartet nicht auf die Generierung)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2/image-to-image@ext",
  "input": {
    "prompt": "…",
    "quality": "low",
    "image_urls": "…",
    "resolution": "1K",
    "aspect_ratio": "auto"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gpt-image-2/image-to-image@ext",
    input: {
      "prompt": "…",
      "quality": "low",
      "image_urls": "…",
      "resolution": "1K",
      "aspect_ratio": "auto"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "gpt-image-2/image-to-image@ext",
        "input": {
          "prompt": "…",
          "quality": "low",
          "image_urls": "…",
          "resolution": "1K",
          "aspect_ratio": "auto"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Aufgabendetails abrufen

GET https://api.hiapi.ai/v1/tasks/:id

Antwortfelder

taskIdstringPflicht

Aufgaben-ID, stets mit Präfix tk-hiapi-.

modelstringPflicht

Aufgelöster vollständiger Modellname. Mit route-Parameter eingereichte Aufgaben geben base@route zurück (z. B. gpt-image-2/text-to-image@ext); sonst identisch mit dem übermittelten Namen.

routestringOptional

Erscheint nur bei explizitem route-Parameter; gibt den übermittelten Wert zurück.

statusstringPflicht

Aufgabenstatus.

Statuswerte

queued Eingereiht, noch nicht gestartet. handling In Verarbeitung. archiving Verarbeitung abgeschlossen, Artefakte werden vorbereitet. success Endzustand: abgeschlossen, Artefakte verfügbar (output wird zurückgegeben). fail Endzustand: fehlgeschlagen (error wird zurückgegeben). Nach dem Senden den status prüfen: success und fail sind Endzustände, alles andere nicht. Alle 1–3 Sekunden bis zum Endzustand pollen. Nach Erfolg Artefakte aus output[].url laden und vor expireAt übertragen; für Langzeitaufbewahrung storage: "persistent" beim Erstellen angeben.

creatednumberPflicht

Zeitpunkt der Aufgabenerstellung (Unix-Sekunden).

completednumberPflicht

Unix-Sekunden des Endzustands; vor Abschluss stets 0.

outputarrayOptional

Nur bei status == success. Artefaktliste — immer ein Array; eine Aufgabe kann mehrere Typen gleichzeitig liefern (z. B. video + first_frame).

Array [ object ]

Array-Elemente

urlstringPflicht

Artefakt-URL, direkt herunterladbar.

typestringPflicht

Aktuell mögliche Werte: video, image, audio, first_frame, last_frame, thumbnail; später können weitere folgen.

expireAtnumberPflicht

Unix-Sekunden, bis wann das Artefakt verfügbar ist; vorher herunterladen oder übertragen.

errorobjectOptional

Nur bei status == fail.

codestringPflicht

Business-Fehlercode.

messagestringPflicht

Fehlerbeschreibung.

Antwortbeispiele

Erfolg

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

In Bearbeitung (nicht final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Fehlgeschlagen

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}