Skip to main content
GET
Retrieve an upscale job's status and result
Récupère le statut d’un job d’upscale. Tant qu’il est pending ou processing, continue d’interroger ; une fois completed, la réponse porte un seul objet résultat image avec une presigned url valable 24 heures. Seuls les jobs créés par ton organisation sont visibles ; tout autre id renvoie 404 not_found. Requiert le scope images.transform.

Exemple : job terminé

L’upscale renvoie une image — un objet résultat de format dérivé (pas le tableau images utilisé par la génération), portant sa propre id stable, la source_image_id dont il dérive, le model qui l’a produit et une resolution_class :
200 OK
Passe un webhook_url sur la requête d’upscale d’origine pour recevoir un callback signé au lieu d’interroger. Voir Webhooks.

Autorisations

Authorization
string
header
requis

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

Paramètres de chemin

upscale_id
string<uuid>
requis

Réponse

Successful Response

GET /images/upscales/{id} body (SAM-819 / S8.7 — ADR §7.2).

The standard async-job envelope plus ONE nullable image result object (an image_formats derivative, built by the S8.2 egress builder). created_at is the job's submit time from the credit ledger (the image_generation_tasks table has no created_at column).

id
string<uuid>
requis
status
enum<string>
requis

pending, processing, completed, failed, or cancelled.

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:

10

image
PublicImageFormatResult · object | null

The produced upscale (presigned URL); null until completed.

error
string | null

Failure detail when status is failed; otherwise null.