OpenAI

GPT Image 2.5

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

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

Einordnung

gpt-image-2.5-sunburst/text-to-image ist die Text-zu-Bild-Variante des OpenAI-Bildmodells gpt-image-2.5 mit Fokus auf Präzision: Längere Generierungszeiten pro Anfrage werden gegen eine feinere Detailtreue eingetauscht. Das Modell nimmt Text-Prompts als Eingabe entgegen und gibt ein einzelnes Bild aus. Es unterstützt die drei Auflösungsstufen 1K, 2K und 4K sowie verschiedene Seitenverhältnisse und eignet sich für Branding-Visuals, E-Commerce-Materialien, Inhaltsbebilderung und andere kreative sowie produktive Workflows, die hohe Ansprüche an Bilddetails und Layoutstabilität stellen und längere Wartezeiten akzeptieren.

Kernhighlights

Präzisionsorientierte Variante – längere Generierungszeiten pro Anfrage zugunsten der Detailtreue; ideal für Bildaufgaben, bei denen Bildqualität an erster Stelle steht.
Wählbare Auflösungen von 1K bis 4K – gestufte Ausgabauflösungen in Kombination mit 13 Seitenverhältnissen, sodass eine einzige Anfrage verschiedene Auslieferungsformate abdeckt.
Transparenter Hintergrund auf Wunsch – bei 1K-Auflösung lassen sich transparente oder einfarbige Hintergründe vorgeben, was zusätzliche Freistellungs- und Compositing-Schritte erspart.

Funktionsumfang

Text-zu-Bild mit langen Prompts: Prompts können bis zu 20000 Zeichen umfassen und somit ausführlichere Bildbeschreibungen sowie Layoutvorgaben transportieren – geeignet für komplexe visuelle Absichten.

Steuerung von Auflösung und Seitenverhältnis: Über resolution wird 1K, 2K oder 4K gewählt; über aspect_ratio lassen sich Verhältnisse von 1:1 bis 21:9 festlegen oder mit auto automatisch bestimmen.

Ausgabe mit transparentem Hintergrund: Der Parameter background unterstützt die Modi transparent, opaque und auto, ist jedoch nur bei 1K-Auflösung verfügbar; bei hochauflösender Ausgabe muss der Parameter weggelassen werden.

Detail- und Konsistenzleistung: Verbesserungen bei Licht- und Materialdarstellung, der Konsistenz referenzierter Motive sowie der Befolgung komplexer visueller Anweisungen; bei wiederholter Feinüberarbeitung bleiben Layout und Motiv leichter erhalten.

Anwendungsfälle

Branding-Visuals für Design- und Marketingteams – per Textbeschreibung Poster, Präsentationen und Website-Bebilderungen erzeugen, Seitenverhältnis und Auflösung passend zum Platzierungsort wählen und direkt ins Layout übernehmen.
Materialproduktion für E-Commerce und Produktseiten – Produktmerkmale und Szenenbeschreibungen eingeben und Bildmaterial für Produktdetailseiten und visuelle Präsentationen erhalten.
Bebilderung für Creator- und Social-Content – passend zum Inhaltsthema Bilder in Serie erzeugen und mit unterschiedlichen Seitenverhältnissen an die Formate der jeweiligen Plattformen anpassen.
Compositing-Workflows mit transparentem Material – in der 1K-Stufe Bilder mit transparentem Hintergrund erzeugen und direkt auf bestehende Seiten oder Designentwürfe legen.

Einschränkungen und Auswahlhinweise

Sunburst tauscht Geschwindigkeit gegen Präzision: Eine Anfrage dauert länger und eignet sich nicht für schnelle Bildausgabe mit niedriger Latenz und hoher Parallelität; bei Bedarf an schnellerem Durchsatz sollte die Flare-Variante gewählt werden, für die Bearbeitung auf Basis von Referenzbildern die zur selben Familie gehörende Bild-zu-Bild-Route. Die 4K-Ausgabe verursacht höheren Rechen- und Zeitaufwand; Layouts mit viel klein gedrucktem Text oder komplexen Legenden bleiben anspruchsvolle Szenarien und erfordern manuelle Prüfung. Das Modell ist ein gehosteter Dienst und unterstützt weder lokale Bereitstellung noch eigenes Feintuning.

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/text-to-image

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

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

promptstringPflichtminLength 1maxLength 20000

Bildgenerierungs-Prompt zur Beschreibung des gewünschten Bildinhalts; Zeichenkettentyp, maximale Länge 20000 Zeichen.

backgroundstringOptional

Hintergrundmodus, steuert die Hintergrundverarbeitung des generierten Bildes; Zeichenkettentyp. Dieser Parameter wird nur bei 1K-Auflösung unterstützt; bei 2K/4K-Auflösung bitte weglassen.

Optionen:transparentopaqueauto

resolutionstringOptionalStandard: "1K"

Ausgabeauflösungsstufe, steuert die Auflösungsebene des generierten Bildes; Zeichenkettentyp, Standard 1K. Wenn background auf auto, opaque oder transparent gesetzt ist, wird nur 1K unterstützt.

Optionen:1K2K4K

aspect_ratiostringOptionalStandard: "auto"

Ausgabeseitenverhältnis, steuert das Bildformat des generierten Bildes; Zeichenkettentyp, Standard auto; bei Weglassen wird auto verwendet.

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