GPT Image 2 API-Parameter: Größe, Auflösung, Seitenverhältnis und Qualität
Die GPT Image 2 API-Parameter, die das Bild bestimmen: Modellname, Größe und Auflösung, Seitenverhältnisse, 4K-Grenzen, Qualität, Formate und ihre Fehler.
Als Markdown lesenDie GPT Image 2 API erwartet den Modellnamen in model, die Ausgabemaße in size als WIDTHxHEIGHT in Pixeln und die Qualität in quality (low, medium, high oder auto). Ein Feld resolution oder aspect_ratio gibt es nicht. Für ein 16:9-Bild in 4K sendest du "size": "3840x2160". Größen müssen Vielfache von 16 verwenden, beide Kanten höchstens 3840 Pixel lang halten, zwischen 1:3 und 3:1 bleiben und zwischen 655.360 und 8.294.400 Pixeln liegen.
Dieser Leitfaden behandelt jeden Parameter, der das Bild verändert, mit dem genauen Wert, den du sendest, und dem Fehler, den ein falscher Wert zurückgibt. Jeder der folgenden Fehler wurde gegen die Live-API geprüft.
Wie lautet der GPT Image 2 Modellname in der API?
Verwende gpt-image-2 oder gpt-image-2-official. Beide sind dasselbe Modell mit denselben Feldern; gpt-image-2 berechnet einen festen Preis pro geliefertem Bild, gpt-image-2-official rechnet die Token ab, die jedes Rendering meldet.
Namen aus Überschriften funktionieren nicht als Modell-IDs. gpt-image-2.0, GPT Image 2 oder chatgpt-images-2 geben alle HTTP 400 mit dem Fehlercode 20002 zurück.
Wie legst du Auflösung und Seitenverhältnis fest?
Mit size, in Pixeln. Wähle das gewünschte Seitenverhältnis und Pixelbudget und sende dann die resultierende Breite und Höhe:
| Seitenverhältnis | Etwa 1K | Etwa 2K | 4K |
|---|---|---|---|
| 1:1 | 1024x1024 | 2048x2048 | 2880x2880 |
| 3:2 | 1248x832 | 2496x1664 | 3504x2336 |
| 2:3 | 832x1248 | 1664x2496 | 2336x3504 |
| 4:3 | 1152x864 | 2304x1728 | 3264x2448 |
| 3:4 | 864x1152 | 1728x2304 | 2448x3264 |
| 16:9 | 1280x720 | 2560x1440 | 3840x2160 |
| 9:16 | 720x1280 | 1440x2560 | 2160x3840 |
| 21:9 | 1456x624 | 3024x1296 | 3808x1632 |
| 3:1 | 1728x576 | 3504x1168 | 3840x1280 |
Das sind dieselben Umrechnungen, die der Playground verwendet, wenn du ein Verhältnis und eine Voreinstellung für 1K, 2K oder 4K wählst. Quadratisches 4K endet bei 2880x2880, weil ein Quadrat mit 3840 Pixeln die Gesamtpixelgrenze überschreiten würde.
size: "auto" überlässt die Maße dem Modell. Das ist der Standard und bequem, aber setz eine explizite Größe, wenn Ausgaben zu einem Layout oder zueinander passen müssen.
OpenAI bezeichnet Ausgaben über 2560×1440 als experimentell. Innerhalb der hier genannten Grenzen werden sie akzeptiert, aber eine größere Leinwand ist kein Versprechen für mehr Details.
Welche Größenwerte werden abgelehnt?
| Gesendeter Wert | Warum er scheitert | Antwort |
|---|---|---|
"size": "16:9" | Verhältnisse sind keine Größen | 400 20001, Meldung nennt size |
"size": "4096x2304" | Kante über 3840 | 400 20001, Meldung nennt size |
"size": "1000x1000" | Kein Vielfaches von 16 | 400 20001, Meldung nennt size |
"size": "3840x1024" | Breiter als 3:1 | 400 20001, Meldung nennt size |
"resolution": "4k" | Unbekanntes Feld | 400 20001, kein Feld genannt |
"aspect_ratio": "16:9" | Unbekanntes Feld | 400 20001, kein Feld genannt |
Beachte die letzten beiden Zeilen. Ein unbekanntes Feld wird abgelehnt, aber der Fehler nennt es nicht. Bekommst du 20001 mit der allgemeinen Meldung „Check the parameters against the API documentation“, such nach einem Feld, das die API nicht akzeptiert, etwa resolution, aspect_ratio oder response_format.
Welche Qualität solltest du wählen?
quality akzeptiert low, medium, high und auto. Höhere Stufen dauern länger und halten feinere Details fest. xhigh und max gibt es nur bei GPT Image 2.5; wer sie an GPT Image 2 sendet, erhält 20001 mit einer Meldung, die quality nennt.
Eine praktische Routine: Entwirf mit low, solange sich die Komposition noch ändert, prüfe Textur und kleine Schrift mit medium und erzeuge die finalen Bilder mit high. Bei gpt-image-2 ist der Preis auf jeder Stufe gleich. Bei gpt-image-2-official melden höhere Stufen mehr Ausgabe-Token und kosten daher mehr. Der Preisleitfaden zeigt die Zahlen.
auto lässt das Modell die Stufe wählen. Setz einen expliziten Wert, wenn du Durchläufe vergleichst, sonst werden zwei „identische“ Anfragen womöglich auf unterschiedlichen Stufen gerendert.
Was steuert Format und Hintergrund?
output_format:png(Standard) oderjpeg. WebP-Ausgabe wird nicht angeboten;webpgibt20001mit einer Meldung zurück, dieoutput_formatnennt.output_compression: 0 bis 100, nur mitjpeg.background:auto,opaqueodertransparent. Transparenz erfordertpng;transparentmitjpeggibt20001mit einer Meldung zurück, diebackgroundnennt.n: 1 bis 10 Bilder pro Anfrage. Berechnet werden die gelieferten Bilder.moderation:autooderlow.
Wie werden Referenzbilder und Masken übergeben?
Als URLs, niemals als Dateien oder Base64. images nimmt 1 bis 16 Objekte der Form {"image_url": "https://..."} an, und wer es sendet, macht die Anfrage zu einer Bearbeitung. mask nimmt ein Objekt derselben Form an: ein PNG in der Größe des ersten Referenzbilds, in dem der transparente Bereich markiert, was geändert werden soll. Die Referenz listet die Dateigrenzen auf.
Häufig gestellte Fragen
Unterstützt GPT Image 2 4K?
Ja, innerhalb der oben genannten Grenzen. 3840x2160 für 16:9 und 2160x3840 für 9:16 sind die größten Formate, und 2880x2880 ist das größte Quadrat.
Kann ich statt Pixeln ein Seitenverhältnis senden?
Nicht an die API. Rechne das Verhältnis zuerst in eine WIDTHxHEIGHT-Größe um, mit der Tabelle oben oder mit dem Playground, der die genaue Größe vor dem Senden anzeigt.
Was sind Standardgröße und Standardqualität?
Beide sind standardmäßig auto, was die Wahl dem Modell überlässt. Sende explizite Werte, wenn du vorhersehbare Ausgaben brauchst.
Pixel senden, Qualität setzen, die Fehlermeldung lesen
Fast jedes Parameterproblem ist eines von drei Dingen: ein als Größe gesendetes Verhältnis, ein Feld, das die API nicht akzeptiert, oder ein Wert außerhalb der Grenzen. Beim ersten und dritten Fall nennt die Fehlermeldung das Feld; eine allgemeine Meldung ohne Feldnamen verweist auf den zweiten. Behalte diese Seite neben der GPT Image 2 API-Referenz, während du integrierst.
