Job e attesa limitata

Le operazioni sulle immagini sono job durevoli. La prima risposta contiene l'oggetto job pubblico completo e Location: /api/v1/jobs/{job_id}.

Leggere un job

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

Ambito richiesto: jobs:read. I job si leggono per ID e per appartenenza all'account. Un job inesistente e un job di un altro account restituiscono entrambi 404 JOB_NOT_FOUND.

Ciclo degli stati

Gli stati terminali non cambiano più. Interroga i job non terminali usando il valore Retry-After restituito dalle richieste di creazione; al momento si raccomandano due secondi.

Attesa limitata

Gli endpoint di creazione accettano Prefer: wait=N, dove N è un intero da 1 a 30. Se il job diventa terminale entro la finestra, l'endpoint restituisce 200. Se alla scadenza è ancora in esecuzione, restituisce il job corrente con 202. Va bene per client interattivi, ma le integrazioni lato server dovrebbero sempre salvare l'ID del job ed essere pronte a fare polling.

Risultato riuscito

{
  "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": 5,
    "credits_consumed": 5,
    "result": {
      "files": [{
        "id": "file_012345",
        "url": "https://sci-draw.com/generated/example.png",
        "format": "png",
        "mime_type": "image/png",
        "width": 2048,
        "height": 1152
      }]
    },
    "error": null
  }
}

Nessuna risposta di job contiene i prompt inviati, riferimenti alle immagini di partenza, identificatori interni, dettagli di esecuzione o diagnostica privata.