Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

Bildgenerierung

Ermögliche Modellen, Bilder zu generieren oder zu bearbeiten.

Mit dem Tool zur Bildgenerierung kannst du Bilder anhand eines Textprompts generieren. Optional kannst du auch Bilder als Eingabe übergeben. Das Tool nutzt Modelle der GPT Image-Familie, darunter gpt-image-2.5-sunburst, gpt-image-2.5-flare, gpt-image-2, gpt-image-1.5 und gpt-image-1-mini. Es optimiert Texteingaben automatisch, um bessere Ergebnisse zu erzielen.

Setze beim Tool image_generation den Parameter model auf gpt-image-2.5-sunburst, wenn du Bilder präzise bearbeiten möchtest, oder auf gpt-image-2.5-flare, wenn du schnell hochwertige Bilder generieren möchtest. Gib im Feld model auf der obersten Ebene der Responses-Anfrage ein unterstütztes Hauptmodell an.

gpt-image-1 wurde am 23. Oktober 2026 abgeschaltet. Einzelheiten zur Migration findest du im Hinweis zur Einstellung des Modells.

Mehr zur Bildgenerierung erfährst du in unserem Leitfaden zur Bildgenerierung.

Verwendung

Wenn du das Tool image_generation in deiner Anfrage angibst, kann das Modell im Gespräch selbst entscheiden, wann und wie es Bilder generiert. Dabei berücksichtigt es deinen Prompt und alle Bilder, die du als Eingabe übergibst.

Das Ergebnis des Toolaufrufs image_generation_call enthält ein Base64-kodiertes Bild.

Wenn einzelne Personen deine Anwendung nutzen, gib bei jeder Responses-Anfrage auf der obersten Ebene einen stabilen, datenschutzfreundlichen safety_identifier an. Das gilt auch für spätere Bildbearbeitungen. Der Parameter gehört zur Anfrage und wird außerhalb der Optionen für das Tool image_generation angegeben. Hinweise für beide Bild-APIs findest du im Abschnitt zu Sicherheitskennungen für die Bildgenerierung.

Ein Bild generieren
from openai import OpenAI
import base64

client = OpenAI()

response = client.responses.create(
    model="gpt-6-astra",
    input="Generate an image of gray tabby cat hugging an otter with an orange scarf",
    tools=[{"type": "image_generation", "model": "gpt-image-2.5-sunburst"}],
)

# Save the image to a file
image_data = [
    output.result
    for output in response.output
    if output.type == "image_generation_call"
]

if image_data:
    image_base64 = image_data[0]
    with open("otter.png", "wb") as f:
        f.write(base64.b64decode(image_base64))

Du kannst Eingabebilder übergeben, indem du Datei-IDs oder Base64-Daten verwendest.

Um den Aufruf des Tools zur Bildgenerierung zu erzwingen, kannst du den Parameter tool_choice auf {"type": "image_generation"} setzen.

Tooloptionen

Die folgenden Ausgabeoptionen kannst du als Parameter für das Tool zur Bildgenerierung angeben:

  • Größe: Bildabmessungen, zum Beispiel 1024 × 1024 oder 1024 × 1536
  • Qualität: Renderqualität, zum Beispiel niedrig, mittel oder hoch
  • Format: Dateiformat für die Ausgabe
  • Komprimierung: Komprimierungsgrad (0–100 %) für JPEG und WebP
  • Hintergrund: transparent, undurchsichtig oder automatisch gewählt
  • Aktion: Bildgenerierung oder Bildbearbeitung vorgeben oder die Auswahl dem Modell überlassen

size, quality und background unterstützen die Option auto. Damit wählt das Modell anhand des Prompts automatisch die am besten geeignete Einstellung.

Bei gpt-image-2.5-sunburst und gpt-image-2.5-flare akzeptiert quality auch die Werte xhigh und max. Frühere Modelle der GPT Image-Familie unterstützen diese Werte nicht. Die Standardeinstellung für die Qualität bleibt auto.

gpt-image-2 unterstützt flexible Werte für size, sofern sie die Vorgaben zur Auflösung erfüllen. Transparente Hintergründe sind als Vorschaufunktion verfügbar. Mit background: "transparent" forderst du einen transparenten Hintergrund an. Verwende dafür png (Standard) oder webp. Das Format jpeg unterstützt keine transparenten Hintergründe.

Weitere Einzelheiten zu den verfügbaren Optionen findest du im Leitfaden zur Bildgenerierung.

Wenn du das Tool zur Bildgenerierung in der Responses API verwendest, können unterstützte Modelle der GPT Image-Familie entscheiden, ob sie ein neues Bild generieren oder ein Bild aus dem bisherigen Gespräch bearbeiten. Dieses Verhalten steuerst du mit dem optionalen Parameter action. Lass action auf auto, damit das Modell selbst entscheidet. Mit generate oder edit gibst du die jeweilige Aktion vor. Wenn du keinen Wert angibst, gilt auto.

Überarbeiteter Prompt

Wenn du das Tool zur Bildgenerierung verwendest, überarbeitet das Hauptmodell, zum Beispiel gpt-5.5, deinen Prompt automatisch, um bessere Ergebnisse zu erzielen.

Den überarbeiteten Prompt findest du im Feld revised_prompt des Toolaufrufs zur Bildgenerierung:

{
  "id": "ig_123",
  "type": "image_generation_call",
  "status": "completed",
  "revised_prompt": "A gray tabby cat hugging an otter. The otter is wearing an orange scarf. Both animals are cute and friendly, depicted in a warm, heartwarming style.",
  "result": "..."
}

Tipps für Prompts

Die Bildgenerierung funktioniert am besten, wenn du in deinem Prompt Begriffe wie draw oder edit verwendest.

Wenn du zum Beispiel Bilder kombinieren möchtest, kannst du anstelle von combine oder merge eine konkrete Anweisung geben, etwa „Bearbeite das erste Bild, indem du dieses Element aus dem zweiten Bild hinzufügst.“

Bilder in mehreren Schritten bearbeiten

Du kannst Bilder schrittweise bearbeiten, indem du auf die ID einer früheren Antwort oder eines früheren Bildes verweist. So kannst du ein Bild im Laufe des Gesprächs weiter verfeinern.

Bildgenerierung in mehreren Schritten
from openai import OpenAI
import base64

client = OpenAI()

response = client.responses.create(
    model="gpt-6-astra",
    input="Generate an image of gray tabby cat hugging an otter with an orange scarf",
    tools=[{"type": "image_generation", "model": "gpt-image-2.5-sunburst"}],
)

image_data = [
    output.result
    for output in response.output
    if output.type == "image_generation_call"
]

if image_data:
    image_base64 = image_data[0]

    with open("cat_and_otter.png", "wb") as f:
        f.write(base64.b64decode(image_base64))


# Follow up

response_fwup = client.responses.create(
    model="gpt-6-astra",
    previous_response_id=response.id,
    input="Now make it look realistic",
    tools=[{"type": "image_generation", "model": "gpt-image-2.5-sunburst"}],
)

image_data_fwup = [
    output.result
    for output in response_fwup.output
    if output.type == "image_generation_call"
]

if image_data_fwup:
    image_base64 = image_data_fwup[0]
    with open("cat_and_otter_realistic.png", "wb") as f:
        f.write(base64.b64decode(image_base64))

Streaming

Während das Tool zur Bildgenerierung das endgültige Bild erstellt, kann es Zwischenstände per Streaming übertragen. So sehen Nutzende früher ein erstes Ergebnis und die Wartezeit wirkt kürzer.

Mit dem Parameter partial_images legst du fest, wie viele Zwischenbilder übertragen werden (1–3).

Ein Bild streamen
from openai import OpenAI
import base64

client = OpenAI()


def save_base64_image(filename, image_base64):
    image_bytes = base64.b64decode(image_base64)
    with open(filename, "wb") as f:
        f.write(image_bytes)


stream = client.responses.create(
    model="gpt-6-astra",
    input="Draw a gorgeous image of a river made of white owl feathers, snaking its way through a serene winter landscape",
    stream=True,
    tools=[
        {"type": "image_generation", "model": "gpt-image-2.5-sunburst", "partial_images": 2}
    ],
)

for event in stream:
    if event.type == "response.image_generation_call.partial_image":
        idx = event.partial_image_index
        save_base64_image(f"river-partial-{idx}.png", event.partial_image_b64)
    elif event.type == "response.completed":
        image_data = [
            output.result
            for output in event.response.output
            if output.type == "image_generation_call"
        ]

        if image_data:
            save_base64_image("river-final.png", image_data[0])

Unterstützte Modelle

Die folgenden Modelle sind nicht als veraltet eingestuft und unterstützen laut Dokumentation das Tool zur Bildgenerierung in der Responses API. Gib die jeweilige Modell-ID im Feld model auf der obersten Ebene an. Informationen zur Verfügbarkeit und zu den Zugangsvoraussetzungen findest du auf der Seite des jeweiligen Modells.

Informationen zur Verfügbarkeit von Modellen und zu Abschaltterminen findest du in der Übersicht zu eingestellten und auslaufenden Modellen.