GPT Image 2.6

GPT Image 2.6 nimmt Text-Prompts und optional Referenzbilder entgegen. Sende einmal an POST /v1/images/generations, behalte die Aufgaben-ID und frage GET /v1/tasks/{id} nach dem Ergebnis ab. Fertige Dateien werden als URLs zurückgegeben.

Modell-IDs und Preise

Nutze GET /v1/models, um die für deinen Schlüssel verfügbaren Modelle zu finden. Die konfigurierten Sunburst-IDs sind gpt-image-2.6-sunburst-official und gpt-image-2.6-sunburst. Flare-IDs verwenden, sofern gelistet, denselben Parametervertrag. Die reine Modell-ID nutzt ihre Default-Gruppe; zusätzliche Gruppen verwenden die bei der Abfrage angezeigte ID model:group.

Sieh dir aktuelle Preise und den Playground an. Nach Token berechnete Modelle rechnen den tatsächlichen Verbrauch ab; Modelle mit Abrechnung pro Bild nutzen den konfigurierten Bildpreis. SVG-Antworten melden die Token des Modells, das den Code schreibt, separat in svg_usage; sie werden zum eigenen SeedRouter-Preis dieses Modells berechnet.

Ein Bild erzeugen

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-sunburst-official",
    "prompt": "A red paper crane on a pale blue table, soft daylight",
    "size": "1024x1024",
    "quality": "low",
    "complexity": "high"
  }'

Die Antwort enthält eine id. Frage diese ID ab, statt die Generierung erneut zu senden:

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

Nach Abschluss enthält output.data Objekte mit einer url. Lade die URL herunter, um das ursprüngliche Dateiformat und bei GIFs jedes Einzelbild der Animation zu behalten. Eine fehlgeschlagene Aufgabe hat einen error und wird nicht berechnet. Siehe Aufgabenstatus und Abfragen.

Parameter

Es gibt 18 Felder auf oberster Ebene. Nur model und prompt sind erforderlich. Optionale Felder akzeptieren null, was dem Weglassen entspricht. Unbekannte Felder werden verworfen. Ungültige Werte unterstützter Parameter scheitern vor der Bildgenerierung an der Validierung.

Referenz-URLs müssen HTTP oder HTTPS verwenden und dürfen keine Zugangsdaten enthalten. Datei-IDs, eingebettetes base64 und Multipart-Uploads werden nicht akzeptiert; lade Dateien zuerst hoch und gib ihre öffentlichen URLs an. Anfragen nutzen asynchrone Aufgabenabfragen statt stream oder partial_images. input_fidelity, response_format und prompt_rewriter sind in diesem Vertrag nicht verfügbar.

Bildgröße

Bei PNG, JPEG und der Generierung von SVG-Referenzbildern muss jedes Maß durch 16 teilbar sein und darf 3840 Pixel nicht überschreiten. Die Gesamtfläche muss 655.360–8.294.400 Pixel betragen und das Seitenverhältnis zwischen 1:3 und 3:1 liegen. Beispiele: 1024x1024, 1536x1024, 2160x3840, 2880x2880.

GIF-Abmessungen müssen positive Vielfache von 16 sein; alternativ verwende auto. GIF hat ein eigenes Gesamtpixelbudget, das sich Einzelbildanzahl, Einzelbildabmessungen und n teilen; OpenAI hat dessen numerische Grenze nicht veröffentlicht. Für ein 512x512-GIF gilt die Mindestpixelregel statischer Bilder nicht.

Animiertes GIF

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A red paper crane flapping its wings in a seamless loop on pale blue",
  "output_format": "gif",
  "size": "512x512",
  "quality": "low",
  "frame_count": 4,
  "frame_duration_ms": 200
}

GIF lässt sich aus einem Prompt erzeugen oder mit Referenzbildern anfordern. Kombiniere es nicht mit einer Maske oder Komprimierung. Die Verfügbarkeit der Vorschau kann vom Zugang des ausgewählten Modells abhängen.

Widerspruch in der Dokumentation, geprüft am 5. November 2026: Der Leitfaden zur Bildgenerierung von OpenAI nennt 2–64 Einzelbilder und 20–2000 ms und sagt, der Bearbeitungs-Endpunkt liefere keine GIFs. Die Images-API-Referenz nennt 2–16 Einzelbilder ohne maximale Anzeigedauer und führt GIF-Ausgabe bei Bearbeitungen auf. Anfragen an die zugrunde liegende API am 5. November 2026 entsprachen der Referenz: 17 Einzelbilder wurden abgelehnt und ein Einzelbild mit 3.000 ms wurde akzeptiert. Diese API folgt der Referenz.

SVG

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A simple geometric red paper-crane logo, clean editable vector paths",
  "output_format": "svg",
  "n": 1
}

SVG ist nur bei Generierung verfügbar und erfordert n: 1. Sende keine Bilder, Maske, Markierungen oder Komprimierung. Die Datei ist statisches UTF-8-XML mit Vektorformen; Skripte, externe Ressourcen und eingebettete Rasterbilder werden nicht unterstützt.

Wenn die Auswahl des Modells zum Schreiben des Codes verfügbar ist, ergänze svg: {"model":"YOUR_AUTHOR_MODEL_ID"}. Ein explizit angegebenes svg-Objekt erfordert einen nicht leeren Wert für model. Du kannst auch svg.reasoning.effort auf none, minimal, low, medium, high, xhigh oder max setzen; das ausgewählte Modell bestimmt, welche Werte es unterstützt. Lass reasoning weg, um seinen Standard zu nutzen. OpenAI veröffentlicht weder eine Liste zulässiger Modelle zum Schreiben des Codes noch einen allgemeinen Standard. Ist diese Modellauswahl nicht verfügbar, lass das gesamte svg-Objekt weg.

Das fertige Ergebnis kann svg_usage mit model, input_tokens, output_tokens, reasoning_tokens und total_tokens enthalten. Das ist getrennt vom Bildverbrauch in usage und keine zusätzliche Anzahl von Bild-Token.

Referenzbilder, Maske und Markierungen

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "Replace the marked background with a pale blue studio backdrop",
  "images": [{"image_url":"https://example.com/reference.png"}],
  "markup": {"image_url":"https://example.com/transparent-markup.png"},
  "output_format": "png",
  "complexity": "low"
}

Referenzbilder unterstützen PNG, JPEG und WebP mit jeweils höchstens 50 MB. Maske und Markierungen müssen PNG sein und nach der Ausrichtung den Abmessungen des ersten Referenzbildes entsprechen. Markierungen müssen transparente Pixel enthalten; sowohl die Markierungen als auch das erste Referenzbild dürfen höchstens 16.777.216 Pixel enthalten, die Markierungen höchstens 50 MB groß sein. Maske und Markierungen schließen einander aus.

Antwortfelder

Die fertige Bildausgabe enthält created, data: [{url}] und, sofern gemeldet, size, quality, background, output_format, usage, svg_usage und safety_identifier. usage kann Text-/Bild-Eingabe- und Ausgabe-Token sowie Eingaben aus dem Cache aufschlüsseln. Die öffentliche Ausgabe enthält weder base64-Bildbytes noch Kostenfelder.

OpenAPI-Schema · OpenAI-Referenz zur Generierung · OpenAI-Referenz zur Bearbeitung · OpenAI-Bildleitfaden