Skip to content
Back to top
View this page

# 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)

  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.InputMediaVideo.media`

  - `telegram.InputPaidMediaVideo.media`

  - `telegram.Message.effective_attachment`

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

  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.

    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.

    Type:

      `int` | `datetime.timedelta`

  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`

  cover

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

    Added in version 21.11.

    Type:

      tuple[`telegram.PhotoSize`]

  start_timestamp

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

    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.

    Type:

      `int` | `datetime.timedelta`

  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 –