Skip to Content
ModelleGPT ImageÜberblick

GPT-Image-Reihe

Die Bildgenerierungsmodelle von OpenAI: gpt-image-2.5-flare, gpt-image-2.5-sunburst und gpt-image-2. Alle drei werden über die OpenAI-kompatible API aufgerufen.

Alle Angaben auf diesen Seiten wurden gegen die Live-API gemessen, und jedes Codebeispiel wurde unverändert ausgeführt. Zuletzt überprüft: 2026-09-30.

Was möchten Sie tun?

Text zu Bild Ein Bild aus einem Text-Prompt generieren.Bilder bearbeiten und kombinieren Ein oder mehrere Bilder hochladen und per Prompt verändern oder zusammenführen.Inpainting Einen Bereich mit einer Maske markieren und nur diesen Bereich neu malen.Bilder in Ihren eigenen Tools generieren Ohne Code. Einige Einstellungen in Cherry Studio oder LobeHub ausfüllen oder einen Prompt in Claude Code oder Codex kopieren.

Die gemeinsame Anfragestruktur und die Antwortfelder dieser Endpunkte finden Sie unter Images API.

Welches Modell verwenden

gpt-image-2.5-flareText zu Bild
  • Alltägliche und Batch-Generierung; schnell
  • 6 Qualitätsstufen: low bis max
Azure · OpenAI
gpt-image-2.5-sunburstBearbeitung
  • Bilder bearbeiten und kombinieren; höhere Detailtreue
  • 6 Qualitätsstufen: low bis max
Azure · OpenAI
gpt-image-2Vorherige Generation
  • Für bestehende Projekte geeignet
  • 4 Qualitätsstufen; kein xhigh oder max
Azure · OpenAI

Wählen Sie beim Wechsel von gpt-image-2 zu 2.5 die Qualitätsstufe neu — siehe Qualität und Preis weiter unten. Beide Anbieter stellen Text zu Bild und Bearbeitung bereit, und das Gateway leitet Anfragen automatisch weiter.

Modell-IDs (exakt kopieren)
Text zu Bildopenai/gpt-image-2.5-flareAlltägliche und Batch-Generierung; schnell
Bearbeitungopenai/gpt-image-2.5-sunburstBilder bearbeiten und kombinieren; höhere Detailtreue
Vorherige Generationopenai/gpt-image-2Keine Stufen xhigh oder max

Qualität (quality) und Preis

quality hat den größten Einfluss auf den Preis. Höhere Stufen kosten mehr und dauern länger.

Offizielle Referenzpreise von OpenAI (pro Bild, nur das Ausgabebild; Prompt und Referenzbilder nicht enthalten):

Stufegpt-image-2 · 1024×1024gpt-image-2 · 1024×1536 oder 1536×1024
low$0.006$0.005
medium$0.053$0.041
high$0.211$0.165

Für die beiden 2.5-Modelle hat OpenAI keine Preistabelle pro Bild veröffentlicht. Stattdessen gibt es Stückpreise: $30 pro Million Ausgabe-Bild-Tokens, $8 pro Million Eingabe-Tokens für Referenzbilder und $5 pro Million Text-Eingabe-Tokens. Das Rechenbeispiel von OpenAI: Ein Bild mit 1024×1024 bei low erzeugt 196 Ausgabe-Tokens, also etwa $0.00588. Für andere Stufen und Größen schätzen Sie die Kosten mit dem offiziellen Rechner .

Dies sind die offiziellen Angaben von OpenAI; abgerechnet wird nach usage in jeder Antwort. Die aktuellen Preise bei OfoxAI (einschließlich Rabatten) finden Sie auf der Modellseite .

Von den Modellen unterstützte Stufen:

Stufe2.5 (flare, sunburst)gpt-image-2
low / medium / highUnterstütztUnterstützt
xhigh / maxUnterstütztNicht unterstützt; liefert 400
auto oder weggelassenDas Modell entscheidet — nicht dasselbe wie medium; legen Sie die Stufe explizit festEbenso

standard und hd (alte DALL·E-Werte) werden nicht unterstützt und liefern 400.

Latenz und Timeouts (timeout)

Die API ist synchron: Die Antwort wird erst zurückgegeben, wenn das Bild generiert ist. Trennt der Client die Verbindung vorzeitig, geht das Bild verloren, die Anfrage wird aber trotzdem abgerechnet.

Anfrage gesendetGenerierung — kann mehrere Minuten dauernBild zurückgegeben
60 / 120 s übliche Standardwerte: Die Verbindung bricht während der Generierung ab, das Bild geht verloren und wird trotzdem abgerechnet
600 s empfohlen: wartet, bis das Bild zurückgegeben wird

Setzen Sie das Client-Timeout auf 600 Sekunden. Die Latenz hängt von Modell, Qualität und Größe ab; Anfragen mit hoher Qualität, großen Formaten und Bearbeitungen können mehrere Minuten dauern, und übliche Standard-Timeouts von 60 oder 120 Sekunden reichen nicht aus.

Größe (size)

size akzeptiert ein benutzerdefiniertes WIDTHxHEIGHT, sofern alle vier folgenden Regeln erfüllt sind; ein Verstoß gegen eine davon liefert 400.

Vielfache von 16
  • Breite und Höhe jeweils durch 16 teilbar
✗ 1000x1000
Längste Kante ≤ 3840
  • Keine Seite größer als 3840
✗ 4096x4096
Seitenverhältnis ≤ 3:1
  • Zwischen 1:3 und 3:1
✗ 3200x1024
Pixel ≥ 655.360
  • Insgesamt mindestens 655.360 Pixel
✗ 768x768 → ✓ 1024x768

Weggelassen oder auto: Das Modell wählt die Größe. Es ist nicht garantiert, dass sie 1024×1024 beträgt oder Ihrem Referenzbild entspricht. In unseren Tests lieferten sowohl Text zu Bild als auch Bearbeitung 1254×1254. Geben Sie eine Größe explizit an, wenn Sie eine feste Größe benötigen.

Das dokumentierte Maximum ist 3840×2160; alles über 2560×1440 ist als experimentell gekennzeichnet.

Technische Daten

PunktAngabe
AntwortSynchron; das Bild steht als reines Base64 in data[0].b64_json
AusgabegrößeBenutzerdefinierte Breite und Höhe innerhalb der vier Beschränkungen; bis zu 3840×2160
QualitätsstufenSiehe Qualität und Preis
Ausgabeformatpng (Standard), jpeg, webp
Bilder pro Anfrage1–10, Standard 1
Referenzbilder≤ 15 MB pro Bild, ≤ 50 MB pro Anfrage — siehe Upload-Grenzen
TimeoutSetzen Sie das Client-Timeout auf 600 Sekunden — siehe Latenz und Timeouts

Anbieter auswählen

In der Regel ist das nicht nötig. Wählen Sie einen Anbieter, wenn Sie Anforderungen an die Inhaltsmoderation haben: Die Anbieter wenden unterschiedliche Moderationsschwellen an; gpt-image-2 ist beispielsweise bei Azure strenger und bei OpenAI vergleichsweise großzügig.

Nicht ausgewählt (empfohlen)
Anfrage→OfoxAI-Gateway→AzureOpenAI

Das Gateway wählt automatisch einen verfügbaren Anbieter zwischen Azure und OpenAI.

Anbieter ausgewählt
Anfrageopenai→OfoxAI-Gateway→AzureOpenAI

Anfragen gehen nur an diesen Anbieter; ist er nicht verfügbar, wird nicht auf einen anderen Anbieter ausgewichen.

So wählen Sie einen Anbieter aus
HeaderX-OfoxAI-Provider-Type: openaiFunktioniert bei Text zu Bild und bei Bearbeitung; Werte: azure_foundry, openai
Anfragekörper"extra_body": { "provider": { "type": "openai" } }Nur Text zu Bild; die Bearbeitung ist ein Multipart-Upload und akzeptiert nur den Header

Alle Details: Provider-Routing.

Häufige Fehler

FehlerUrsacheLösung
moderation_blocked (Your request was rejected by the safety system)Prompt oder Referenzbild wurde vom Sicherheitssystem des Upstream-Anbieters blockiertÄndern Sie Prompt oder Referenzbild und versuchen Sie es erneut; eine unveränderte Wiederholung führt zum selben Ergebnis. Bei Moderationsanforderungen kommt die Auswahl eines Anbieters in Betracht
Timeout, 504, 524, Request timed outClient oder ein Zwischen-Proxy (Nginx, Vercel, Cloudflare usw.) läuft in ein Timeout, bevor die Generierung abgeschlossen istSetzen Sie die Timeouts von Client und Proxy auf 600 Sekunden — siehe Latenz und Timeouts
404 model_not_foundModell-ID falsch geschrieben oder falsche Groß-/Kleinschreibung, z. B. GPT-Image-2Kopieren Sie die Modell-ID von dieser Seite, durchgehend kleingeschrieben
provider_type_unavailableDer manuell festgelegte Anbieter stellt dieses Modell nicht bereitEntfernen Sie den Anbieterparameter und überlassen Sie das Routing dem Gateway
unknown provider typeAnbietername im Header falsch geschriebenPrüfen Sie die Schreibweise
Invalid sizeDie Größe verstößt gegen eine der vier RegelnSiehe Größe
does not support quality 'xhigh'xhigh oder max an gpt-image-2 gesendetVerwenden Sie high oder wechseln Sie zu 2.5
Invalid value: 'standard'quality auf standard oder hd gesetztVerwenden Sie low bis max
Invalid image file or modeReferenzbild oder Maske hat das falsche FormatErneut als Standard-PNG oder -JPEG exportieren
Invalid file 'image[0]': unsupported mimetypeDie hochgeladene Datei ist kein BildLaden Sie ein PNG-, JPEG- oder WebP-Bild hoch
does not support the 'input_fidelity' parameterEine Bearbeitungsanfrage enthielt input_fidelityEntfernen Sie den Parameter. Die 2.5-Modelle und gpt-image-2 verarbeiten Referenzbilder stets mit hoher Detailtreue
Transparent background is not supported for JPEG output formatTransparenter Hintergrund mit Ausgabeformat jpeg angefordertVerwenden Sie png oder webp
Unknown parameterParameter wird von dieser Reihe nicht unterstütztEntfernen Sie ihn
429 rate_limit_exceededMehr als 100 Anfragen pro Minute (pro Team)Später erneut versuchen. Zusätzliche Schlüssel erhöhen das Limit nicht

Vollständige Fehlerreferenz: Fehlerbehandlung.

Genaue Fehlermeldungen

Die vollständigen gemessenen Meldungen, damit Sie danach suchen oder sie vergleichen können:

Invalid size '1000x1000'. Width and height must both be divisible by 16.
Invalid size '4096x4096'. The longest edge must be less than or equal to 3840.
Invalid size '3200x1024'. The maximum supported aspect ratio is 3:1.
Invalid size '768x768'. Requested resolution is below the current minimum pixel budget.
The model 'gpt-image-2' does not support quality 'xhigh'.
Invalid value: 'standard'. Supported values are: 'low', 'medium', 'high', and 'auto'.
Invalid 'n': integer above maximum value. Expected a value <= 10, but got 11 instead.
Unknown parameter: 'style'.
The model 'gpt-image-2.5-sunburst' does not support the 'input_fidelity' parameter.
Transparent background is not supported for JPEG output format
Invalid file 'image[0]': unsupported mimetype ('text/plain; charset=utf-8'). Supported file formats are 'image/jpeg', 'image/png', and 'image/webp'.
unknown provider type in X-OfoxAI-Provider-Type header
Model 'GPT-Image-2' not found
Invalid image file or mode for image 1

Beachten Sie, dass die Liste der unterstützten Werte in Invalid value: 'standard' unvollständig ist: Die 2.5-Modelle akzeptieren zusätzlich xhigh und max. Maßgeblich ist die Stufentabelle auf dieser Seite.

Parameter ohne Wirkung

Diese Parameter verursachen keinen Fehler, bewirken bei dieser Reihe aber nichts. Die Anfrage ist erfolgreich und wird regulär abgerechnet:

ParameterGrund
mask (bei Text zu Bild)Wirkt nur am Bearbeitungs-Endpunkt
response_formatAlter DALL·E-Parameter; diese Reihe liefert stets Base64 (b64_json). Ein direkter Aufruf bei OpenAI liefert Unknown parameter: 'response_format'; über OfoxAI wird er ignoriert
input_fidelity (bei Text zu Bild)Gehört zu gpt-image-1.5. Hinweis: An den Bearbeitungs-Endpunkt gesendet, liefert er 400
input_imagesGehört zur Qwen-Bildreihe

Kein Fehler bedeutet nicht, dass der Parameter gewirkt hat: style beispielsweise wird direkt abgelehnt, während die oben genannten stillschweigend ignoriert werden.

Offizielle Dokumentation

Die Dokumentation von OpenAI beschreibt das Verhalten bei direktem Aufruf von OpenAI. Beim Aufruf über OfoxAI haben die gemessenen Ergebnisse auf diesen Seiten Vorrang. So richtet sich die Abrechnung beispielsweise nach usage in der Antwort und nach den Modellseiten.

FAQ

Akzeptiert GPT Image 2.5 jede Größe?

Benutzerdefinierte Größen werden akzeptiert, sofern vier Regeln erfüllt sind: Breite und Höhe durch 16 teilbar, längste Kante höchstens 3840, Seitenverhältnis zwischen 1:3 und 3:1 und insgesamt mindestens 655.360 Pixel. Ein Verstoß gegen eine Regel liefert 400. So hat 768x768 zu wenige Pixel und wird abgelehnt, während 1024x768 funktioniert.

Welche Größe erhalte ich, wenn ich size weglasse?

Das Modell entscheidet. Es ist nicht zwingend 1024x1024 und entspricht nicht zwingend dem Referenzbild. In unseren Tests lieferten sowohl Text zu Bild als auch Bearbeitung 1254x1254. Geben Sie eine Größe explizit an, wenn Sie eine feste Größe benötigen.

Unterstützt gpt-image-2 die Qualitätsstufen xhigh und max?

Nein, beide liefern 400. xhigh und max werden nur von gpt-image-2.5-flare und gpt-image-2.5-sunburst unterstützt. gpt-image-2 akzeptiert low, medium, high und auto.

Kann die Qualität bei GPT Image 2.5 hd oder standard sein?

Nein, diese Werte liefern 400. Gültige Werte sind low, medium, high, xhigh, max und auto. Wird der Parameter weggelassen, wählt das Modell selbst eine Stufe (in unseren Tests low); legen Sie ihn daher für gleichbleibende Qualität explizit fest.

Welches Timeout sollte ich für die API von gpt-image-2 / GPT Image 2.5 einstellen?

Setzen Sie das Client-Timeout auf 600 Sekunden. Die Latenz hängt von Modell, Qualität und Größe ab; Anfragen mit hoher Qualität, großen Formaten und Bearbeitungen können mehrere Minuten dauern.

Wie behebe ich den GPT-Image-Fehler moderation_blocked (Your request was rejected by the safety system)?

Prompt oder Referenzbild wurden vom Sicherheitssystem des Upstream-Anbieters blockiert, typischerweise wegen realer Personen, urheberrechtlich geschützter Figuren oder sensibler Inhalte. Ändern Sie Prompt oder Referenzbild und versuchen Sie es erneut; eine unveränderte Wiederholung führt zum selben Ergebnis. error.moderation_details in der Antwort gibt an, ob die Sperre in der Eingabe- oder der Ausgabephase erfolgte. Die Anbieter wenden unterschiedliche Moderationsschwellen an; bei Moderationsanforderungen kommt daher die Auswahl eines Anbieters in Betracht.

Wie behebe ich den GPT-Image-Fehler Unknown parameter: response_format?

response_format ist ein alter DALL·E-Parameter. GPT Image liefert ausschließlich Base64 (data[0].b64_json) und stellt keine Bild-URLs bereit. Entfernen Sie response_format und wählen Sie mit output_format png, jpeg oder webp. Über OfoxAI wird der Parameter ignoriert und verursacht keinen Fehler.

Was tun bei „Your organization must be verified“ beim Aufruf von gpt-image?

Das ist die Organisationsverifizierung, die OpenAI für den direkten Zugriff verlangt. Über OfoxAI müssen Sie keine Organisation selbst verifizieren: Mit einem OfoxAI-API-Schlüssel können Sie gpt-image-2.5-flare, gpt-image-2.5-sunburst und gpt-image-2 aufrufen.

Was tun, wenn GPT-Image-Anfragen in ein Timeout laufen oder 504 bzw. 524 liefern?

Die API ist synchron, und Anfragen mit hoher Qualität, großen Formaten und Bearbeitungen können mehrere Minuten dauern. Setzen Sie das Client-Timeout auf 600 Sekunden und prüfen Sie die Timeouts von Zwischen-Proxys wie Nginx, Vercel oder Cloudflare, deren Standardwerte oft nur 60 bis 100 Sekunden betragen.

Wie behebe ich den GPT-Image-Fehler does not support the input_fidelity parameter?

GPT Image 2.5 und gpt-image-2 verarbeiten Referenzbilder stets mit hoher Detailtreue, daher akzeptiert der Bearbeitungs-Endpunkt input_fidelity nicht. Entfernen Sie den Parameter; er gilt nur für gpt-image-1.5.

Wie behebe ich den GPT-Image-Fehler Invalid size?

Die Größe verstößt gegen eine der vier Regeln, und die Meldung nennt, gegen welche: divisible by 16 bedeutet, dass Breite oder Höhe kein Vielfaches von 16 ist; longest edge bedeutet, dass die längste Seite über 3840 liegt; aspect ratio bedeutet, dass das Seitenverhältnis 3:1 überschreitet; minimum pixel budget bedeutet weniger als 655.360 Pixel, z. B. 768x768. Verwenden Sie eine Größe, die alle vier Regeln erfüllt, etwa 1024x768, 1024x1024 oder 1536x1024.

Was kostet ein Bild mit GPT Image?

Abgerechnet wird nach Tokens, wobei die Qualitätsstufe am meisten ausmacht. Offizielle Referenzpreise von OpenAI für ein Bild mit 1024x1024 und gpt-image-2: etwa $0.006 bei low, $0.053 bei medium und $0.211 bei high. Bei den beiden 2.5-Modellen kosten Ausgabe-Bild-Tokens $30 pro Million, sodass 1024x1024 bei low etwa $0.006 kostet. Tatsächlich abgerechnet wird nach usage in der Antwort; die aktuellen Preise bei OfoxAI finden Sie auf den Modellseiten.

Muss ich bei der Bearbeitung mit GPT Image 2.5 einen Anbieter festlegen?

Nein. Sowohl Azure als auch OpenAI stellen den 2.5-Bearbeitungs-Endpunkt bereit, und das Gateway leitet Anfragen automatisch weiter.

Last updated on
Text zu Bild