OpenAI

GPT Image 2.5

gpt-image-2.5-flare/image-to-image

OpenAIs zweistufiges Bildgenerierungs- und -bearbeitungsmodell: Flare setzt auf Geschwindigkeit, Sunburst auf Präzision – für Text-zu-Bild und mehrstufige Bildbearbeitung gleichermaßen

Route

default pro

gpt-image-2.5-flare/image-to-image gpt-image-2.5-flare/text-to-image gpt-image-2.5-sunburst/image-to-image gpt-image-2.5-sunburst/text-to-image

gpt-image-2.5-flare/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.5-flare/image-to-image per image

Spezifikationen	Einzelpreis
1K	$0.050
2K	$0.080
4K	$0.120

Kurzbeschreibung

gpt-image-2.5-flare/image-to-image ist die Schnittstelle für Bildbearbeitung innerhalb der OpenAI-Bildmodellfamilie: Sie nimmt ein bis sechzehn Referenzbilder sowie eine Bearbeitungsanweisung entgegen und gibt ein einzelnes Ergebnisbild aus. Flare legt im Vergleich zu Sunburst mehr Wert auf die Balance zwischen Geschwindigkeit und Bildqualität und eignet sich für Anwendungen, die schnelle Bilderzeugung oder Stapelverarbeitung erfordern. Entwickler können die Schnittstelle über die einheitliche API von HiAPI.ai aufrufen, zwischen 1K- bis 4K-Auflösungen und verschiedenen Seitenverhältnissen wählen und auch transparente Hintergründe ausgeben lassen; dies eignet sich für Bildumbauaufgaben wie E-Commerce-Materialien, Markenvisuals und Design-Retusche.

Wesentliche Highlights

Mehrere Referenzbilder, bis zu 16 – eine Anfrage kann bis zu 16 Quell- oder Referenzbilder enthalten, um mehrere Materialien zu verschmelzen oder Motiv und Layout festzulegen.
Transparenter Hintergrund nur in der 1K-Stufe – der Hintergrundmodus bietet drei Optionen: transparent, undurchsichtig und automatisch, ist jedoch nur bei 1K-Auflösung verfügbar; bei 2K und 4K muss dieser Parameter weggelassen werden.
Auflösung und Seitenverhältnis wählbar – die Ausgabe unterstützt die drei Stufen 1K, 2K und 4K sowie dreizehn Seitenverhältnisse; standardmäßig wird das Verhältnis automatisch gewählt, kann aber je nach Platzierungsort vorab festgelegt werden.
Flare betont die Balance zwischen Geschwindigkeit und Qualität – in derselben Familie gibt es außerdem eine präzisere Sunburst-Version; Flare eignet sich besser für reguläre Bearbeitungsabläufe mit Anforderungen an die Reaktionszeit.

Funktionsbeschreibung

Bearbeitung mit mehreren Referenzbildern: Es werden bis zu 16 JPEG-, PNG- oder WebP-Bilder entgegengenommen, zusammen mit einer Anweisungsbeschreibung von bis zu 20.000 Zeichen, die das Änderungsziel vorgibt; dies eignet sich, um das Bild neu zu zeichnen und dabei Referenzmotiv und Layout beizubehalten.

Steuerung von Auflösung und Seitenverhältnis: Die Ausgabestufe kann mit 1K, 2K oder 4K angegeben werden, und aus Verhältnissen wie 1:1, 16:9, 9:16 oder 21:9 kann gewählt werden; dies reduziert den Aufwand für nachträgliches Zuschneiden und richtet das Ergebnis direkt an der Platzierungsgröße aus.

Wechsel des Hintergrundmodus: Bei 1K-Auflösung kann der Hintergrund auf transparent, undurchsichtig oder automatisch gesetzt werden; eine transparente Ausgabe erleichtert den direkten Übergang in Kompositions- und Layoutprozesse und reduziert den Freistellungsaufwand.

Feinabstimmung per Anweisung: Dank des größeren Prompt-Kontingents und der Befolgung komplexer visueller Anweisungen lassen sich in vorhandenen Bildern lokale Ersetzungen, Stilanpassungen und Detailüberarbeitungen vornehmen; dies eignet sich für iterative Bearbeitungsabläufe.

Anwendungsfälle

E-Commerce-Betrieb: Materialien auf Basis von Produktbildern in Stapeln umgestalten – Produktfotos und Bildbearbeitungsanweisungen eingeben und Produktvisuals in mehreren Größen und Seitenverhältnissen erzeugen, für Detailseiten, Hauptbilder und Werbeplatzierungsmaterialien.
Markenmarketing: Visuals aus mehreren Referenzbildern zusammenstellen – mehrere Referenzbilder zu einem stilistisch einheitlichen visuellen Entwurf verschmelzen, für frühe Abstimmungen bei Pitch-Präsentationen, Präsentationsfolien und Website-Bebilderung.
Design-Zusammenarbeit: wiederholte Feinüberarbeitung auf vorhandenem Layout – vorhandene Designentwürfe als Eingabe nutzen, um Motiv, Beleuchtung und Hintergrund Runde für Runde zu ändern und direkt weiterverwendbare Ergebnisbilder für das nachfolgende Layout zu erzeugen.
Materialproduktion: Ausgabe von Bildern mit transparentem Hintergrund – in der 1K-Stufe Elementbilder mit transparentem Hintergrund erzeugen, für Icons, Texturen und die Compositing-Bibliothek, wodurch zusätzliche Freistellungsschritte entfallen.

Einschränkungen und Auswahlhinweise

Diese Schnittstelle führt ausschließlich Bildbearbeitung durch und erfordert mindestens ein Quellbild; eine reine Textgenerierung ist nicht möglich. Der Hintergrundmodus wirkt nur in der 1K-Stufe; bei 2K und 4K muss dieser Parameter weggelassen werden. Layouts mit vielen kleinen Schrifttexten oder komplexen Legenden sind weiterhin fehleranfällig und erfordern manuelle Prüfung. Wenn eine höhere Detailtreue benötigt wird und längere Wartezeiten akzeptabel sind, kann die Sunburst-Variante gewählt werden; für reine Text-zu-Bild-Generierung ist die entsprechende Text-to-Image-Variante zu verwenden. Hochauflösende Ausgaben erhöhen den Rechen- und Warteaufwand.

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.5-flare/image-to-image

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

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

promptstringPflichtminLength 1maxLength 20000

Generierungs- oder Bearbeitungsanweisung, die beschreibt, was basierend auf dem Quellbild generiert oder bearbeitet werden soll, maximal 20000 Zeichen.

backgroundstringOptional

Hintergrundmodus, nur bei 1K-Auflösung unterstützt; bei Verwendung von 2K/4K-Auflösung bitte diesen Parameter weglassen.

Optionen:transparentopaqueauto

image_urlsarrayPflichtminItems 1maxItems 16

Array mit Quell- oder Referenzbildern, unterstützt 1 bis 16 Bilder im Format JPEG, PNG oder WebP.

Array [ string ]

resolutionstringOptionalStandard: "1K"

Ausgabauflösungsstufe, Standard 1K; wenn background auf auto, opaque oder transparent gesetzt ist, wird nur 1K unterstützt.

Optionen:1K2K4K

aspect_ratiostringOptionalStandard: "auto"

Ausgabeseitenverhältnis, standardmäßig auto, wenn weggelassen.

Optionen:auto1:13:22:34:33:416:99:16

Alle anzeigen (5)

21:927:1616:279:88:9

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.5-flare/image-to-image",
  "input": {
    "prompt": "…",
    "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.5-flare/image-to-image",
    input: {
      "prompt": "…",
      "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.5-flare/image-to-image",
        "input": {
          "prompt": "…",
          "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"
    }
  }
}