Zum Hauptinhalt springen
Verwende /v1/images/generations für die Bildgenerierung im Produktivbetrieb.
Die Antwort liefert eine Task zurück:

Sync-Variante

/v1/images/generations/sync erstellt eine Task und wartet bis zur konfigurierten maximalen Wartezeit. Verwende sie für Kompatibilität und Demos. Nutze für Produktiv-Workloads den asynchronen Endpoint.

Bildbearbeitung

/v1/images/edits unterstützt OpenAI-typische Bildbearbeitungs-Workflows, sofern das ausgewählte Modell Referenzbilder unterstützt.

GPT Image 2.5 Qualität und unterstützte Parameter

gpt-image-2.5 ist ein fester Flare-Alias; für präzise Bearbeitung wird gpt-image-2.5-sunburst verwendet. quality (auto/low/medium/high/xhigh/max) und resolution (1K/2K/4K) sind unabhängig. Explizite Pixel müssen zur Auflösungsstufe passen. Das gewählte Modell muss die angefragten Parameter unterstützen; nicht unterstützte Felder werden nicht stillschweigend entfernt.
Die Bearbeitung unterstützt bis zu 16 Referenzbilder und eine optionale Maske.

GPT Image 2.6

gpt-image-2.6 nutzt für PNG und animierte GIFs die bestehenden Bild-Endpunkte; eine eigene GIF-API ist nicht nötig. Jede erfolgreiche Anfrage kostet 30 Credits und liefert ein Ergebnis. Prüfen Sie vor dem Aufruf die Verfügbarkeit in GET /v1/models. Verwenden Sie output_format: "png" (Standard) oder "gif", quality: "auto", resolution: "1K" und n: 1. size akzeptiert auto, 1:1, 3:2, 2:3, 1024x1024, 1536x1024 oder 1024x1536. Es ist höchstens ein Referenzbild erlaubt. Die Grenzen gelten auch für Aliase und model_params; widersprüchliche Werte führen zu HTTP 400. SVG, JPEG, WebP, 2K/4K, Masken, Kompression, frame_count und frame_duration_ms werden nicht unterstützt. GIF-Maße, Bildanzahl und Bildintervalle sind nicht konfigurierbar. background kann entfallen und akzeptiert nur auto. SVG-Anfragen führen zu HTTP 400, nicht zu einem PNG-Ergebnis.

PNG mit synchronem Warten

GIF mit einem Referenzbild

Der Bearbeitungs-Endpunkt akzeptiert JSON mit einem Eintrag in image_urls oder eine Multipart-Datei in image. Fügen Sie keine Maske hinzu. output_format wählt das Ergebnisformat; auch GIF-Bearbeitung liefert eine einzelne animierte Datei.
Alternativ können Sie eine Referenzdatei mit multipart/form-data hochladen:
Sync- und Bearbeitungs-Endpunkte liefern nach Abschluss HTTP 200 mit data[0].url oder während der Verarbeitung HTTP 202 mit task_id und poll_url. Fragen Sie /v1/tasks/{task_id} bis completed oder failed ab und behalten Sie bei pending oder processing dieselbe Aufgaben-ID. Die asynchrone Generierung nutzt /v1/images/generations; die fertige Datei steht unter result.data[0].url. Ungültige oder statische GIF-Ergebnisse schlagen fehl und folgen der normalen Credit-Erstattungsrichtlinie für fehlgeschlagene Aufgaben. Alle Parameter, asynchrone PNG/GIF-Beispiele und Abfrageantworten