Jobs et attente bornée

Les opérations d'image sont des jobs durables. La première réponse contient l'objet job public complet et Location: /api/v1/jobs/{job_id}.

Lire un job

curl https://sci-draw.com/api/v1/jobs/job_012345 \
  -H 'Authorization: Bearer sd_YOUR_KEY'

Portée requise : jobs:read. Les jobs sont lus à la fois par identifiant et par appartenance au compte. Un job inexistant et un job appartenant à un autre compte renvoient tous deux 404 JOB_NOT_FOUND.

Cycle de vie des statuts

Statut	Signification
`queued`	accepté, en attente d'exécution
`processing`	traitement en cours
`succeeded`	`result.files` est disponible
`failed`	`error` contient un code public stable et un message
`canceled`	le job ne sera pas exécuté

Les statuts terminaux ne changent plus jamais. Interrogez les jobs non terminés en suivant la valeur Retry-After renvoyée par les requêtes de création ; deux secondes est la recommandation actuelle.

Attente bornée

Les points de terminaison de création acceptent Prefer: wait=N, où N est un entier de 1 à 30. Si le job devient terminal dans la fenêtre, le point de terminaison renvoie 200. S'il tourne encore à l'échéance, il renvoie le job courant avec 202. C'est adapté aux clients interactifs, mais les intégrations serveur doivent toujours conserver l'identifiant de job et être prêtes à interroger.

Résultat réussi

{
  "success": true,
  "data": {
    "id": "job_012345",
    "object": "image_job",
    "type": "image_generation",
    "status": "succeeded",
    "created_at": "2026-08-07T12:00:00.000Z",
    "completed_at": "2026-08-07T12:00:41.000Z",
    "credits_reserved":

Aucune réponse de job ne contient les prompts soumis, les références aux images sources, les identifiants internes, les détails d'exécution ou des diagnostics privés.

Lire un job

Cycle de vie des statuts

Attente bornée

Résultat réussi

Table des matières