OpenAI

GPT Image 2.6

gpt-image-2.6-flare/text-to-image

OpenAI-Modell für Bildgenerierung und -bearbeitung in zwei Stufen – Flare auf Geschwindigkeit ausgelegt, Sunburst auf Präzision, mit direkter Ausgabe von GIF-Animationen und SVG-Vektorgrafiken sowie Unterstützung für partielle Bildbearbeitung

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

gpt-image-2.6-flare/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.6 Neuheit: zeitlich begrenzt 20 % Rabatt 20% OFF · Endet 2026-11-13 Angebot ansehen

gpt-image-2.6-flare/text-to-image per image

Spezifikationen	low	medium	high	xhigh	max
1K	~~$0.023~~ $0.0184	~~$0.041~~ $0.0328	~~$0.049~~ $0.0392	~~$0.087~~ $0.0696	~~$0.195~~ $0.156
2K	~~$0.042~~ $0.0336	~~$0.075~~ $0.060	~~$0.090~~ $0.072	~~$0.160~~ $0.128	~~$0.360~~ $0.288
4K	~~$0.075~~ $0.060	~~$0.133~~ $0.1064	~~$0.160~~ $0.128	~~$0.283~~ $0.2264	~~$0.636~~ $0.5088
svg · 1K	~~$0.053~~ $0.0424	~~$0.071~~ $0.0568	~~$0.079~~ $0.0632	~~$0.117~~ $0.0936	~~$0.225~~ $0.180
svg · 2K	~~$0.072~~ $0.0576	~~$0.105~~ $0.084	~~$0.120~~ $0.096	~~$0.190~~ $0.152	~~$0.390~~ $0.312
svg · 4K	~~$0.105~~ $0.084	~~$0.163~~ $0.1304	~~$0.190~~ $0.152	~~$0.313~~ $0.2504	~~$0.666~~ $0.5328
gif · 1K · 2K · 4K	~~$0.070~~ $0.056	~~$0.124~~ $0.0992	~~$0.150~~ $0.120	~~$0.266~~ $0.2128	~~$0.598~~ $0.4784

Kurzbeschreibung

gpt-image-2.6-flare/text-to-image ist der geschwindigkeitsorientierte reine Text-zu-Bild-Endpunkt der OpenAI-gpt-image-2.6-Bildserie und wird über die einheitliche HiAPI.ai-Schnittstelle aufgerufen. Er wandelt eine Texteingabe direkt in ein fertiges Bild um, unterstützt Auflösungen von 1K bis 4K, mehrere Qualitäts- und Komplexitätsstufen, gängige Seitenverhältnisse und gibt PNG, JPEG, WebP, SVG sowie animierte GIFs aus. Geeignet für Entwickler, die Bilder zu geringen Stückkosten schnell erzeugen, große Mengen produzieren oder die Bildgenerierung in automatisierte Pipelines einbetten möchten.

Wichtigste Merkmale

Geringe Stückkosten, ideal für Massenproduktion – Abrechnung pro Bild mit einfachem Preisschlüssel, was die Kalkulation und Senkung der Stückkosten bei Batch-Aufgaben erleichtert.
Vektor- und Animationsausgaben in einem Aufruf – output_format unterstützt svg und gif; Vektorgrafiken und Frame-Animationen benötigen keine weitere Toolchain.
Qualität und Komplexität getrennt regelbar – quality steuert die Rendering-Stufe, complexity regelt separat die Planungstiefe; dichte Texte und komplexe Layouts lassen sich bei Bedarf hochsetzen.
Breite Abdeckung von Seitenverhältnissen und Auflösungen – 16 Formate von 1:1 bis 21:9 und 3:1 sowie wahlweise 1K, 2K oder 4K Ausgabeauflösung.

Funktionsbeschreibung

Direkte Bilderzeugung aus Text: prompt ist die einzige Pflichteingabe, bis zu 32.000 Zeichen; lange strukturierte Beschreibungen lassen sich ohne zusätzliche Parameter direkt in Bilder umsetzen.

Mehrere Ausgabeformate inkl. SVG und GIF: output_format unterstützt png, jpeg, webp, gif und svg; mit gif entsteht ein animiertes Bild, mit svg erhält man direkt eine Vektordatei – mehr lieferbare Asset-Typen.

GIF-Frameparameter kontrollierbar: frame_size, frame_count (2–16 Frames) und frame_duration_ms lassen sich setzen, um Animationsrhythmus und Bildgröße exakt über Pixelmaße und Frame-Intervall zu steuern.

Transparenter Hintergrund und komprimierte Ausgabe: background kann auf transparent gesetzt werden, kombiniert mit png oder webp für Assets mit transparentem Hintergrund; bei jpeg und webp lässt sich mit output_compression zwischen Dateigröße und Bildqualität abwägen.

Gestufte Qualität, Komplexität und Auflösung: quality bietet fünf Rendering-Stufen von low bis max, complexity steuert die Planungstiefe unabhängig, resolution ist wahlweise 1K, 2K oder 4K – je nach Szenario zwischen Geschwindigkeit und Detail abwägen.

Anwendungsfälle

Massenproduktion von Bildern für Marketing und Social Media – Kampagnenthema oder Textbeschreibung eingeben und Bilder in Formaten wie 16:9 oder 1:1 generieren, direkt für Social-Plattformen und Werbemittel.
Vektormaterial für Designteams – Icons oder Illustrationsbeschreibungen als Eingabe für SVG-Dateien, die in Design-Tools weiterbearbeitet oder direkt in Frontend-Seiten verwendet werden.
Leichte Animationsassets für Entwickler – GIFs über frame_count, frame_duration_ms und frame_size erzeugen, für Produktdemos, Ladeanimationen oder Dekorationen auf Aktionsseiten.
Programmatische Bebilderung in automatisierten Pipelines – Schnittstelle in Content-Systemen oder Build-Skripten aufrufen, prompt mit Auflösungs- und Formatparametern nach Vorlage zusammensetzen und Artikel oder Produkte massenhaft bebildern.

Einschränkungen und Auswahlhinweise

Dieser Endpunkt verarbeitet ausschließlich Text-zu-Bild; für partielle Änderungen an vorhandenen Bildern oder die Generierung anhand von Referenzbildern sollte der image-to-image-Endpunkt derselben Serie verwendet werden. Die GIF-Ausgabe hat eine Obergrenze für die Gesamtanzahl der Frames; zu große Frame-Größen oder zu viele Frames werden bei der Übermittlung abgelehnt, und bei GIF wird das Bildformat durch frame_size bestimmt, aspect_ratio kann nur auf auto bleiben. Transparenter Hintergrund erfordert zugleich png oder webp; bei output_compression muss output_format explizit angegeben werden. Wenn Detailkonsistenz bei mehreren Bearbeitungsrunden wichtiger ist, sollte vorrangig die Sunburst-Variante geprüft werden.

Häufige Fragen

Alle Fragen ansehen →

Wie erfolgt die Abrechnung? Werden Kosten berechnet, wenn eine Anfrage abgelehnt wird?

Die Abrechnung erfolgt pro Bild; der Stückpreis richtet sich nach der Qualitätsstufe und der Auflösung, siehe Preistabelle auf dieser Seite; Flare und Sunburst kosten gleich viel. Bei Image-to-Image wird pro Referenzbild zusätzlich $0.012 berechnet. GIFs werden separat nach Qualitätsstufe abgerechnet, unabhängig von der Auflösung. Anfragen mit ungültigen Parametern oder einer GIF-Größe über dem Limit werden bereits bei der Einreichung abgelehnt; die im Voraus einbehaltenen Kosten werden vollständig erstattet, es wird nichts berechnet.
Kann man nur einen Teil des Bildes ändern?

Ja, das geht über den Image-to-Image-Pfad, wobei Sie eine von zwei Methoden wählen. Erstens mask_url: Übergeben Sie ein RGBA-PNG mit derselben Größe wie das erste Quellbild; vollständig transparente Pixel sind der zu ändernde Bereich. Zweitens markup_url: Übergeben Sie ein transparentes PNG als Markierungsbild, in dem Sie die zu ändernden Stellen mit Markierungen wie Kreisen kennzeichnen; die Markierungen selbst erscheinen nicht im Ergebnis. Beide dürfen nicht gleichzeitig übergeben werden. Auch bei Verwendung einer Maske kann das Modell das gesamte Bild geringfügig neu zeichnen.
Was ist der Unterschied zwischen Flare und Sunburst, und welches sollte man wählen?

Beide haben identische Parameter, Nutzung und Preise; der Unterschied liegt im Schwerpunkt. Laut OpenAI erzeugt Flare Bilder schneller, eignet sich für schnelle Iterationen und die Massenproduktion von Bildern und ist die empfohlene Standardwahl; Sunburst legt mehr Wert auf Details und hält bei mehreren Bearbeitungsrunden in der Qualitätsstufe medium und höher die Details von Charakteren, Produkten oder Layouts konsistenter. Im Allgemeinen verwendet man zuerst Flare; wenn dasselbe Bild wiederholt überarbeitet werden muss und die Details stabil bleiben sollen, wechselt man zu Sunburst und setzt quality auf medium oder höher.
Können direkt GIF-Animationen oder SVG-Vektorgrafiken erzeugt werden?

Ja, bei der Text-zu-Bild-Route kann output_format auf gif oder svg gesetzt werden; die Bild-zu-Bild-Route unterstützt nur png, jpeg, webp. GIF wird durch drei Parameter gesteuert: frame_size legt die Pixelgröße pro Frame fest (Standard 512x512, Breite und Höhe bestimmen auch das GIF-Seitenverhältnis), frame_count legt die Anzahl der Frames fest (2–16, Standard 9), frame_duration_ms legt die Dauer pro Frame fest (Standard 200 Millisekunden). Beim Generieren eines GIF darf aspect_ratio nicht übergeben oder auf auto gesetzt werden.

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

routestringOptional

Aktueller Festwert: default

inputobjectPflicht

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

promptstringPflichtminLength 1maxLength 32000

Beschreibt das zu erzeugende Bild, maximal 32000 Zeichen.

qualitystringOptionalStandard: "high"

Stufe der Renderqualität, wählbar sind low, medium, high, xhigh, max; ohne Angabe ist der Wert high.

Optionen:lowmediumhighxhighmax

backgroundstringOptional

Hintergrundmodus, wählbar sind auto, opaque, transparent; für transparent muss die Ausgabe png oder webp sein.

Optionen:autoopaquetransparent

complexitystringOptional

Planungsebene, unabhängig von der Renderqualität: low eignet sich für einfache Motive mit einem einzelnen Hauptelement, high für dichten Text und komplexe Layouts; ohne Angabe ist der Wert high.

Optionen:lowmediumhigh

frame_sizestringOptionalpattern ^(auto|[0-9]+x[0-9]+)$

Nur für GIF: Pixelbreite x -höhe jedes Frames, z. B. 512x512; Breite und Höhe bestimmen zugleich das Seitenverhältnis des GIF. Beide Werte müssen Vielfache von 16 sein; Schreibweisen wie 1:1 als Verhältnis werden nicht akzeptiert; ohne Angabe oder bei auto ist der Wert 512x512. Alle Frames werden zu einem Gesamtbild zusammengesetzt; jede Seite des Gesamtbilds darf höchstens 3840 betragen, die Gesamtpixelzahl höchstens 8.294.400 und das Seitenverhältnis höchstens 3:1; bei Überschreitung wird die Anfrage in der Übermittlungsphase abgelehnt und nicht berechnet. Bei 512x512 werden 2–16 Frames unterstützt, bei 768x768 höchstens 12 Frames.

moderationstringOptional

Stufe der Inhaltsprüfung, wählbar sind auto oder low; ohne Angabe ist der Wert low.

Optionen:autolow

resolutionstringOptionalStandard: "1K"

Stufe der Ausgabeauflösung, wählbar sind 1K, 2K, 4K; ohne Angabe ist der Wert 1K.

Optionen:1K2K4K

frame_countintegerOptionalStandard: 9min 2max 16

Nur für GIF: Anzahl der Frames, ganzzahlig von 2–16; ohne Angabe ist der Wert 9. Bei einer Framegröße von 768x768 höchstens 12 Frames.

aspect_ratiostringOptionalStandard: "auto"

Seitenverhältnis der Ausgabe, ohne Angabe ist der Wert auto. Für GIF wird dieser Parameter nicht verwendet: ohne Angabe oder bei auto steuert frame_size die Größe und das Verhältnis jedes Frames.

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

Alle anzeigen (8)

16:99:162:11:221:99:213:11:3

output_formatstringOptionalStandard: "png"

Ausgabeformat, wählbar sind png, jpeg, webp, gif, svg; ohne Angabe ist der Wert png. gif erzeugt animierte Bilder, svg erzeugt Vektordateien; diese beiden werden nur bei der Text-zu-Bild-Generierung unterstützt. Wird output_compression übergeben, muss zugleich jpeg oder webp übergeben werden; wird einer der Werte frame_size, frame_count, frame_duration_ms übergeben, muss gif übergeben werden.

Optionen:pngjpegwebpgifsvg

frame_duration_msintegerOptionalStandard: 200min 20

Nur für GIF: Anzeigedauer jedes Frames in Millisekunden, mindestens 20, gerundet auf 10 Millisekunden; ohne Angabe ist der Wert 200.

output_compressionintegerOptionalmin 0max 100

Kompressionsstufe 0–100, nur für jpeg oder webp; wird dieser Parameter übergeben, muss zugleich output_format auf jpeg oder webp gesetzt werden.

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.6-flare/text-to-image",
  "input": {
    "prompt": "…",
    "quality": "high",
    "resolution": "1K",
    "frame_count": 9,
    "aspect_ratio": "auto",
    "output_format": "png",
    "frame_duration_ms": 200
  }
}'

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.6-flare/text-to-image",
    input: {
      "prompt": "…",
      "quality": "high",
      "resolution": "1K",
      "frame_count": 9,
      "aspect_ratio": "auto",
      "output_format": "png",
      "frame_duration_ms": 200
    }
  }),
});
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.6-flare/text-to-image",
        "input": {
          "prompt": "…",
          "quality": "high",
          "resolution": "1K",
          "frame_count": 9,
          "aspect_ratio": "auto",
          "output_format": "png",
          "frame_duration_ms": 200
        }
    },
)
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"
    }
  }
}