Bearbeiten gpt-image-2

POST

/v1/images/edits

• Bilder anhand von prompt und Referenzbild image bearbeiten oder zusammenfügen (gpt-image-2)
• Optionales mask legt transparente Bereiche als Bearbeitungszone fest
• Anfragekörper ist multipart/form-data (mit binären Bildfeldern)
• Offizielle Dokumentation: Images createEdit

Authorizations

bearer

Type

HTTP (bearer)

Request Body

multipart/form-data

object

Zu bearbeitendes Bild. Muss eine unterstützte Bilddatei oder ein Bildarray sein. Für gpt-image-1 jeweils png, webp oder jpg unter 25 MB. Für dall-e-2 nur ein quadratisches png unter 4 MB.

Format"binary"

Textbeschreibung des gewünschten Bildes. Maximal 1000 Zeichen für dall-e-2 und 32000 für gpt-image-1.

Zusätzliches Bild, dessen vollständig transparente Bereiche (z. B. Alpha null) die Bearbeitungsstelle auf image markieren. Bei mehreren Bildern wird die Maske auf das erste angewendet. Gültiges PNG unter 4 MB, gleiche Abmessungen wie image.

Format"binary"

Modell zur Bildgenerierung. Nur gpt-image-1, gpt-image-1-all, flux-kontext-pro, flux-kontext-max.

Anzahl der zu generierenden Bilder. Zwischen 1 und 10.

Qualität des generierten Bildes. Nur gpt-image-1 unterstützt high, medium und low. dall-e-2 nur standard. Standard auto.

Rückgabeformat der Bilder. url oder b64_json. URLs sind 60 Minuten nach Generierung gültig. Nur für dall-e-2; gpt-image-1 liefert immer base64 — diesen Parameter für gpt-image-1 nicht verwenden.

Bildgröße. GPT-Bildmodelle: 1024x1024, 1536x1024 (Querformat), 1024x1536 (Hochformat) oder auto. dall-e-2: 256x256, 512x512 oder 1024x1024. dall-e-3: 1024x1024, 1792x1024 oder 1024x1792.

Hintergrundtransparenz für generierte Bilder. Nur gpt-image-1: transparent, opaque oder auto. Bei auto wählt das Modell den besten Hintergrund.

Inhaltsmoderationsstufe für gpt-image-1-Bilder. low für weniger strenge Filterung, auto als Standard.

Responses

Content-Type

application/json

object

object[]

Required

object

Required