GPT Image 2.5 Bildgenerierung

Name des Bildgenerierungsmodells, offizieller Kanal, bessere Stabilität und Steuerbarkeit, geeignet für kommerzielle Szenarien

Beide Modelle haben exakt dieselben Parameter; bei derselben quality-Stufe kann der tatsächliche Token-Verbrauch leicht abweichen – maßgeblich ist das zurückgegebene usage.

Prompt, der das zu generierende Bild beschreibt oder wie das Eingabebild bearbeitet werden soll

Längenbegrenzungen (beide müssen eingehalten werden):

• Maximal 32.000 Zeichen (gezählt als Unicode-Codepunkte)
• Der Text von prompt selbst darf nach der UTF-8-Kodierung höchstens 60.000 Bytes umfassen

Verschiedene Zeichen belegen unterschiedlich viele UTF-8-Bytes. Maßgeblich ist die tatsächliche Byteanzahl nach der Kodierung.

Wenn eine der Grenzen überschritten wird, kürzen Sie den Prompt vor dem erneuten Senden.

Empfehlung: Wenn der Prompt 8000 Tokens überschreitet, entspricht das generierte Bild möglicherweise nicht den Erwartungen; eine Kürzung des Prompts wird empfohlen.

Inpainting-Maske URL — markiert die Region des Referenzbildes, die neu generiert werden soll. Nur im Bildbearbeitungsmodus wirksam (muss zusammen mit image_urls verwendet werden); bei reiner Text-zu-Bild-Generierung wird die Maske stillschweigend ignoriert.

Format-Anforderungen:

• Muss ein PNG mit Alphakanal sein: transparente Pixel (alpha < 255) = neu zu generierende Bereiche, undurchsichtige Pixel = bleiben erhalten
• Maskenabmessungen müssen exakt mit dem Referenzbild übereinstimmen (Breite × Höhe in Pixeln)
• Eine Maske pro Anfrage

Hinweis:

• Mindestens ein Referenzbild in image_urls ist erforderlich; eine Maske allein hat keine Wirkung
• Häufige Fehler:
  • Invalid mask image format - mask image missing alpha channel: Das hochgeladene Bild hat keinen Alphakanal (JPEG, undurchsichtiges PNG usw.). Exportieren Sie die Maske erneut als PNG mit transparenten Bereichen.
  • Invalid mask image format - mask size does not match image size: Die Maskenabmessungen stimmen nicht mit dem Referenzbild überein. Skalieren Sie die Maske auf die gleichen Pixelabmessungen wie Ihr Referenzbild.

Größe des generierten Bildes. Unterstützt sowohl Verhältnisformat als auch explizites Pixelformat, Standard auto

① Verhältnisformat (empfohlen, 15 Optionen)

• 1:1: Quadrat
• 1:2 / 2:1: Extrem hoch / breit
• 1:3 / 3:1: Ultra hoch / breit (3:1-Grenze)
• 2:3 / 3:2: Standard hoch / quer
• 3:4 / 4:3: Klassisch hoch / quer
• 4:5 / 5:4: Gängige Social-Media-Formate
• 9:16 / 16:9: Mobil / Desktop-Widescreen
• 9:21 / 21:9: Ultra-Wide

② Explizites Pixelformat: WxH (oder W×H), z. B. 1024x1024, 1536x1024, 3840×2160

• Breite und Höhe müssen jeweils Vielfache von 16 sein
• Jede Kante im Bereich: [16, 3840]
• Pixel-Budget: 655.360 ≤ width × height ≤ 8.294.400 (ca. 0,65 MP ~ 8,29 MP)
• Seitenverhältnis: ≤ 3:1

③ auto: Modell bestimmt die Größe automatisch (resolution greift in diesem Modus nicht)

Überschreitungsbehandlung:

• Wenn eine Kombination aus Verhältnis + resolution das Pixel-Budget überschreitet, werden die Maße proportional auf das Maximum herunterskaliert (z. B. 4K 2:1 → 3840×1920)

Schneller Parameter für die Auflösungsstufe, wirkt nur, wenn size im Verhältnisformat angegeben ist; im expliziten Pixelformat wird dieses Feld ignoriert

Pixel-Budget-Regel (die Abmessungen werden aus der Ziel-Pixelzahl und dem size-Verhältnis berechnet und auf Vielfache von 16 ausgerichtet):

• 1K: ~1 MP (1024² = 1.048.576 Pixel)
• 2K: ~4 MP (2048² = 4.194.304 Pixel)
• 4K: ~8,29 MP (3840×2160 = 8.294.400 Pixel, das Maximum)

Querformat-/Quadrat-Ausgabegrößen (Hochformat-Maße sind die Breite/Höhe des entsprechenden Querformats vertauscht, z. B. 2:3 = 3:2 umgekehrt):

* Markiert Kombinationen, die wegen des Pixel-Budgets automatisch herunterskaliert werden. Werte sind Groß-/Kleinschreibungsunabhängig.

Rendering-Qualität, steuert die "Denktiefe" des Modells und beeinflusst direkt die Anzahl der Ausgabe-Token und die Kosten. Standard medium

Hinweis:

• Die Stufen sind feiner abgestuft als bei GPT Image 2: low kostet bei beiden gleich viel, während medium und high nur 1/4 der Ausgabe-Token der gleichnamigen Stufe von GPT Image 2 verbrauchen; high bei 2.5 entspricht medium bei GPT Image 2, und erst max bei 2.5 entspricht high bei GPT Image 2
• Die Tabelle ist für 1024×1024 berechnet; die Anzahl der Ausgabe-Token variiert mit der Gesamtpixelzahl und dem Seitenverhältnis – maßgeblich ist das zurückgegebene usage
• Für schnelle Entwürfe low verwenden; für finale Assets mehrere Stufen vergleichen, um Detailgrad, Latenz und Kosten auszubalancieren

Alphakanal des Ausgabebildes. Standardwert opaque

• opaque: Deckender Hintergrund, kein Alphakanal
• transparent: Behält den Alphakanal bei

Hinweis:

• transparent ist eine Preview-Funktion, die Ergebnisse können instabil sein
• Bei Verwendung von transparent muss output_format png oder webp sein

Dateiformat des Ausgabebildes. Standardwert png

• png: Verlustfrei, unterstützt transparente Hintergründe
• jpeg: Verlustbehaftete Komprimierung, kleinere Dateien
• webp: Guter Kompromiss aus Dateigröße und Qualität, unterstützt ebenfalls transparente Hintergründe

Hinweis:

• Bei background = transparent sind nur png und webp möglich; jpeg kann keinen Alphakanal transportieren

Anzahl der zu generierenden Bilder, jedes wird einzeln abgerechnet

Hinweis:

• Text-Input-Tokens skalieren linear mit n
• Die Unterstützung des offiziellen Modells für n > 1 ist derzeit unzuverlässig: Auch bei einem Wert größer als 1 wird häufig nur ein Bild zurückgegeben. Maßgeblich ist die Anzahl in results in der Antwort, die Abrechnung richtet sich nach dem zurückgegebenen usage. Für mehrere Bilder besser mehrere Einzelanfragen senden

HTTPS-Callback-Adresse nach Aufgabenabschluss

Callback-Zeitpunkt:

• Wird ausgelöst, wenn die Aufgabe abgeschlossen, fehlgeschlagen oder abgebrochen wurde
• Wird nach Abschluss der Abrechnungsbestätigung gesendet

Sicherheitsbeschränkungen:

• Nur HTTPS-Protokoll wird unterstützt
• Callback an interne IP-Adressen ist verboten (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, usw.)
• URL-Länge darf 2048 Zeichen nicht überschreiten

Callback-Mechanismus:

• Timeout: 10 Sekunden
• Maximal 3 Wiederholungsversuche bei Fehler (Wiederholung nach 1 Sekunde/2 Sekunden/4 Sekunden)
• Das Format des Callback-Antwortkörpers entspricht dem Antwortformat der Aufgabenabfrage-API
• Ein 2xx-Statuscode der Callback-Adresse gilt als erfolgreich, andere Statuscodes lösen eine Wiederholung aus

Zeitstempel der Aufgabenerstellung

Aufgaben-ID

Tatsächlich verwendeter Modellname

Spezifischer Aufgabentyp

Aufgabenfortschritt in Prozent (0-100)

Aufgabenstatus

Ausgabetyp der Aufgabe