Skip to main content
GET
Retrieve a video generation's status and result
Recupera lo stato di un job di generazione di video. Mentre è pending o processing, continua a interrogare; una volta completed, la risposta include il video prodotto con un url presigned valido per 24 ore. Sono visibili solo i job creati dalla tua organizzazione; qualsiasi altro id restituisce 404 not_found.
Passa un webhook_url nella richiesta video originale per ricevere una callback firmata invece di interrogare. Vedi Webhook.

Autorizzazioni

Authorization
string
header
obbligatorio

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

Parametri del percorso

generation_id
string<uuid>
obbligatorio

Risposta

Successful Response

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

created_at and credits_used come from the immutable credit-ledger row (the durable public submit record); mode prefers the same source because the worker's completion path rewrites video_jobs.metadata.

id
string<uuid>
obbligatorio
status
enum<string>
obbligatorio

pending, processing, completed, failed, or cancelled.

Opzioni disponibili:
pending,
processing,
completed,
failed,
cancelled
Esempio:

"completed"

created_at
string<date-time>
obbligatorio

When the job was submitted.

mode
string | null

image_to_video, text_to_video, or text_to_video_styled.

Esempio:

"image_to_video"

credits_used
integer | null

Credits charged for this job.

Esempio:

80

video
PublicVideoAsset · object | null

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

error
string | null

Failure detail when status is failed; otherwise null.