Vai al contenuto principale
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.

Blocchi di compliance

Ogni output raster passa per la pipeline di compliance di Samsa (firma C2PA e watermarking — vedi Provenienza dei contenuti) prima che l’API lo consegni. processing significa che gli output sono ancora in arrivo — continua a interrogare. Quando un output non supera quella pipeline in modo permanente, il job lo riporta: Ogni voce di blocked_images è { "id", "reason" }. reason è compliance_failed_signing (firma C2PA non riuscita), compliance_failed_storage, compliance_failed_watermark o missing_provenance_state. Un output bloccato non diventa mai scaricabile, quindi failed è terminale — smetti di interrogare.
Esempio: tutti gli output bloccati
credits_used non cambia per un blocco di compliance. Gli stessi campi e le stesse regole valgono per i job di Magic Edit, img2img, variazioni e resize, e per lo strumento MCP get_job_status.
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 (Authorization: Bearer samsa_sk_...) or OAuth 2.1 access token (Authorization: Bearer samsa_at_...).

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. A job whose outputs ALL failed the compliance pipeline (for example C2PA signing) is failed with error starting delivery_blocked_compliance — a terminal state, so stop polling.

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

"completed"

created_at
string<date-time>
obbligatorio

When the job was submitted.

credits_used
integer | null

Net credits charged for this job, after any refunds.

Esempio:

5

images
PublicImageAsset · object[]

Produced images (presigned URLs); empty until completed.

blocked_images
PublicBlockedImage · object[]

Produced images that are permanently withheld because they failed the compliance pipeline, each with its compliance code. Empty unless a completed job delivered only some of its outputs, or a failed job was blocked by compliance.

error
string | null

Failure detail when status is failed; otherwise null. A compliance block reads delivery_blocked_compliance: <codes>, where <codes> are the blocked_images reasons.

Esempio:

"delivery_blocked_compliance: compliance_failed_signing"