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, *, 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.

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) – Duration of the video in seconds as defined by the sender.

  • 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, optional) – Timestamp in seconds from which the video will play in the message .. versionadded:: 21.11

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.

Type:

int

file_name[source]

Optional. Original filename as defined by the sender.

Type:

str

mime_type[source]

Optional. MIME type of a file as defined by the sender.

Type:

str

file_size[source]

Optional. File size in bytes.

Type:

int

thumbnail[source]

Optional. Video thumbnail.

Added in version 20.2.

Type:

telegram.PhotoSize

cover[source]

Optional, Available sizes of the cover of the video in the message.

Added in version 21.11.

Type:

tuple[telegram.PhotoSize]

start_timestamp[source]

Optional, Timestamp in seconds from which the video will play in the message .. versionadded:: 21.11

Type:

int

__dir__()[source]

Default dir() implementation.

__format__(format_spec, /)[source]

Default object formatter.

Return str(self) if format_spec is empty. Raise TypeError otherwise.

__ge__(value, /)[source]

Return self>=value.

__getattribute__(name, /)[source]

Return getattr(self, name).

__gt__(value, /)[source]

Return self>value.

classmethod __init_subclass__()[source]

This method is called when a class is subclassed.

The default implementation does nothing. It may be overridden to extend subclasses.

__le__(value, /)[source]

Return self<=value.

__lt__(value, /)[source]

Return self<value.

__ne__(value, /)[source]

Return self!=value.

classmethod __new__(*args, **kwargs)[source]
__reduce__()[source]

Helper for pickle.

__reduce_ex__(protocol, /)[source]

Helper for pickle.

__sizeof__()[source]

Size of object in memory, in bytes.

__str__()[source]

Return str(self).

classmethod __subclasshook__(object, /)[source]

Abstract classes can override this to customize issubclass().

This is invoked early on by abc.ABCMeta.__subclasscheck__(). It should return True, False or NotImplemented. If it returns NotImplemented, the normal algorithm is used. Otherwise, it overrides the normal algorithm (and the outcome is cached).

classmethod de_json(data, bot=None)[source]

See telegram.TelegramObject.de_json().

async get_file(*, read_timeout=None, write_timeout=None, connect_timeout=None, pool_timeout=None, api_kwargs=None)[source]

Convenience wrapper over telegram.Bot.get_file()

For the documentation of the arguments, please see telegram.Bot.get_file().

Returns:

telegram.File

Raises:

telegram.error.TelegramError