Zum Hauptinhalt springen
POST
Modellwahl: gpt-image-2.5-flare ist schneller und eignet sich für hochwertige Alltagsbilder, Serienproduktion und schnelle Prototypen. gpt-image-2.5-sunburst priorisiert Bearbeitungspräzision für finale Produktbilder, Werbemittel und detaillierte mehrstufige Bearbeitung. Beide Modelle werden gleich abgerechnet.

Authentifizierung

string
erforderlich
Alle Endpunkte verwenden Bearer-Token-Authentifizierung. Den Schlüssel erhalten Sie auf der API-Schlüssel-Seite.

Modell auswählen

Tokenverbrauch und Preis sind bei gleichen Parametern identisch. Die Wahl hängt nur von Geschwindigkeit und Qualität ab. Gegenüber gpt-image-2 kommen xhigh und max hinzu; medium und high benötigen ungefähr ein Viertel der Ausgabe-Token der gleichnamigen Vorgängerstufen.

Anfrageparameter

string
erforderlich
Modellname: gpt-image-2.5-flare oder gpt-image-2.5-sunburst.
string
erforderlich
Textbeschreibung des zu erzeugenden oder zu bearbeitenden Bildes. Beschreiben Sie Motiv, Szene, Komposition, Stil, Beleuchtung und gewünschte Änderungen.
string
Standard:"auto"
Seitenverhältnis oder exakte Pixelmaße.
  • auto: automatische Wahl anhand von Prompt oder Referenzbildern
  • Verhältnis: 1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 2:1, 1:2, 21:9, 9:21, 3:1, 1:3
  • Exakte Maße, zum Beispiel 1600x1200
Bei Bild-zu-Bild-Anfragen sollte size entfallen. Der Dienst berechnet die Maße aus dem Eingabeverhältnis und resolution.
string
Standard:"1k"
Auflösungsstufe: 1k, 2k oder 4k. Bei exakten Pixelmaßen wird dieses Feld ignoriert.
string
Standard:"auto"
Bildqualität: low, medium, high, xhigh, max oder auto.
xhigh und max werden nur von GPT-Image-2.5 unterstützt. Bei gpt-image-2 führt dies zu HTTP 400; es gibt keine automatische Herabstufung.
integer
Standard:"1"
Anzahl der Bilder: 1 bis 4. Als Zahl, nicht als Zeichenkette, senden.
string
Standard:"png"
Ausgabeformat: png, jpeg oder webp.