Documentazione APIJob e attesa limitata
Interrogare il lavoro asincrono e leggere risultati ripuliti
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
| Stato | Significato |
|---|---|
queued | accettato e in attesa di esecuzione |
processing | lavorazione in corso |
succeeded | result.files è disponibile |
failed | error contiene un codice pubblico stabile e un messaggio |
canceled | il job non verrà eseguito |
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":
Nessuna risposta di job contiene i prompt inviati, riferimenti alle immagini di partenza, identificatori interni, dettagli di esecuzione o diagnostica privata.