GPT Image 2: Umfassende Anleitung
Stand 2026-10-20 ist GPT Image 2 (gpt-image-2) OpenAIs am 21. April 2026 veröffentlichtes Modell für Bildgenerierung und -bearbeitung mit flexiblen Größen und hochgenauer Bildeingabe. Die offizielle Abrechnung erfolgt pro Bild-Token: $8 Bildeingabe / $2 gecachte Eingabe / $30 Bildausgabe pro 1 Mio. Tokens, im Batch $4 / $1 / $15. Bei QCode wird pro ausgegebenem Bild abgerechnet: $0.30, für generations und edits gleich; das ist eine andere Basis als die offiziellen Bild-Token-Preise.
Was ist GPT Image 2
GPT Image 2 ist ein Modell für Bildgenerierung und -bearbeitung, das OpenAI am 21. April 2026 veröffentlicht hat; Modell-ID gpt-image-2, Standard-Snapshot gpt-image-2-2026-04-21. Laut OpenAI unterstützt es flexible Bildgrößen und hochgenaue Bildeingaben und wird über die Endpunkte generations und edits der Images API aufgerufen. DALL·E 2 und DALL·E 3 wurden am 12. Mai 2026 aus der API entfernt; OpenAI empfiehlt stattdessen Modelle wie gpt-image-2. Stand 2026-10-20 sind außerdem die Nachfolger GPT Image 2.5 Sunburst und Flare vom 8. September 2026 verfügbar; der offizielle Leitfaden empfiehlt die 2.5-Serie für neue Integrationen.
Wichtige Fähigkeiten
Text-zu-Bild, Bild-zu-Bild, Inpainting, Text im Bild, mehrere Auflösungen (1024x1024 / 1024x1536 / 1536x1024, im offiziellen API bis 4K) und Qualitätsstufen (low / medium / high / auto). OpenAI rechnet pro Bild-Token ab; Größe, Qualität und Anzahl der Eingabebilder verändern die Tokenzahl und damit die Gesamtkosten.
Abrechnung: $0.30 pro Bild
GPT Image 2 wird pro ausgegebenem Bild abgerechnet, für generations und edits zum gleichen Satz: $0.30 pro Bild, n Bilder kosten also n × $0.30. size, quality, die Anzahl der Eingabebilder, mask und Prompt-Länge haben keinen Einfluss auf den Preis. Fehlgeschlagene Anfragen (4xx einschließlich Ablehnungen durch die Moderation, 5xx, Timeouts, Trennungen der Clientverbindung) werden nie berechnet. Seit dem 2026-10-06 wird statt der Token-Abrechnung ein fester Preis von $0.30 pro Bild berechnet.
- Pro ausgegebenem Bild — $0.30
- size / quality / Eingabebilder / mask / Prompt-Länge haben keinen Einfluss auf den Preis
- Fehlgeschlagene Anfragen (4xx / 5xx / Timeouts / Client-Trennungen) werden nie berechnet
Der Preis ist unabhängig von size / quality und von der Anzahl der Eingabebilder – maßgeblich ist nur die Zahl der ausgegebenen Bilder.
Zugriff über QCode
GPT Image 2 ist im /models-Katalog gelistet; um zu prüfen, ob es aktuell aufrufbar ist, kontrollieren Sie den /models-Katalog und die Statusseite statt des Wortlauts einer statischen Seite. Berechnet wird pro ausgegebenem Bild zu $0.30, für generations und edits gleich. Das QCode-Plan-Kontingent deckt mehrere CLI-Tools ab, etwa Claude Code und OpenAI Codex.
generations und edits kosten gleich; n Bilder = n × $0.30.
4xx (einschließlich Moderations-Ablehnungen) / 5xx / Timeouts / Trennungen der Clientverbindung werden nicht berechnet.
API-Einrichtungsbeispiel
Nutzen Sie die OpenAI-kompatible API. Setzen Sie die BASE_URL einfach auf den QCode-Endpunkt und verwenden Sie den QCode-Key als API-Key – alles andere bleibt identisch zum offiziellen SDK.
from openai import OpenAI
import base64
# Hinweis: Bildgenerierung verwendet den dedizierten Endpunkt /qcode-img/v1 (getrennt vom Text-Endpunkt /openai/v1)
client = OpenAI(
api_key="$QCODE_KEY",
base_url="https://api.qcode.cc/qcode-img/v1",
timeout=180.0, # OpenAI SDK default is short, recommend 180s
)
response = client.images.generate(
model="gpt-image-2",
prompt="A serene Japanese garden with a koi pond",
size="1024x1024",
quality="medium",
)
img = base64.b64decode(response.data[0].b64_json) # Es wird nur b64_json zurückgegeben; response_format=url wird mit 400 abgelehnt
open("out.png", "wb").write(img)
# Vollständiger Endpunktpfad: POST https://api.qcode.cc/qcode-img/v1/images/generations
Anwendungsfälle
Marketingmaterial, Social-Media-Plakate, E-Commerce-Produktfotos, Buchillustrationen, Konzeptentwürfe, Foliengrafiken, UI-Mockups, Prototypen-Designs. Für lokale Änderungen nutzen Sie den Endpunkt edits mit einer Maske oder kombinieren mehrere Referenzbilder zu einem neuen Bild.
Umstieg von DALL·E 3 und Vergleich mit Midjourney / Stable Diffusion
DALL·E 3: Laut offiziellem OpenAI-Changelog wurden dall-e-2 und dall-e-3 am 12. Mai 2026 aus der API entfernt, empfohlen wurden Modelle wie gpt-image-2; Integrationen, die noch DALL·E 3 aufrufen, müssen umziehen. Gegenüber Midjourney: API-first-Design eignet sich für programmatische Integration; Midjourney ist eher ein Discord-Creator-Workflow. Gegenüber Stable Diffusion: Closed-Source, aber stabilere Qualität und Kontrollierbarkeit, keine selbst gehostete GPU erforderlich. Stand 2026-10-15 empfiehlt der offizielle OpenAI-Leitfaden für neue Integrationen die GPT-Image-2.5-Modelle; wählen Sie zwischen gpt-image-2 und den 2.5-Modellen nach Qualität, Größe und Bearbeitungsbedarf.
QCode unterstützt auch OpenAI Codex / GPT-5.6
Ihr QCode-Kontingent funktioniert über Claude Code und OpenAI Codex CLI hinweg — ein gemeinsames Guthaben, keine doppelten Kosten.
FAQ
Kann ich DALL·E 3 noch nutzen, oder sollte ich zu GPT Image 2 wechseln?
In der OpenAI-API nicht mehr: Laut offiziellem Changelog wurden dall-e-2 und dall-e-3 am 12. Mai 2026 aus der API entfernt, OpenAI empfahl stattdessen gpt-image-2, gpt-image-1 oder gpt-image-1-mini. gpt-image-2 unterstützt flexible Größen und Eingabebilder in hoher Treue und kann über den Endpunkt edits lokale Änderungen vornehmen; laut Deprecations-Seite von OpenAI soll gpt-image-1 am 23. Oktober 2026 abgeschaltet werden, Ersatz sind die GPT-Image-2.5-Modelle (Stand 2026-10-15).
Wie wird GPT Image 2 abgerechnet?
Pro ausgegebenem Bild: $0.30 jedes. generations und edits kosten gleich viel, n Bilder = n × $0.30. size, quality, Anzahl der Eingabebilder, mask und Prompt-Länge beeinflussen den Preis nicht, und fehlgeschlagene Anfragen werden nie berechnet. Der offizielle OpenAI-Preis ist eine eigene Basis: pro Bild-Token, $8 Bildeingabe, $2 gecachte Eingabe und $30 Ausgabe pro 1 Mio. Tokens; im Batch $4 / $1 / $15 (offizielle Preisliste, 2026-10-20).
Wie verbinde ich mich aus Festlandchina mit GPT Image 2?
Die QCode-Dokumentation nennt https://api.qcode.cc/qcode-img/v1 als Standard für Festlandchina, https://asia.qcode.cc/qcode-img/v1 für Hongkong und Südostasien sowie https://us.qcode.cc/qcode-img/v1 (Los Angeles) für Nordamerika und Europa. gpt-image-2 ist im /models-Katalog gelistet; die aktuelle Verfügbarkeit richtet sich nach dem /models-Katalog und der Statusseite – diese Seite gibt keine Echtzeit-Zusage.
Kann das Kontingent meines QCode-Plans für GPT Image 2 genutzt werden?
Das QCode-Plan-Kontingent funktioniert über mehrere CLI-Tools hinweg (Claude Code, OpenAI Codex usw.) mit einem einzigen API-Key. gpt-image-2 ist im /models-Katalog gelistet – prüfen Sie /models und die Statusseite zur Verfügbarkeit; Bildanfragen zählen mit $0.30 pro Bild zur dailyCostLimit.
gpt-image-2 in der Praxis: Spezifikationen, Anbindung, Bearbeitung und Fehler
Die offiziellen Spezifikationen von gpt-image-2 im Überblick
Stand 2026-10-15 nennt der offizielle Changelog von OpenAI den 21. April 2026 als Veröffentlichungsdatum von GPT Image 2; die Modell-ID ist gpt-image-2, der Standard-Snapshot gpt-image-2-2026-04-21. In der Endpunkt-Tabelle der offiziellen Modellseite sind Bildgenerierung (v1/images/generations), Bildbearbeitung (v1/images/edits) und Batch (v1/batch) als unterstützt markiert; Eingaben können Text und Bilder sein, die Ausgabe ist ein Bild.
Als gängige Größen nennt OpenAI 1024x1024, 1536x1024, 1024x1536, 2048x2048, 2048x1152, 3840x2160, 2160x3840 sowie den Standardwert auto. Eigene Größen müssen alle Bedingungen erfüllen: Die längste Kante misst höchstens 3840px, beide Kanten sind Vielfache von 16px, das Verhältnis von langer zu kurzer Kante liegt bei höchstens 3:1, und die Gesamtpixelzahl liegt zwischen 655.360 und 8.294.400. Für quality stehen low, medium, high und der Standard auto zur Wahl.
- Ausgabeformat: Die Image API liefert base64-kodierte Bilddaten, standardmäßig als png, auf Wunsch als jpeg oder webp; bei jpeg und webp steuert output_compression (0–100) die Kompression.
- Eingabetreue: Laut OpenAI verarbeitet gpt-image-2 jedes Eingabebild automatisch mit hoher Treue und erlaubt keine Änderung von input_fidelity; lassen Sie diesen Parameter daher einfach weg.
- Transparenter Hintergrund: Laut offiziellem Changelog unterstützt gpt-image-2 seit dem 20. August 2026 background=transparent als Vorschau, zusammen mit png- oder webp-Ausgabe; jpeg unterstützt keine Transparenz.
- Laufzeit: Im Abschnitt zu den Einschränkungen schreibt OpenAI, dass komplexe Prompts bis zu 2 Minuten dauern können.
- Moderation: Alle Prompts und erzeugten Bilder werden nach der Inhaltsrichtlinie von OpenAI gefiltert; der Parameter moderation akzeptiert auto (Standard) oder low.
gpt-image-2 über QCode aufrufen: drei Schritte
Die QCode-Dokumentation beschreibt einen eigenen Bildpfad, dessen Anfragen und Antworten dem Format der OpenAI Images API entsprechen: Sie behalten das offizielle OpenAI-SDK, setzen base_url auf https://api.qcode.cc/qcode-img/v1, verwenden Ihren QCode-API-Key als api_key und gpt-image-2 als Modellnamen; der restliche Code bleibt gleich. Ob der Aufruf gerade möglich ist, entnehmen Sie dem /models-Katalog und der Statusseite.
Wenn Sie es vor dem ersten Code ausprobieren möchten, verweist die QCode-Dokumentation auf einen Online-Playground unter https://api.qcode.cc/qcode-img/: API-Key und Prompt eingeben und Generierung sowie Bearbeitung direkt im Browser testen.
- Schritt 1: Registrieren Sie sich bei QCode und erstellen Sie im Dashboard einen API-Key (beginnt mit cr_); derselbe Key funktioniert auch für Claude Code, Codex und andere Tools.
- Schritt 2: Die Anfrage schreiben Sie wie bei OpenAI. Setzen Sie model auf gpt-image-2; n erlaubt 1 bis 4 Bilder pro Aufruf, Werte über 4 liefern einen 400-Fehler, statt still gekürzt zu werden; ohne size und quality verwendet der Generierungs-Endpunkt standardmäßig 1024x1024 und medium. Die tatsächliche Größe des zurückgegebenen Bildes weicht gelegentlich von der angeforderten size ab – maßgeblich ist das Bild selbst.
- Schritt 3: Setzen Sie das Client-Timeout ausdrücklich auf 180 Sekunden oder mehr. Die QCode-Dokumentation weist darauf hin, dass der Standardwert des OpenAI-SDK zu kurz ist; liegt ein eigener Reverse Proxy oder ein Gateway dazwischen, braucht auch dessen Lese-Timeout mindestens 180 Sekunden.
- Ergebnis auslesen: data[0].b64_json in der Antwort ist das Bild in base64; dekodieren und als Datei speichern. revised_prompt ist der vom Modell umformulierte Prompt und kann bei Bedarf angezeigt werden.
- Standardlimits: Laut QCode-Dokumentation gelten pro API-Key 100 Bilder pro Tag und höchstens 2 gleichzeitig laufende Anfragen, gemeinsam für generations und edits; für höhere Limits wenden Sie sich an den Support.
Bilder mit edits bearbeiten: Teilbereiche neu zeichnen und Bilder kombinieren
Bearbeitungsanfragen gehen an POST /qcode-img/v1/images/edits und müssen Dateien als multipart/form-data hochladen, nicht als JSON. Laut QCode-Dokumentation sind pro Anfrage 1 bis 8 Ausgangsbilder (PNG, JPEG oder WebP) möglich, wobei das Feld image für jedes Bild wiederholt wird; die optionale mask ist ein PNG mit Alphakanal, dessen transparenter Bereich neu gezeichnet wird.
Der offizielle OpenAI-Leitfaden verlangt, dass Bild und mask dasselbe Format und dieselbe Größe haben und kleiner als 50MB sind und dass die mask einen Alphakanal enthält. Außerdem erklärt OpenAI, dass die Bearbeitung mit Maske bei GPT Image vollständig promptbasiert ist: Das Modell nutzt die Maske als Orientierung und folgt ihrer Form nicht unbedingt exakt; bei mehreren Eingabebildern gilt die Maske für das erste.
- Die Maske legt fest, wo geändert wird, der Prompt, was daraus werden soll. Ohne Maske kann jeder Teil des Bildes gemäß Prompt neu gezeichnet werden.
- Beim Kombinieren mehrerer Bilder beschreiben Sie im Prompt die Rolle jedes Bildes, etwa: Das erste ist die Szene, das zweite das Produkt, das darin platziert werden soll.
- Upload-Größe: Laut QCode-Dokumentation sind pro Datei höchstens 25 MB und für alle Dateien zusammen höchstens 50 MB erlaubt; darüber kommt 413 image_too_large zurück.
- input_fidelity müssen Sie nicht senden: gpt-image-2 verarbeitet Eingabebilder stets mit hoher Treue, QCode ignoriert low und high und beantwortet andere Werte mit 400.
Häufige Fehler und was zu tun ist
Fehler der QCode-Bildendpunkte folgen dem Standardschema von OpenAI (error.type, error.code, error.message); werten Sie also HTTP-Status und code aus.
- 400 unsupported_response_format: Sie haben response_format=url gesendet. Dieser Endpunkt liefert nur b64_json.
- 400 unsupported_background: Sie haben background=transparent gesendet. Die offizielle OpenAI-API unterstützt transparente Hintergründe als Vorschau, laut QCode-Dokumentation (Stand 2026-10-15) akzeptiert /qcode-img/v1 jedoch nur auto und opaque.
- 400 stream_not_supported: Sie haben stream=true oder partial_images gesendet; eine schrittweise Ausgabe wird noch nicht unterstützt.
- 422 unsupported_size: size ist nicht auto, 1024x1024, 1024x1536, 1536x1024 oder 2048x2048; eigene Größen wie 4K, die die offizielle API akzeptiert, werden an diesem Endpunkt nicht angeboten.
- 429 image_daily_limit oder concurrency_exhausted: Das Tageslimit an Bildern oder das Parallelitätslimit pro Key ist erreicht; warten Sie die Zeit aus dem Header Retry-After ab und versuchen Sie es erneut.
- 503 image_provider_unavailable, 504 oder ein Client-Timeout: Wiederholen Sie mit exponentiellem Backoff gemäß Retry-After (die Dokumentation empfiehlt, mit 30 Sekunden zu beginnen, höchstens 3 Versuche); treten Timeouts immer wieder auf, kürzen Sie den Prompt oder senden Sie weniger Eingabebilder.
Weitere Fragen zu gpt-image-2
Wann wurde gpt-image-2 veröffentlicht?
Laut offiziellem Changelog von OpenAI wurde GPT Image 2 am 21. April 2026 veröffentlicht, der Standard-Snapshot ist gpt-image-2-2026-04-21. Am 8. September 2026 folgten GPT Image 2.5 Sunburst und GPT Image 2.5 Flare (Stand 2026-10-15).
Welche Größen und Qualitätsstufen unterstützt gpt-image-2?
In der offiziellen OpenAI-API sind gängige Größen 1024x1024, 1536x1024, 1024x1536, 2048x2048, 2048x1152, 3840x2160, 2160x3840 und auto, die Qualität ist low, medium, high oder auto. Über /qcode-img/v1 bei QCode sind für size auto, 1024x1024, 1024x1536, 1536x1024 und 2048x2048 möglich, für quality low, medium und high; andere Größen ergeben 422.
Kann gpt-image-2 eine Bild-URL zurückgeben?
Nein. Die offizielle Image API liefert base64-kodierte Bilddaten, und auch der QCode-Endpunkt gibt nur b64_json zurück; response_format=url ergibt 400. Dekodieren Sie b64_json und speichern Sie es als Datei, oder zeigen Sie das Bild auf einer Webseite als data URL an.
Kann gpt-image-2 PNGs mit transparentem Hintergrund erzeugen?
In der offiziellen OpenAI-API ja: Laut Changelog unterstützt gpt-image-2 seit dem 20. August 2026 background=transparent als Vorschau, mit png- oder webp-Ausgabe. Über /qcode-img/v1 bei QCode ist das Stand 2026-10-15 nicht möglich: transparent ergibt 400, für background sind nur auto und opaque erlaubt.
Was tun, wenn Anfragen an gpt-image-2 ständig in ein Timeout laufen?
Erhöhen Sie zuerst das Client-Timeout auf 180 Sekunden oder mehr. OpenAI weist darauf hin, dass komplexe Prompts bis zu 2 Minuten dauern können, und die QCode-Dokumentation verlangt ein ausdrücklich gesetztes SDK-timeout von mindestens 180 Sekunden, auch für das Lese-Timeout eines dazwischenliegenden Reverse Proxy. Ein 504 oder Client-Timeout kann direkt wiederholt werden; tritt es immer wieder auf, kürzen Sie den Prompt oder senden Sie weniger Eingabebilder.
Worin unterscheidet sich gpt-image-2 von GPT Image 2.5?
Laut dem offiziellen Bildgenerierungs-Leitfaden von OpenAI (Stand 2026-10-20) bieten GPT Image 2.5 Sunburst und Flare zusätzlich die Qualitätsstufen xhigh und max, während gpt-image-2 bis high reicht. OpenAI empfiehlt die 2.5-Serie für neue Integrationen: Sunburst für Bearbeitungspräzision, Flare für schnelle, hochwertige Alltagsgenerierung. Welche Bildmodelle QCode aufrufen kann und wie sie abgerechnet werden, steht auf /models.
Wie bezahle ich und starte mit QCode für gpt-image-2?
Registrieren Sie sich bei QCode, laden Sie das Guthaben auf, wählen Sie einen Tarif und erstellen Sie im Dashboard einen API-Key. In CNY zahlen Sie per Alipay oder WeChat Pay, in USD per Visa-/Mastercard-Kreditkarte, Apple Pay oder Google Pay; auch Krypto wird über viele Coins und Netzwerke akzeptiert. Eine ausländische Kreditkarte ist nicht nötig, alles läuft selbstbedient. Kein Monatsplan? «Nutzungspakete» starten bei $4 für ein einmaliges Kontingent, das Sie innerhalb von 7 Tagen aufbrauchen. Wenn Sie bereits einen Privatplan haben und mehr Kontingent brauchen, buchen Sie ein Booster-Paket dazu. gpt-image-2 wird pro ausgegebenem Bild mit $0.30 abgerechnet; Details auf /models.
Mehr über GPT Image 2 erfahren
QCode-Pläne teilen das Kontingent über mehrere CLIs hinweg – flexibles Abo