Video¶

class telegram.Video(file_id, file_unique_id, width, height, duration, mime_type=None, file_size=None, file_name=None, thumbnail=None, cover=None, start_timestamp=None, qualities=None, *, api_kwargs=None)[source]¶

Bases: telegram.TelegramObject

This object represents a video file.

Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their file_unique_id is equal.

Use In

Available In

Changed in version 20.5: Removed the deprecated argument and attribute thumb.

Parameters:

file_id (str) – Identifier for this file, which can be used to download or reuse the file.
file_unique_id (str) – Unique identifier for this file, which is supposed to be the same over time and for different bots. Can’t be used to download or reuse the file.
width (int) – Video width as defined by the sender.
height (int) – Video height as defined by the sender.
duration (int | datetime.timedelta) –
Duration of the video in seconds as defined by the sender.

Changed in version v22.2: datetime.timedelta objects are accepted in addition to plain int values.
file_name (str, optional) – Original filename as defined by the sender.
mime_type (str, optional) – MIME type of a file as defined by the sender.
file_size (int, optional) – File size in bytes.
thumbnail (telegram.PhotoSize, optional) –
Video thumbnail.

Added in version 20.2.
cover (Sequence[telegram.PhotoSize], optional) –
Available sizes of the cover of the video in the message.

Added in version 21.11.
start_timestamp (int | datetime.timedelta, optional) –
Timestamp in seconds from which the video will play in the message .. versionadded:: 21.11

Changed in version v22.2: datetime.timedelta objects are accepted in addition to plain int values.
qualities (Sequence[telegram.VideoQuality], optional) –
List of available qualities of the video

Added in version 22.7.

file_id[source]¶

Identifier for this file, which can be used to download or reuse the file.

Type:: str

file_unique_id[source]¶

Unique identifier for this file, which is supposed to be the same over time and for different bots. Can’t be used to download or reuse the file.

Type:: str

width[source]¶

Video width as defined by the sender.

Type:: int

height[source]¶

Video height as defined by the sender.

Type:: int

duration[source]¶

Duration of the video in seconds as defined by the sender.

Deprecated since version v22.2: In a future major version this attribute will be of type datetime.timedelta. You can opt-in early by setting PTB_TIMEDELTA=true or PTB_TIMEDELTA=1 as an environment variable.