Vai al contenuto principale
GET
Retrieve an image edit's status and results
Recupera lo stato di un job Magic Edit. Mentre è pending o processing, continua a interrogare; una volta completed, la risposta include le immagini modificate, ognuna con un url presigned valido per 24 ore. Sono visibili solo i job di modifica creati dalla tua organizzazione; qualsiasi altro id restituisce 404 not_found.
Blocchi di compliance. Se tutti gli output non hanno superato la pipeline di compliance (per esempio la firma C2PA), il job è failed con error delivery_blocked_compliance: <codes> — terminale, quindi smetti di interrogare. Se solo alcuni non l’hanno superata, il job è completed: images contiene gli output consegnabili e blocked_images elenca gli altri come { id, reason }. Vedi Ottieni una generazione di immagini.
Passa un webhook_url nella richiesta di modifica originale per ricevere una callback firmata invece di interrogare. 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

edit_id
string<uuid>
obbligatorio

Risposta

Successful Response

GET /images/edits/{id} body — same contract as image generation.

Both are backed by image_generation_tasks; a distinct name for the docs.

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"