Skip to main content
GET
Retrieve a video generation's status and result
Récupère le statut d’un job de génération de vidéo. Tant qu’il est pending ou processing, continue d’interroger ; une fois completed, la réponse porte la vidéo produite avec une url presigned valable 24 heures. Seuls les jobs créés par ton organisation sont visibles ; tout autre id renvoie 404 not_found.
Passe un webhook_url sur la requête vidéo 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

generation_id
string<uuid>
requis

Réponse

Successful Response

GET /videos/generations/{id} body (ADR §7.2).

created_at comes from the immutable credit-ledger row (the durable public submit record) and credits_used is that row's charge NET of any refund for the same job (SAM-1028); mode prefers the same source because the worker's completion path rewrites video_jobs.metadata.

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.

mode
string | null

image_to_video, text_to_video, or text_to_video_styled.

Exemple:

"image_to_video"

credits_used
integer | null

Net credits charged for this job, after any refunds.

Exemple:

80

video
PublicVideoAsset · object | null

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

error
string | null

Failure detail when status is failed; otherwise null.