Skip to main content
GET
Retrieve an image generation's status and results
Récupère le statut d’un job de génération. Tant qu’il est pending ou processing, continue d’interroger ; une fois completed, la réponse porte les images produites, chacune avec une url presigned valable 24 heures — télécharge les assets avant leur expiration. Seuls les jobs créés par ton organisation sont visibles ; tout autre id renvoie 404 not_found.
Tu préfères le push au polling ? Passe un webhook_url sur la requête de génération d’origine pour recevoir un callback signé dès que le job atteint un statut terminal. Voir Webhooks.

Autorisations

Authorization
string
header
requis

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

Paramètres de chemin

generation_id
string<uuid>
requis

Réponse

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>
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

Credits charged for this job.

Exemple:

5

images
PublicImageAsset · object[]

Produced images (presigned URLs); empty until completed.

error
string | null

Failure detail when status is failed; otherwise null.