Videos

Retrieve a video

Retrieve the Video object (status / progress). Always JSON — the rendered MP4 is downloaded from GET /v1/videos/{video_id}/content.

get/v1/videos/{video_id}

Request

video_idstring required

The video ID returned by POST /v1/videos.

The Video object.

idstring

Video ID, e.g. video_8a1f....

object'video'

modelstring

status'queued' | 'in_progress' | 'completed' | 'failed'

Job status.

progressinteger

Completion percentage (0–100).

sizestring

Output size (WxH), e.g. 640x640.

created_atinteger

Unix timestamp (seconds).

errorstring nullable

Error message when status is failed.

{
  "id": "video_8a1f2c3d4e5f6a7b8c9d0e1f"
}