For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navigation principale
Theme

Mode arrière-plan

Exécutez des tâches de longue durée de manière asynchrone en arrière-plan.

Des agents comme Codex et la recherche approfondie montrent que les modèles de raisonnement peuvent prendre plusieurs minutes pour résoudre des problèmes complexes. Le mode arrière-plan permet d’exécuter de manière fiable des tâches de longue durée avec des modèles comme GPT-5.2 et GPT-5.2 Pro, sans avoir à se soucier des dépassements de délai ou d’autres problèmes de connexion.

Le mode arrière-plan lance ces tâches de manière asynchrone. Vous pouvez ensuite interroger les objets de réponse à intervalles réguliers pour suivre l’état des requêtes. Pour lancer la génération d’une réponse en arrière-plan, envoyez une requête à l’API en définissant background sur true.

Dans les projets soumis à la politique de non-conservation des données (ZDR), les requêtes en arrière-plan s’exécutent avec store=false. Les données de réponse sont stockées temporairement sur disque pendant environ 10 minutes pour permettre l’exécution asynchrone et la consultation périodique de la réponse.

Pour les projets qui utilisent la surveillance modifiée des abus, y compris sa version renforcée, les règles de conservation standard s’appliquent aux requêtes au premier plan lorsque store est omis ou défini sur true. Les réponses générées en arrière-plan sont conservées au-delà de la période de consultation uniquement si vous indiquez explicitement store=true. Si vous omettez store ou le définissez sur false pour une requête en arrière-plan, la réponse est supprimée au bout d’environ 10 minutes.

Générer une réponse en arrière-plan
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)

Suivi des réponses en arrière-plan

Pour vérifier l’état d’une requête en arrière-plan, utilisez le point de terminaison GET de l’API Responses. Interrogez-le régulièrement tant que la requête est dans l’état queued ou in_progress. Dès que la requête se trouve dans un autre état, elle a atteint un état final (terminal).

Récupérer une réponse en cours de génération en arrière-plan
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}")

Annulation d’une réponse en arrière-plan

Vous pouvez également annuler une réponse en cours de génération, comme dans cet exemple.

Annuler une réponse en cours de génération
import os

from openai import OpenAI

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

resp = client.responses.cancel(response_id)

print(resp.status)

L’annulation est idempotente. Si vous la demandez plusieurs fois, les appels suivants renvoient simplement l’objet Response final.

Diffusion en continu d’une réponse en arrière-plan

Vous pouvez créer un objet Response en arrière-plan et commencer immédiatement à recevoir ses événements en continu. Cette option est utile si vous pensez que le client risque de se déconnecter du flux et que vous souhaitez pouvoir le reprendre plus tard. Pour cela, créez un objet Response en définissant background et stream sur true. Tenez à jour un « curseur » à partir du sequence_number reçu dans chaque événement du flux.

Actuellement, le premier token d’une réponse en arrière-plan arrive plus tard que celui d’une réponse synchrone. Nous travaillons à réduire cet écart de latence dans les semaines à venir.

Générer et diffuser en continu une réponse en arrière-plan
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"

Limites

  1. Les requêtes en arrière-plan peuvent utiliser store=false, mais les données de réponse sont stockées temporairement pour permettre l’exécution asynchrone et la consultation périodique de la réponse.
  2. Pour annuler une réponse synchrone, fermez la connexion.
  3. Vous pouvez ouvrir un nouveau flux pour une réponse en arrière-plan uniquement si vous avez créé cette réponse avec stream=true.