OpenAI

GPT Image 2.5

gpt-image-2.5-sunburst/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-sunburst/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-sunburst/image-to-image per image

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

Einordnung und Kurzprofil

Der Bildbearbeitungspfad von gpt-image-2.5-sunburst richtet sich an Entwickler, die hochpräzise Änderungen und Erweiterungen an vorhandenen Bildern vornehmen möchten. Er nimmt ein bis sechzehn Referenzbilder sowie eine Bearbeitungsanweisung entgegen, gibt Bilder in den Auflösungsstufen 1K, 2K und 4K aus und unterstützt die Angabe eines Seitenverhältnisses sowie transparenter Hintergründe. Damit eignet er sich für Design-Feinabstimmungsworkflows, bei denen das Motiv über mehrere Iterationen hinweg konsistent bleiben soll. Sunburst tauscht eine längere Verarbeitungszeit gegen höhere Detailtreue.

Kernhighlights

Präzisionsorientierter Bearbeitungspfad – Die Sunburst-Variante tauscht eine längere Einzelverarbeitungszeit gegen eine feinere Detailwiedergabe und eignet sich für Bearbeitungsaufgaben, bei denen die Qualität des Endergebnisses entscheidend ist.
Gemeinsame Eingabe von bis zu sechzehn Referenzbildern – Pro Anfrage lassen sich ein bis sechzehn Quell- oder Referenzbilder übermitteln, sodass Motiv-, Stil- und Layoutinformationen gemeinsam an das Modell übergeben werden können.
Vier Ausgabegrößen und wählbare Auflösungen – Die Ausgabe unterstützt die drei Auflösungsstufen 1K, 2K und 4K sowie dreizehn Seitenverhältnisse, passend direkt zu den Spezifikationen des Endprodukts, wodurch sekundäres Zuschneiden entfällt.
Transparenter Hintergrund bei 1K – Der transparente Hintergrundmodus ist auf die Auflösung 1K beschränkt; die erzeugten transparenten Assets können direkt in nachgelagerte Compositing-Prozesse übernommen werden.

Funktionsbeschreibung

Bedingte Bearbeitung mit mehreren Referenzbildern: Über image_urls lassen sich ein bis sechzehn JPEG-, PNG- oder WebP-Bilder zusammen mit einer Bearbeitungsanweisung von bis zu 20.000 Zeichen übermitteln, um vorhandenes Material umzuschreiben, zu ersetzen oder zu erweitern.

Steuerung von Auflösung und Seitenverhältnis: Mit resolution wird die Ausgabestufe 1K, 2K oder 4K gewählt; aspect_ratio unterstützt dreizehn Verhältnisse von 1:1 bis 21:9, wobei der Standardwert auto die Wahl dem Modell überlässt.

Erzeugung transparenter Hintergründe: background kann auf transparent, opaque oder auto gesetzt werden; der transparente Modus ist nur bei 1K-Auflösung verfügbar, sodass direkt freigestelltes Material entsteht.

Fein abgestimmte Detailwiedergabe: Die Sunburst-Variante legt den Schwerpunkt auf Detailtreue und kommt bei Textur, Beleuchtung und Layoutstruktur näher an die Referenzbilder heran, was sie für Bearbeitungsrunden mit hohen Anforderungen an das Endergebnis geeignet macht.

Anwendungsfälle

Design-Teams überarbeiten vorhandenes Markenmaterial im großen Stil – Markenvisuals werden als Referenzbilder übermittelt, Text und Farbgebung per einheitlicher Anweisung ersetzt und so komplette Materialsätze für Kampagnen erzeugt.
E-Commerce-Teams optimieren Produkt- und Szenenbilder – Ausgehend von Produktfotos entstehen fertige Bilder mit ausgetauschtem Hintergrund oder neuer Szene, die direkt für Produktdetailseiten und Werbematerial verwendet werden.
Kreative arbeiten iterativ an einem Bild – Das jeweils aktuelle Ergebnis wird mit weiteren Anweisungen als Eingabe verwendet, bis schrittweise der finale Entwurf vorliegt, der direkt als Design-Endprodukt geliefert werden kann.
Materialproduktion benötigt Grafiken mit transparentem Hintergrund – Aus Referenzbild und Bearbeitungsanweisung entstehen 1K-Bilder mit transparentem Hintergrund als Ebenenmaterial für die nachgelagerte Komposition und das Layout.

Einschränkungen und Auswahlhinweise

Sunburst priorisiert Präzision; eine einzelne Anfrage dauert länger und eignet sich nicht für Szenarien mit geringer Latenz oder sehr hoher Parallelität. Ausgaben in 2K und 4K erhöhen Rechen- und Warteaufwand weiter; ein transparenter Hintergrund ist nur bei 1K möglich. Layouts mit dichtem Fließtext in kleiner Schrift oder komplexen Legenden sind weiterhin fehleranfällig; nach der Ausgabe wird eine manuelle Prüfung empfohlen. Für lokale Bereitstellung, eigenes Feintuning oder Offline-Inferenz ist dieses Closed-Source-Modell ungeeignet; hier muss eine andere Lösung gewählt werden. Wenn schnelle Ausgaben im großen Stil benötigt werden, bietet sich der Flare-Pfad derselben Familie 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.5-sunburst/image-to-image

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

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

promptstringPflichtminLength 1maxLength 20000

Generierungs- oder Bearbeitungsanweisung, die beschreibt, was basierend auf dem Quellbild erzeugt oder geändert werden soll, als Zeichenkette, maximal 20000 Zeichen.

backgroundstringOptional

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

Optionen:transparentopaqueauto

image_urlsarrayPflichtminItems 1maxItems 16

Array von Quell- oder Referenzbildern, Elemente im Format JPEG, PNG oder WebP, Anzahl 1 bis 16.

Array [ string ]

resolutionstringOptionalStandard: "1K"

Ausgabauflösungsstufe, als Zeichenkette, Standard 1K; wenn background auto/opaque/transparent ist, wird nur 1K unterstützt.

Optionen:1K2K4K

aspect_ratiostringOptionalStandard: "auto"

Ausgabeseitenverhältnis, als Zeichenkette, Standard auto; bei Weglassen wird ebenfalls auto angenommen.

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-sunburst/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-sunburst/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-sunburst/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"
    }
  }
}