Skip to main content
GET
Retrieve an image generation's status and results
Recupera lo stato di un job di generazione. Mentre è pending o processing, continua a interrogare; una volta completed, la risposta include le immagini prodotte, ognuna con un url presigned valido per 24 ore — scarica gli asset prima che scadano. Sono visibili solo i job creati dalla tua organizzazione; qualsiasi altro id restituisce 404 not_found.
Preferisci il push all’interrogazione? Passa un webhook_url nella richiesta di generazione originale per ricevere una callback firmata nel momento in cui il job raggiunge uno stato terminale. Vedi Webhook.

Autorizzazioni

Authorization
string
header
obbligatorio

Organization API key as a bearer token: Authorization: Bearer samsa_sk_....

Parametri del percorso

generation_id
string<uuid>
obbligatorio

Risposta

Successful Response

GET /images/generations/{id} body (ADR §7.2).

created_at is the job's submit time, sourced from the credit ledger — the image_generation_tasks table has no created_at column.

id
string<uuid>
obbligatorio
status
enum<string>
obbligatorio

pending, processing, completed, failed, or cancelled.

Opzioni disponibili:
pending,
processing,
completed,
failed,
cancelled
Esempio:

"completed"

created_at
string<date-time>
obbligatorio

When the job was submitted.

credits_used
integer | null

Credits charged for this job.

Esempio:

5

images
PublicImageAsset · object[]

Produced images (presigned URLs); empty until completed.

error
string | null

Failure detail when status is failed; otherwise null.