Zum Hauptinhalt springen
POST
Modell: gpt-image-2.6-ext; version: flare / sunburst. Abrechnung pro Bild. Unterstützt: resolution 1k / 2k / 4k mit n: 1, alle Qualitätsstufen und PNG / JPEG / WebP / SVG / GIF.
Dies ist die Ext-API. Modellname und Parameterregeln unterscheiden sich von den tokenbasierten GPT-Image-2.6-Modellen.

Authentifizierung

string
erforderlich
Bearer-Token mit einem Plattform-API-Key verwenden. Schlüssel auf der API-Key-Seite erstellen. Anfragen mit Content-Type: application/json senden.

Versionsauswahl

Anfrageparameter

Bei Enum-Werten wird Groß-/Kleinschreibung ignoriert; äußere Leerzeichen werden entfernt. Beispiele verwenden Kleinschreibung.
string
erforderlich
Fester Wert: gpt-image-2.6-ext.
string
erforderlich
Erforderliche, nicht leere Generierungs- oder Bearbeitungsanweisung. Bei mehreren Referenzen erstes oder zweites Bild benennen und gewünschte Änderungen sowie zu erhaltende Elemente beschreiben.
string
Standard:"flare"
flare / sunburst; Standard flare. Andere Werte führen zu HTTP 400. Preise können je Version abweichen.
string
Standard:"1k"
1k / 2k / 4k (Großschreibung 1K / 2K / 4K wird ebenfalls akzeptiert). Bestimmt zusammen mit dem size-Verhältnis die Ausgabepixel; siehe Tabelle „Verhältnisse und Pixelmaße“ unten. Der Preis pro Bild hängt von der Stufe ab; andere Werte wie hd / 8k führen zu HTTP 400.
string
Standard:"auto"
Nur auto oder die 10 Verhältnisse unten, keine Pixelwerte wie 1024x1024. Bei Textgenerierung ergibt auto 1:1. Bei Bearbeitung wird das nächstgelegene unterstützte Verhältnis der ersten Referenz mit lesbaren Abmessungen gewählt. Für GIF weglassen oder auto verwenden.
string
Alias für size; eines der beiden Felder genügt. Bei gemeinsamer Angabe müssen sie übereinstimmen, sonst HTTP 400. Für GIF ebenfalls weglassen oder auto verwenden.
integer
Standard:"1"
Derzeit Ganzzahl 1 verwenden.
string
auto / low / medium / high / xhigh / max. Ohne Angabe wird nichts weitergeleitet; der Anbieter wählt automatisch. auto ist nicht auf low festgelegt. Der Bildpreis bleibt gleich; höhere Stufen dauern meist länger. Andere Werte: HTTP 400.
string
Standard:"png"
png / jpeg / webp / svg / gif; jpg ist ein Alias für jpeg. SVG und GIF unterstützen nur Textgenerierung. Andere Formate: HTTP 400.
SVG-Ausgabe wird derzeit noch nicht unterstützt.
string
low / medium / high; ohne Angabe entscheidet der Anbieter. Steuert die Szenenkomplexität: low für einfache Icons und flache Illustrationen, high für mehr Details. Kein Einfluss auf den Bildpreis.
string[]
Bis zu 16 Bilder mit je höchstens 20 MB. PNG / JPEG / WebP / GIF / BMP. Öffentliche HTTP(S)-URLs oder Bild-Data-URLs wie data:image/png;base64,.... Referenzen aktivieren die Bearbeitung; SVG und GIF erlauben keine Referenzen.
Bei resolution 2k / 4k dürfen Referenzbilder nicht GIF / BMP sein.
Feldaliase: image_url, image, images, input_image, input_images. Bevorzugt image_urls verwenden. URLs müssen ohne Anmeldung öffentlich erreichbar sein.

Verhältnisse und Pixelmaße

Mit auto nutzt Textgenerierung 1:1: 1024×1024 bei 1k, 2048×2048 bei 2k, 2880×2880 bei 4k. Bearbeitung wählt das nächstgelegene Verhältnis aus der Tabelle; ursprüngliche Pixelmaße werden nicht garantiert.

Beispiel mit Referenzbildern

Auch Bearbeitung nutzt POST /v1/images/generations. Beispiel-URLs durch erreichbare Bilder ersetzen.

SVG-Ausgabe

output_format: "svg" setzen. Nur Textgenerierung mit n=1. size akzeptiert Verhältnisse; complexity: "low" eignet sich für einfache Vektorgrafiken.
object
Optionale Konfiguration des SVG-Erstellungsmodells, ausschließlich für SVG. Das gesamte Objekt kann entfallen. Für das SVG-Textmodell fallen keine zusätzlichen Kosten an.

Animierte GIFs

output_format: "gif" setzen. Nur Textgenerierung. size / aspect_ratio weglassen oder auto verwenden; Verhältnisse und Pixelwerte führen zu HTTP 400. Bewegung und Schleife im Prompt beschreiben.

Nicht unterstützte und ignorierte Parameter

Übermittlung und Ergebnisse

Erfolgreiche Übermittlung: HTTP 200. data[0].task_id lesen und die Aufgabenstatus-API alle 3–5 Sekunden bis completed oder failed abfragen. Bei einem Client-Timeout dieselbe Aufgabe weiter abfragen, statt erneut zu generieren.
Das Beispiel zeigt das Aufgabenobjekt. Bei einer {code, data}-Hülle zunächst data lesen. Die Python-/JavaScript-Beispiele verarbeiten beide Formen.
result.images[0].url ist ein Array; der erste Link ist result.images[0].url[0]. Vor expires_at speichern; die empfohlene Gültigkeit beträgt 24 Stunden nach Abschluss. cost / credits_cost zeigen die endgültigen Kosten. Stapelabfrage: POST /v1/tasks/batch mit {"task_ids":["task_xxx","task_yyy"]}.

Abrechnung

Der Bildpreis hängt nur von version × resolution ab. Qualität, Format einschließlich SVG / GIF, Komplexität, Verhältnis, Referenzzahl und svg.model ändern ihn nicht. Derzeit n=1 verwenden; fehlgeschlagene Aufgaben werden vollständig erstattet. Aktuelle Preise: APIMart-Preisseite oder /api/pricing.

Fehlerbehandlung