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

Hintergrundmodus

Führe lang laufende Aufgaben asynchron im Hintergrund aus.

Agenten wie Codex und Deep Research zeigen, dass Reasoning-Modelle mehrere Minuten brauchen können, um komplexe Probleme zu lösen. Im Hintergrundmodus kannst du lang laufende Aufgaben mit Modellen wie GPT-5.2 und GPT-5.2 Pro zuverlässig ausführen, ohne dir Gedanken über Zeitüberschreitungen oder andere Verbindungsprobleme machen zu müssen.

Der Hintergrundmodus startet diese Aufgaben asynchron. Du kannst die Antwortobjekte regelmäßig abrufen, um den aktuellen Status zu prüfen. Um eine Antwort im Hintergrund generieren zu lassen, sende eine API-Anfrage, in der du background auf true setzt.

Für Hintergrundanfragen aus Projekten mit der Einstellung „Keine Datenaufbewahrung“ (ZDR) gilt store=false. Die API speichert die Antwortdaten für etwa 10 Minuten auf einem Datenträger, um die asynchrone Ausführung und die Statusabfrage zu ermöglichen.

Für Projekte mit Modified Abuse Monitoring, einschließlich der erweiterten Variante, gelten bei Vordergrundanfragen die regulären Aufbewahrungsfristen, wenn du store weglässt oder auf true setzt. Antworten auf Hintergrundanfragen bleiben über den Abfragezeitraum hinaus nur gespeichert, wenn du ausdrücklich store=true angibst. Lässt du store bei einer Hintergrundanfrage weg oder setzt du es auf false, löscht die API die Antwort nach etwa 10 Minuten.

Antwort im Hintergrund generieren
from openai import OpenAI

client = OpenAI()

resp = client.responses.create(
    model="gpt-6-astra",
    input="Write a very long novel about otters in space.",
    background=True,
)

print(resp.status)

Status von Hintergrundantworten abfragen

Um den Status einer Hintergrundanfrage zu prüfen, verwende den GET-Endpunkt für Responses. Frage den Status regelmäßig ab, solange die Anfrage den Status queued oder in_progress hat. Sobald die Anfrage einen anderen Status hat, hat sie einen Endzustand erreicht.

Eine Antwort abrufen, die im Hintergrund generiert wird
from openai import OpenAI
from time import sleep

client = OpenAI()

resp = client.responses.create(
    model="gpt-6-astra",
    input="Write a very long novel about otters in space.",
    background=True,
)

while resp.status in {"queued", "in_progress"}:
    print(f"Current status: {resp.status}")
    sleep(2)
    resp = client.responses.retrieve(resp.id)

print(f"Final status: {resp.status}\nOutput:\n{resp.output_text}")

Generierung einer Hintergrundantwort abbrechen

So kannst du die Generierung einer Antwort abbrechen, während sie noch läuft.

Laufende Antwortgenerierung abbrechen
import os

from openai import OpenAI

response_id = os.environ["OPENAI_RESPONSE_ID"]
client = OpenAI()

resp = client.responses.cancel(response_id)

print(resp.status)

Der Abbruch ist idempotent. Jeder weitere Aufruf gibt das endgültige Response-Objekt zurück.

Hintergrundantwort streamen

Du kannst ein Response-Objekt im Hintergrund erstellen und seine Ereignisse sofort als Stream empfangen. Das kann hilfreich sein, wenn du damit rechnest, dass der Client die Verbindung zum Stream verliert, und du den Stream später fortsetzen möchtest. Erstelle dazu ein Response-Objekt und setze sowohl background als auch stream auf true. Halte die aktuelle Position im Stream mit einem „Cursor“ fest. Verwende dafür die sequence_number, die du mit jedem Ereignis im Stream erhältst.

Bei einer Hintergrundantwort dauert es derzeit länger als bei einer synchronen Antwort, bis du das erste Token erhältst. Wir arbeiten daran, diesen Zeitunterschied in den kommenden Wochen zu verringern.

Hintergrundantwort generieren und streamen
curl https://api.openai.com/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-d '{
  "model": "gpt-6-astra",
  "input": "Write a very long novel about otters in space.",
  "background": true,
  "stream": true
}'

// To resume:
curl "https://api.openai.com/v1/responses/resp_123?stream=true&starting_after=42" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OPENAI_API_KEY"

Einschränkungen

  1. Bei Hintergrundanfragen kannst du store=false verwenden. Die API speichert die Antwortdaten dennoch vorübergehend, um die asynchrone Ausführung und die Statusabfrage zu ermöglichen.
  2. Um die Generierung einer synchronen Antwort abzubrechen, beende die Verbindung.
  3. Du kannst für eine Hintergrundantwort nur dann einen neuen Stream starten, wenn du sie mit stream=true erstellt hast.