Hide navigation sidebar
Hide table of contents sidebar
Skip to content
Back to top
View this page
Toggle table of contents sidebar

# Video

class telegram.Video(file_id, file_unique_id, width, height, duration, mime_type=None, file_size=None, file_name=None, thumbnail=None, *, api_kwargs=None)

  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

  - `telegram.Bot.get_file()`

  - `telegram.Bot.send_video()`

  Available In

  - `telegram.ExternalReplyInfo.video`

  - `telegram.Message.video`

  - `telegram.PaidMediaVideo.video`

  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.

  file_id

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

    Type:

      `str`

  file_unique_id

    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

    Video width as defined by the sender.

    Type:

      `int`

  height

    Video height as defined by the sender.

    Type:

      `int`

  duration

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

    Type:

      `int`

  file_name

    Optional. Original filename as defined by the sender.

    Type:

      `str`

  mime_type

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

    Type:

      `str`

  file_size

    Optional. File size in bytes.

    Type:

      `int`

  thumbnail

    Optional. Video thumbnail.

    Added in version 20.2.

    Type:

      `telegram.PhotoSize`

  classmethod de_json(data, bot=None)

    See `telegram.TelegramObject.de_json()`.

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

    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 –