Einen einfachen Bildaufruf von GPT Image 2.5 auf 2.6 umzustellen, bedeutet lediglich, die Modell-ID zu ändern. Die Endpunkte, Tokenpreise und drei empfohlenen Größen bleiben gleich. Zu beachten sind Batch, das es bei 2.5 gibt, bei 2.6 jedoch nicht; das Responses-Bild-Tool, das OpenAIs Materialien zu 2.5 und 2.6 unterschiedlich beschreiben; sowie die Steuerungsmöglichkeiten für Komplexität, SVG, GIF und Markup, die zwar für OpenAIs Image API dokumentiert sind, aber noch nicht im veröffentlichten Parameterschema von AIHubMix stehen.
Dieses Tutorial führt einen typischen Auftrag über AIHubMix durch: ein Poster im Format 1536x1024 mit einer Überschrift und einer Produktaufnahme. Zunächst werden drei günstige Flare-Entwürfe erstellt, einer davon ausgewählt und das finale Bild mit Sunburst gerendert. Für jeden Schritt werden die Kosten angegeben. Unterwegs geht es auch um Migrationsprobleme, die unbemerkt statt mit einer deutlichen Fehlermeldung auftreten.
Was gleich bleibt
Die beiden 2.6-Modelle sind gpt-image-2.6-sunburst und gpt-image-2.6-flare. Beide werden über v1/images/generations und v1/images/edits aufgerufen; einen einfachen Alias gpt-image-2.6 gibt es für keines von beiden. Texteingaben kosten 5 $ pro Million Token, Bildeingaben 8 $ und Bildausgaben 30 $ – genau wie bei 2.5 und GPT Image 2.
Das bedeutet: Eine auf der Image API basierende Pipeline behält ihre Anfrageform bei. Geändert wird nur die Modellzeichenfolge, und auch das nur, wenn du das neue Modell verwenden möchtest. Der Hauptgrund für einen Wechsel ab dem ersten Tag ist die Geschwindigkeitsangabe: Laut der Modellseite von AIHubMix ist die Modellfamilie 50% schneller.
Fallstricke bei der Migration
Batch gibt es nicht mehr
Hier ist der Vorteil von 2.5 eindeutig. Auf der Modellseite von GPT Image 2.5 ist v1/batch als unterstützt aufgeführt; für Bildausgaben über Batch fallen 15 $ statt 30 $ pro Million Token an. Auf der Modellseite von GPT Image 2.6 ist Batch als nicht unterstützt markiert, und in der Batch-Preistabelle fehlen beide 2.6-Modelle.
Wenn du Bildaufträge über Nacht laufen lässt, solltest du sie nicht auf 2.6 umstellen. Bleib entweder bei 2.5 oder teile die Arbeitslast auf: interaktive Entwürfe mit 2.6, Batch-Renderings mit 2.5. In der Bilddokumentation von AIHubMix ist kein Batch-Endpunkt aufgeführt, daher gilt diese Entscheidung nur für direkte Aufrufe an OpenAI.
Pipelines mit Responses müssen geprüft werden
OpenAIs eigene Materialien widersprechen sich bei 2.5. Im Changelog vom September wird das Bildgenerierungs-Tool der Responses API neben der Image API aufgeführt, auf der Modellseite von 2.5 ist Responses jedoch als nicht unterstützt markiert. Bei 2.6 ist die Lage klarer: Auf der Modellseite ist Responses als nicht unterstützt markiert, und im Changelog vom November sind nur v1/images/generations und v1/images/edits aufgeführt.
Wenn dein Code 2.5 über Responses aufruft, führe vor dem Ändern der Modell-ID einen Smoke-Test durch. Ein Fehler wird hier zwar deutlich gemeldet, aber nur, wenn du testest. Eine Pipeline, die unbemerkt auf ein anderes Modell zurückgreift, ist schlimmer als ein 400-Fehler.
Die neuen Steuerungsmöglichkeiten gibt es nur über die Image API
Im Leitfaden zur Bildgenerierung sind complexity, markupgesteuerte Bearbeitungen, SVG-Ausgabe und animierte GIF-Ausgabe für die Image API aufgeführt. Über das Responses-Bild-Tool ist nichts davon verfügbar; außerdem sind SVG und GIF nur für die Generierung vorgesehen: Beides funktioniert nicht mit /v1/images/edits.
Für jede Funktion gelten eigene Einschränkungen. Für SVG ist n=1 erforderlich; Streaming, Teilbilder, output_compression und prompt_rewriter werden nicht unterstützt. Für GIF werden frame_count (Standardwert 9) und frame_duration_ms (Standardwert 200) verwendet. GIF ist nur für die Generierung vorgesehen; Streaming, Teilbilder, benutzerdefiniertes output_compression und prompt_rewriter werden ebenfalls nicht unterstützt. Bei Markup-Bearbeitungen muss das Originalbild als erstes Eingabebild und zusätzlich eine separate transparente PNG-Datei mit denselben Abmessungen angegeben werden. Beide dürfen höchstens 16,777,216 Pixel haben; die Markup-Datei darf maximal 50 MB groß sein. Kombiniere markup nicht mit mask oder prompt_rewriter.
Für SVG gilt außerdem eine besondere Abrechnungsregel: Für das Referenzbild zahlst du den Tarif des Bildmodells und für die zur Erzeugung des SVG verwendeten Token den Tarif des Erstellungsmodells. Die Gesamtkosten hängen von beidem ab; die übliche Kostenschätzung pro Bild deckt das also nicht ab.
Die Angaben zu Qualität und Größe widersprechen sich
Für 2.5 dokumentiert OpenAI fünf Qualitätsstufen zusätzlich zu auto: low, medium, high, xhigh und max. Für 2.6 führt der Kostenrechner im Leitfaden dieselben fünf Stufen für beide Generationen auf. In der API-Referenz sind xhigh und max hingegen nur den 2.5-Snapshots zugeordnet, und in der Bildpreistabelle von AIHubMix – der Quelle der folgenden Kosten – sind nur low, medium, high und auto aufgeführt.
Die sicheren Werte für 2.6 sind derzeit low, medium, high und auto. Bei den Größen gilt dieselbe Vorsicht: Benutzerdefinierte Werte für WIDTHxHEIGHT sind für GPT Image 2 und 2.5 dokumentiert, während der Leitfaden für 2.6 die Größen 1024x1024, 1536x1024 und 1024x1536 empfiehlt. Verwende diese drei empfohlenen Größen, bis die Dokumentation zu 2.6 einheitlich ist.
Beim Wechsel von 1.5 kostet hohe Qualität bei 1024x1024 mehr
GPT Image 1.5 und 1-mini werden am 1. Dezember 2026 abgekündigt; als Ersatz wird 2.5 genannt. Wenn du überwiegend mit hoher Qualität und im Format 1024x1024 renderst, ist der Wechsel nicht günstig: In OpenAIs Preistabelle kostet hohe Qualität bei 1.5 0.133 $, die Schätzung von AIHubMix für 2.6 liegt bei 0.211 $ – etwa 59% mehr. Bei mittlerer Qualität steigen die Kosten von 0.034 $ auf 0.053 $, bei niedriger Qualität sinken sie dagegen von 0.009 $ auf 0.006 $. Bei 1536x1024 kostet hohe Qualität mit 1.5 0.200 $, sodass 2.6 mit 0.165 $ bei dieser Größe günstiger ist.
Teste denselben Nutzungsmix mit 2.5, bevor du 2.6 als kostengünstiger einstufst: Die Tokenpreise sind identisch. Der Unterschied zwischen den beiden 2.x-Modellen liegt also im Tokenverbrauch, nicht im Listenpreis.
2.6 über AIHubMix aufrufen
AIHubMix bietet beide 2.6-Modelle zu den offiziellen Preisen an. In der Dokumentation zur Bildgenerierung von AIHubMix wird der neuere Endpunkt beschrieben: POST https://aihubmix.com/ai/v1/images/generations. Er akzeptiert model, prompt, n, size, output_format, image, images, mask, async, extra sowie die beiden Webhook-Felder.
Wichtig ist, wo die Qualitätsstufe angegeben wird. Bei /ai/v1/images/generations gibt es kein Feld quality auf oberster Ebene; es gehört in extra:
curl -s https://aihubmix.com/ai/v1/images/generations \
-H "Authorization: Bearer $AIHUBMIX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.6-flare",
"prompt": "A minimal poster: a single ceramic coffee mug on a pale sand background, soft morning light, large empty space at the top for a headline",
"size": "1024x1024",
"n": 3,
"extra": { "quality": "low" }
}'
Die Antwort enthält eine oder mehrere Ausgabe-URLs. Sie sind nur kurzzeitig gültig – etwa 30 Minuten – und müssen mit demselben Header Authorization: Bearer $AIHUBMIX_API_KEY heruntergeladen werden:
curl -s -H "Authorization: Bearer $AIHUBMIX_API_KEY" "<output-url>" -o draft-1.png
Laut Dokumentation empfiehlt AIHubMix für neue Integrationen /ai/v1: Die OpenAI-kompatiblen Endpunkte /v1 unterstützen möglicherweise noch nicht die neuesten Modelle. In der Modellliste der älteren Bildreferenz sind gpt-image-2, gpt-image-1.5, gpt-image-1-mini und die DALL·E-Modelle enthalten, 2.6 jedoch nicht. Im Schema für einzelne Modelle ist zwar ein Eintrag für /v1/images/generations für 2.6 aufgeführt, aber /ai/v1 ist der von AIHubMix für 2.6 dokumentierte Pfad und derjenige, der asynchrone Aufgaben und Webhooks ergänzt.
Was das Schema nicht anbietet
Laut veröffentlichtem Schema von AIHubMix akzeptiert output_format für 2.6 nur die Werte png, jpeg und webp. Es gibt weder complexity, markup, frame_count noch frame_duration_ms, und auch keine SVG- oder GIF-Ausgabe über svg oder gif. Das Schema ist ohne Authentifizierung unter https://aihubmix.com/call/schema/models/gpt-image-2.6-flare/endpoints verfügbar. Prüfe es, bevor du dich darauf verlässt, dass diese Funktionen über das Gateway verfügbar sind.
Es handelt sich um eine Lücke im Schema, nicht um einen nachgewiesenen Fehler: Die Funktionen sind auf OpenAIs Seite dokumentiert, und das Gateway könnte sie später ergänzen. Solange sie nicht im Schema aufgeführt sind, solltest du für SVG-, GIF- und Markup-Aufgaben direkte Aufrufe an OpenAI einplanen.
Mit diesen Fehlern ist zu rechnen
| Status | Bedeutung | Maßnahme |
|---|---|---|
| 400 | Parameterfehler, häufig vom Anbieter weitergegeben | Prompt, Größe und n überprüfen |
| 401 | Fehlender oder ungültiger Schlüssel | Authorization-Header überprüfen |
| 402 | Unzureichendes Kontingent | Guthaben aufladen |
| 403 | Zugriff verweigert | Konto, Berechtigungen des Schlüssels und IP-Beschränkungen überprüfen |
| 429 | Rate-Limit erreicht | Warten und erneut versuchen |
| 503 | Kein Kanal kann die Anfrage bedienen | Modell-ID überprüfen und später erneut versuchen |
Die Fehlerantworten von AIHubMix enthalten eine Trace-ID tid. Bewahre sie für den Support auf und sende einen 400-Fehler nicht unverändert erneut. Das ist das Verhalten von /ai/v1; bei den älteren Endpunkten /v1 wird ein unzureichendes Kontingent stattdessen als 403 insufficient_user_quota gemeldet.
Der Ablauf: drei Entwürfe, ein finales Bild
Es soll ein Poster mit einer Produktaufnahme und einer Überschrift entstehen. Der Prompt bleibt gleich; nur Modell, Größe und Qualität ändern sich.
Schritt 1 – Entwürfe mit Flare erstellen. Eine Anfrage mit n=3 bei 1024x1024 und niedriger Qualität liefert drei Varianten. Bei geschätzten 0.006 $ pro Bild kostet dieser Schritt 0.018 $.
Schritt 2 – eine Variante auswählen. Das ist der günstige Teil des Ablaufs und derjenige, der am meisten von der Geschwindigkeit des Modells profitiert. Drei Entwürfe in einem Aufruf sind ein übliches Budget, kein Luxus.
Schritt 3 – das finale Bild mit Sunburst rendern. Die ausgewählte Komposition wird mit einem neuen Prompt bei 1536x1024 und hoher Qualität gerendert. Bei geschätzten 0.165 $ pro Bild ist dies der teuerste Schritt: Ein finales Bild kostet etwa 28-mal so viel wie ein Entwurfsbild beziehungsweise etwa neunmal so viel wie die drei Entwürfe zusammen.
curl -s https://aihubmix.com/ai/v1/images/generations \
-H "Authorization: Bearer $AIHUBMIX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.6-sunburst",
"prompt": "A minimal poster: a single ceramic coffee mug on a pale sand background, soft morning light, large empty space at the top for a headline. Refined studio product photography, subtle shadow, no text",
"size": "1536x1024",
"n": 1,
"extra": { "quality": "high" }
}'
Schritt 4 – Gesamtkosten berechnen. Geschätzte 0.018 $ für die Entwürfe plus 0.165 $ für das finale Bild ergeben 0.183 $ für vier ausgegebene Bilder. Wird das finale Bild stattdessen mit mittlerer Qualität gerendert, kostet es 0.041 $ und der gesamte Durchlauf 0.059 $. Texteingaben kosten bei Prompts dieser Länge nur einen Bruchteil eines Cents; bei einer Bearbeitung kommen Bildeingabe-Token zu 8 $ pro Million hinzu.
Daran sieht man, dass es keinen Kostenunterschied zwischen den beiden Modellen gibt: Dieselben vier Bilder kosten mit 2.5 genauso viel, denn die Schätzungen von AIHubMix pro Bild sind identisch. Der Grund für 2.6 ist die schnellere Entwurfsschleife und die Möglichkeit, SVG- oder GIF-Aufgaben später zu OpenAI zu verlagern – nicht eine niedrigere Rechnung.
Migrations-Checkliste
- Ersetze
gpt-image-2.5-sunburstundgpt-image-2.5-flaredort durch die 2.6-IDs, wo du das neue Modell verwenden möchtest; Batch-Aufträge bleiben bei 2.5. - Prüfe, ob eine Pipeline das Responses-Bild-Tool verwendet; für 2.6 ist nur die Image API dokumentiert.
- Beschränke die Qualitätsstufe auf
low,medium,highoderautound die Größen auf die drei empfohlenen Werte, bis die Dokumentation zu 2.6 vereinheitlicht ist. - Bei AIHubMix unter
/ai/v1gibst du die Qualität inextraan. Verwende für 2.6/ai/v1– diesen Pfad empfiehlt AIHubMix für neue Integrationen. - Lade die Ausgabe-URLs innerhalb von 30 Minuten mit dem Bearer-Header herunter.
- Gehe nicht davon aus, dass
complexity, Markup, SVG oder GIF über AIHubMix funktionieren, solange sie nicht im Schema aufgeführt sind. - Wenn du noch 1.5 verwendest, plane die Abkündigung am December 1 ein und prüfe die Kosten für hohe Qualität erneut.
FAQ
Muss ich für GPT Image 2.6 den Endpunkt ändern?
Bei der OpenAI-API nicht. Sie verwendet v1/images/generations und v1/images/edits wie 2.5; nur die Modell-ID ändert sich. Bei AIHubMix verwendest du wie oben beschrieben /ai/v1/images/generations.
Ist GPT Image 2.6 günstiger als 2.5?
Nein. Die Token-Preise sind identisch: $5 pro Million Text-Eingabe-Tokens, $8 pro Million Bild-Eingabe-Tokens und $30 pro Million Bild-Ausgabe-Tokens.
Warum kann ich Batch mit GPT Image 2.6 nicht verwenden?
Auf den OpenAI-Modellseiten ist Batch für 2.6 als nicht unterstützt gekennzeichnet, und in der Batch-Preistabelle ist 2.5, aber nicht 2.6 aufgeführt. Batch ist der deutlichste Anwendungsfall, in dem 2.5 weiterhin die bessere Wahl ist.
Wie stelle ich die Qualität bei AIHubMix ein?
Für 2.6 gibst du sie unter /ai/v1/images/generations in extra.quality an. Der OpenAI-kompatible Endpunkt /v1/images/generations hat ein Feld quality auf oberster Ebene, aber AIHubMix empfiehlt /ai/v1 für neue Integrationen. Verwende für 2.6 /ai/v1.
Kann ich über AIHubMix SVG oder GIF generieren?
Laut dem aktuellen Schema nicht: Es führt png, jpeg und webp auf, aber keine Parameter für complexity, Markup oder Bildanzahl und auch keine SVG-/GIF-Ausgabe. Diese Funktionen sind für die Image API von OpenAI dokumentiert. Prüfe das Schema, bevor du dich darauf verlässt, dass sie über das Gateway verfügbar sind.
Wie lange sind Ausgabe-URLs von AIHubMix gültig?
Etwa 30 Minuten. Lade sie mit demselben Bearer-Token herunter und speichere die Datei selbst.
Was passiert mit GPT Image 1.5?
Das Modell wird am December 1, 2026 abgekündigt. OpenAI nennt 2.5 als Ersatz, aber bei 1024x1024 in hoher Qualität kostet 2.6 pro Bild mehr als 1.5, bei 1536x1024 dagegen weniger.
Weiterlesen: die GPT Image 2.6-Reihe
Der Vergleichsartikel behandelt die Preisübersichten, die Geschwindigkeitsangabe und die Bereiche, in denen 2.5 weiterhin die Nase vorn hat. Er ist der richtige Einstieg, wenn du noch nicht entschieden hast, ob du wechseln möchtest.
GPT Image 2.6 vs. 2.5: Lohnt sich das Upgrade?
