Download a video

Returns a video generation task by id.

get/v1/videos/{id}

Request

  • Base URL: https://api.octen.ai
  • URL: https://api.octen.ai/v1/videos/{id}
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Path parameters

idstring required

The task id returned by the Video Generation API.

Response

Successful video task response

idstring required

Unique task id, used to download the video.

modelstring required

The model used for this task.

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

Task state.

createdinteger required

Unix timestamp in seconds when the task was created.

video_urlstring

Signed download URL for the video file, present when status is completed. Valid for 7 days after generation.

expires_atinteger

Unix timestamp in seconds when video_url expires. Present when status is completed.

durationinteger

Length of the generated video in seconds. Present when status is completed.

resolutionstring

Resolution of the generated video. Present when status is completed.

errorstring

Failure reason, present when status is failed.

codestring

Machine-readable failure code, present when status is failed.

Changes

No recorded changes to this operation across all 1 revision of this API.