GET
/
v2
/
videos
/
{video_id}
Get Video
curl --request GET \
  --url https://tavusapi.com/v2/videos/{video_id} \
  --header 'x-api-key: <api-key>'
{
  "video_id": "",
  "video_name": "<string>",
  "status": "ready",
  "data": {
    "script": "<string>"
  },
  "download_url": "<string>",
  "stream_url": "<string>",
  "hosted_url": "<string>",
  "status_details": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>",
  "still_image_thumbnail_url": "<string>",
  "gif_thumbnail_url": "<string>"
}

Authorizations

x-api-key
string
header
required

Path Parameters

video_id
string
required

A unique identifier for the video.

Query Parameters

verbose
boolean

If set to true, the response will include additional video data such as the thumbnail image and gif links.

Response

OK

video_id
string

A unique identifier for the video.

Example:

""

video_name
string

The name of the video.

status
string

The status of the video. Possible values: queued, generating, ready, deleted, error.

Example:

"ready"

data
object
download_url
string

A direct link to download your generated video.

stream_url
string

A direct link to stream your generated video.

hosted_url
string

A direct link to view your generated video, hosted by Tavus.

status_details
string

A detailed status of the video.

created_at
string

The date and time the video was created.

updated_at
string

The date and time of when the video was last updated.

still_image_thumbnail_url
string

Included if the verbose query parameter is set to true. A link to an image thumbnail of the video.

gif_thumbnail_url
string

Included if the verbose query parameter is set to true. A link to a gif thumbnail of the video.