Benutzerhandbuch

GPT Image API Leitfaden: Modell-IDs, Routing und Migration

Eine dauerhaft gültige Landkarte: von den alten OpenAI-Bildbezeichnungen zu GPT Image 2 – mit den aktuellen HiAPI-Modell-IDs, den ausgemusterten Pro-Alternativen und einem Hinweis, welche Seite du für jeden nächsten Schritt aufrufen solltest.

Jun 24, 2026

Kurze Antwort

Für neue direkte OpenAI-Bildintegrationen lautet die aktuelle Modell-ID gpt-image-2. Für neue HiAPI-Integrationen verwendest du gpt-image-2/text-to-image, wenn die Aufgabe mit einem Prompt beginnt, und gpt-image-2/image-to-image, wenn die Aufgabe mit einem oder mehreren Referenzbildern beginnt.

Diese Bezeichnungen sind leicht zu verwechseln, weil mit „GPT-4o image“, „ChatGPT image generation“, „GPT Image API“ und „GPT Image 2“ verwandte, aber unterschiedliche Produktoberflächen gemeint sein können. Der sichere Weg ist, zuerst zu klären, welche API du aufrufen willst, und dann die Modell-ID und den Request-Vertrag dieser API zu verwenden.

Oberfläche	Aktuelles Modell oder aktueller Selektor	Request-Modus
OpenAI Image API	`gpt-image-2`	OpenAI `/v1/images/generations` oder `/v1/images/edits`
OpenAI Responses API	Unterstütztes Hauptmodell plus Bildgenerierungstool	Konversationelle oder mehrstufige Bildarbeit über `/v1/responses`
HiAPI Text-zu-Bild	`gpt-image-2/text-to-image`	`POST https://api.hiapi.ai/v1/tasks`
HiAPI Bild-zu-Bild	`gpt-image-2/image-to-image`	`POST https://api.hiapi.ai/v1/tasks`

HiAPI fungiert nicht als Proxy für den Request-Body der OpenAI Image API. Es stellt die GPT-Image-Routen über einen einheitlichen asynchronen Task-Vertrag bereit; daher reicht es für eine Migration nicht aus, nur den Hostnamen zu ändern.

Die GPT-Image-Abstammung, die Entwickler kennen müssen

Die nützliche Abstammungslinie ist eine umsetzbare Migrationskarte. Nicht alle folgenden Bezeichnungen verweisen auf austauschbare API-Modelle.

Bezeichnung, die du in altem Code oder in Suchergebnissen sehen könntest	Aktueller Status	Was jetzt zu tun ist
„GPT-4o image generation“ oder „ChatGPT image generation“	Produktoberfläche oder UI-Formulierung, keine aktuelle Bildmodell-ID, die du in einen neuen Bild-Request einfügen kannst	Wähle zuerst eine API-Oberfläche und verwende dann deren aktuelles Modell und deren Request-Vertrag
`chatgpt-4o-latest`	Veralteter ChatGPT-Modell-Alias; die aktuelle OpenAI-Modellseite führt Bildeingaben auf, nicht Bildausgaben	Verwende es nicht als Migrationsziel für die Bildgenerierung
`gpt-image-1`	Von OpenAI als Bildgenerierungsmodell der vorherigen Generation und als veraltet gekennzeichnet	Migriere neue Bildarbeit auf `gpt-image-2`
`gpt-image-1.5`	Von OpenAI als Bildgenerierungsmodell der vorherigen Generation und als veraltet gekennzeichnet	Migriere neue Bildarbeit auf `gpt-image-2`
`dall-e-2` oder `dall-e-3`	Veraltet und aus der OpenAI API entfernt	OpenAI empfiehlt für aktuelle Generierung und Bearbeitung `gpt-image-2`
`gpt-image-2`	Aktuelle direkte Bildmodell-ID von OpenAI	Verwende sie mit der OpenAI Image API oder ordne die Aufgabe der unten genannten HiAPI-Slash-ID zu

Die aktuelle OpenAI-Dokumentation beschreibt gpt-image-2 als ihr fortschrittlichstes Bildgenerierungsmodell und dokumentiert Text-zu-Bild-Generierung sowie Bildbearbeitung. Der OpenAI-Leitfaden zur Bildgenerierung unterscheidet außerdem die einmalige Image API von der konversationellen Bildgenerierung über die Responses API. Die oben genannten Statusangaben zu den Modellen stammen von den folgenden offiziellen Seiten: GPT Image 2, GPT Image 1.5, GPT Image 1, DALL-E 2, DALL-E 3 und ChatGPT-4o, geprüft am 31. August 2026.

Vom UI-Workflow zum API-Workflow wechseln

ChatGPT-Bildsitzungen verbergen Modellauswahl, Status, Wiederholungen und Dateiverarbeitung hinter dem Dialog. Eine API-Integration muss diese Entscheidungen explizit treffen.

Der offizielle OpenAI-Leitfaden empfiehlt die Image API für einzelne Generierungen oder Bearbeitungen und die Responses API für konversationelle, mehrstufige Bildarbeit. HiAPI verwendet einen dritten Vertrag: Jede Bildaufgabe ist ein asynchroner Task. Dein Backend reicht den Task ein, speichert die zurückgegebene taskId und erhält das Endergebnis über einen Callback oder eine spätere Anfrage zu den Task-Details.

Ein kreatives Briefing aus einer UI-Sitzung ist weiterhin ein nützlicher Ausgangsprompt, aber überführe es in das tatsächliche Request-Schema der API und teste die Ausgabe. Kopiere keine UI-Produktnamen in das Feld model und gehe nicht davon aus, dass es sich um eine stabile API-ID handelt.

Für HiAPI bewahrst du den API-Schlüssel auf dem Server auf und reichst den Task wie folgt ein:

curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2/text-to-image",
    "input": {
      "prompt": "A clean launch poster with the exact headline SUMMER DROP",
      "aspect_ratio": "4:5",
      "resolution": "1K"
    },
    "callback": {
      "url": "https://your-domain.com/hiapi/callback",
      "when": "final"
    }
  }'

Das callback-Objekt gehört auf die oberste Ebene, neben model und input. Für lokales Debugging oder Abgleich frage GET https://api.hiapi.ai/v1/tasks/{taskId} per Polling ab. Nach erfolgreichem Task lädst du das Bild von data.output[].url herunter, statt die temporäre Ausgabe-URL als dauerhaften Speicher zu behandeln.

Diese Hub-Seite zeigt bewusst nur einen Request. Routenspezifische Felder, Callbacks, Polling und kopierfertige Beispiele findest du in der Text-zu-Bild-API-Dokumentation oder der Bild-zu-Bild-API-Dokumentation.

Alte OpenAI-Bildaufrufe zu HiAPI migrieren

Die OpenAI-Modellmigration und die Provider-Vertragsmigration sind zwei getrennte Änderungen. Wähle zuerst die aktuelle Bildaufgabe und schreibe den Request dann für die Task-API von HiAPI um.

Alte Eingabe	Aktuelles direktes OpenAI-Ziel	Aktuelles HiAPI-Ziel
Text-zu-Bild mit `gpt-image-1`, `gpt-image-1.5` oder DALL-E-IDs	`gpt-image-2`-Generierung	`gpt-image-2/text-to-image`
Bildbearbeitung mit `gpt-image-1` oder `gpt-image-1.5`	`gpt-image-2`-Bearbeitung	`gpt-image-2/image-to-image`
Reine UI-Workflows für ChatGPT- oder GPT-4o-Bilder	Je nach Interaktionsdesign OpenAI Image API oder Responses API wählen	HiAPI-Task-Route für Text-zu-Bild oder Bild-zu-Bild wählen

Bei der Migration zu HiAPI ersetzt du synchrone oder OpenAI-spezifische Antwortverarbeitung durch taskId-Persistenz, Behandlung von Endzuständen und Ausgabe-Download. Überprüfe Prompts und Ausgaben erneut und verspreche keine pixelgenaue Gleichheit der Ergebnisse über verschiedene Oberflächen hinweg.

Alte HiAPI-Modellnamen migrieren

HiAPI verwendet jetzt aufgabenspezifische Slash-IDs und einen Selektor auf oberster Routing-Ebene. Neuer Code sollte die unten gezeigte kanonische Request-Form verwenden.

Alter HiAPI-Name	Aktueller Request
`gpt-image-2`	`model: "gpt-image-2/text-to-image"`
`gpt-image-2-image-to-image`	`model: "gpt-image-2/image-to-image"`
`gpt-image-2-beta`	`model: "gpt-image-2/text-to-image"` plus `route: "beta"`
`gpt-image-2-ext`	`model: "gpt-image-2/text-to-image"` plus `route: "ext"`
`gpt-image-2-i2i-ext`	`model: "gpt-image-2/image-to-image"` plus `route: "ext"`

Öffentliche Preisangaben führen geroutete Einträge möglicherweise als gpt-image-2/text-to-image@ext oder gpt-image-2/image-to-image@ext. HiAPI akzeptiert auch die routenqualifizierte Form, die Modelldokumentation verwendet jedoch die Basis-Slash-ID zusammen mit dem Feld route auf oberster Ebene, weil so das routenspezifische Eingabe-Schema leichter zu erkennen ist.

Ausgemusterte HiAPI-Pro-IDs ersetzen

HiAPI hat am 2. Juli 2026 zwei alte Pro-IDs ausgemustert. Sie erscheinen nicht mehr in den aktuellen öffentlichen Preisangaben und sollten in neuen Beispielen nicht mehr vorkommen.

Ausgemusterte ID	Ersatz
`gpt-image-2-pro`	`gpt-image-2/text-to-image`
`gpt-image-2-image-to-image-pro`	`gpt-image-2/image-to-image`

Diese Modellmigration garantiert nicht, dass jeder Parameter des alten Pro exakt dieselbe Wirkung erzielt. Sieh dir das aktuelle Routen-Schema in der jeweiligen Modelldokumentation an und führe vor dem Produktivwechsel einen Test mit einem repräsentativen Prompt und Referenzbild durch.

Wo du als Nächstes nachsehen solltest

Diese Seite dient Namen, Abstammung und Migration. Wähle das passende Ziel danach aus, welche Frage du beantworten willst:

Einstieg und Integration

GPT Image 2 Modellseite für das aktuelle Modell und den Playground.
GPT Image 2 Bild-zu-Bild-Modellseite für Referenzbild-Bearbeitung im Playground.
GPT Image 2 Text-zu-Bild-Dokumentation für die Request-Felder von standard, beta und ext.
GPT Image 2 Bild-zu-Bild-Dokumentation für die Bearbeitungsfelder von standard und ext, einschließlich der Unterschiede bei der Benennung von Referenzbildern.
GPT Image 2 API-Preise für die aktuelle Routentabelle, Zuschläge für Referenzbilder und Budgetberechnung.
HiAPI Live-Preise für den vollständigen aktuellen Modellkatalog.

Anwendungsfälle und gemessene Belege

Vergleich und Auswahl

Häufig gestellte Fragen

Was ist die aktuelle GPT Image API-Modell-ID?

Für die direkte Image API von OpenAI ist es gpt-image-2. Für HiAPI verwendest du je nachdem, ob die Aufgabe mit Text oder mit einem Referenzbild beginnt, gpt-image-2/text-to-image oder gpt-image-2/image-to-image.

Kann ich den nackten Modellnamen `gpt-image-2` an HiAPI senden?

Verwende den nackten Namen nicht in neuem HiAPI-Code. Die aktuellen kanonischen IDs sind die oben gezeigten aufgabenspezifischen Slash-Namen; sie machen außerdem Preisgestaltung, Schema und Modellseiten-Routing eindeutiger.

Verwendet HiAPI den OpenAI-Endpunkt `/v1/images/generations`?

Nein. HiAPI-Bildmodelle verwenden POST /v1/tasks und rufen das Ergebnis anschließend über einen finalen Callback oder GET /v1/tasks/{taskId} ab. Die Request- und Response-Verträge der OpenAI Image API und der HiAPI Task API unterscheiden sich.

Wo sollte der Callback platziert werden?

Lege callback auf die oberste Ebene des Task-Bodys, neben model und input. Verwende callback.when: "final" und gestalte den empfangenden Dienst anhand von taskId idempotent, da sowohl Erfolg als auch Fehler Endzustände sind.

Was ersetzt `gpt-image-2-pro`?

Verwende gpt-image-2/text-to-image. Für die ausgemusterte Bild-zu-Bild-Pro-ID verwendest du gpt-image-2/image-to-image. Sieh dir vor dem Wechsel das aktuelle Eingabe-Schema an und teste einen repräsentativen Task.

TagsBild-API Migration