Passer au contenu principal
GET
Retrieve an image edit's status and results
Récupère le statut d’un job Magic Edit. Tant qu’il est pending ou processing, continue d’interroger ; une fois completed, la réponse porte les images éditées, chacune avec une url presigned valable 24 heures. Seuls les jobs d’édition créés par ton organisation sont visibles ; tout autre id renvoie 404 not_found.
Blocages compliance. Si tous les outputs ont échoué dans le pipeline de conformité (par exemple la signature C2PA), le job est failed avec error delivery_blocked_compliance: <codes> — terminal, donc arrête d’interroger. Si certains seulement y ont échoué, le job est completed : images contient les outputs livrables et blocked_images liste les autres sous la forme { id, reason }. Voir Récupérer une génération d’image.
Passe un webhook_url sur la requête d’édition d’origine pour recevoir un callback signé au lieu d’interroger. Voir Webhooks.

Autorisations

Authorization
string
header
requis

Organization API key (Authorization: Bearer samsa_sk_...) or OAuth 2.1 access token (Authorization: Bearer samsa_at_...).

Paramètres de chemin

edit_id
string<uuid>
requis

Réponse

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>
requis
status
enum<string>
requis

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.

Options disponibles:
pending,
processing,
completed,
failed,
cancelled
Exemple:

"completed"

created_at
string<date-time>
requis

When the job was submitted.

credits_used
integer | null

Net credits charged for this job, after any refunds.

Exemple:

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.

Exemple:

"delivery_blocked_compliance: compliance_failed_signing"