telegram.InputMediaVideo

class telegram.InputMediaVideo(media, caption=None, width=None, height=None, duration=None, supports_streaming=None, parse_mode=<telegram.utils.helpers.DefaultValue object>, thumb=None)

Bases: telegram.files.inputmedia.InputMedia

Represents a video to be sent.

type

video.

Type:str
media

Video file to send. Pass a file_id as String to send an video file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get an video file from the Internet, or upload a new one using multipart/form-data. Lastly you can pass an existing telegram.Video object to send.

Type:str | filelike object | telegram.Video
caption

Optional. Caption of the video to be sent, 0-1024 characters after entities parsing.

Type:str
parse_mode

Optional. Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in the media caption. See the constants in telegram.ParseMode for the available modes.

Type:str
width

Optional. Video width.

Type:int
height

Optional. Video height.

Type:int
duration

Optional. Video duration.

Type:int
supports_streaming

Optional. Pass True, if the uploaded video is suitable for streaming.

Type:bool
thumb

Optional. Thumbnail of the file sent. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail’s width and height should not exceed 320. Ignored if the file is not is passed as a string or file_id.

Type:filelike object
Parameters:
  • media (str) – File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet. Lastly you can pass an existing telegram.Video object to send.
  • caption (str, optional) – Caption of the video to be sent, 0-1024 characters after entities parsing.
  • parse_mode (str, optional) – Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in the media caption. See the constants in telegram.ParseMode for the available modes.
  • width (int, optional) – Video width.
  • height (int, optional) – Video height.
  • duration (int, optional) – Video duration.
  • supports_streaming (bool, optional) – Pass True, if the uploaded video is suitable for streaming.
  • thumb (filelike object, optional) – Thumbnail of the file sent. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail’s width and height should not exceed 320. Ignored if the file is not is passed as a string or file_id.

Note

When using a telegram.Video for the media attribute. It will take the width, height and duration from that video, unless otherwise specified with the optional arguments.