Hide navigation sidebar
Hide table of contents sidebar
PTB has undergone significant changes in v20. Please read the documentation carefully and also check out the transition guide in the wiki.
Back to top
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`

  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 sender.

    - height (`int`) – Video height as defined by sender.

    - duration (`int`) – Duration of the video in seconds as defined by sender.

    - file_name (`str`, optional) – Original filename as defined by sender.

    - mime_type (`str`, optional) – MIME type of a file as defined by sender.

    - file_size (`int`, optional) – File size in bytes.

    - thumbnail (`telegram.PhotoSize`, optional) –

      Video thumbnail.

      New 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 sender.

    Type:

      `int`

  height

    Video height as defined by sender.

    Type:

      `int`

  duration

    Duration of the video in seconds as defined by sender.

    Type:

      `int`

  file_name

    Optional. Original filename as defined by sender.

    Type:

      `str`

  mime_type

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

    Type:

      `str`

  file_size

    Optional. File size in bytes.

    Type:

      `int`

  thumbnail

    Optional. Video thumbnail.

    New in version 20.2.

    Type:

      `telegram.PhotoSize`

  classmethod de_json(data, bot)

    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 –