InputPaidMediaVideo¶

class telegram.InputPaidMediaVideo(media, thumbnail=None, width=None, height=None, duration=None, supports_streaming=None, *, api_kwargs=None)[source]¶

Bases: telegram.InputPaidMedia

The paid media to send is a video.

Use In

telegram.Bot.send_paid_media()

See also

Working with Files and Media

Added in version 21.4.

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.
thumbnail will be ignored for small video files, for which Telegram can easily generate thumbnails. However, this behaviour is undocumented and might be changed by Telegram.

Parameters:

media (str | file object | InputFile | bytes | pathlib.Path | telegram.Video) – File to send. Pass a file_id as String to send a file that exists on the Telegram servers (recommended), pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one. To upload a file, you can either pass a file object (e.g. open("filename", "rb")) or the file contents as bytes. If the bot is running in local_mode, passing the path of the file (as string or pathlib.Path object) is supported as well. Lastly you can pass an existing telegram.Video object to send.
thumbnail (file object | bytes | pathlib.Path | str, optional) – Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. 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 uploaded using multipart/form-data. Thumbnails can’t be reused and can be only uploaded as a new file. To upload a file, you can either pass a file object (e.g. open("filename", "rb")) or the file contents as bytes. If the bot is running in local_mode, passing the path of the file (as string or pathlib.Path object) is supported as well.
width (int, optional) – Video width.
height (int, optional) – Video height.
duration (int, optional) – Video duration in seconds.
supports_streaming (bool, optional) – Pass True, if the uploaded video is suitable for streaming.

type[source]¶

Type of the media, always 'video'.

Type:: str

media[source]¶

Video to send.

Type:: str | telegram.InputFile

thumbnail[source]¶

Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. 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 uploaded using multipart/form-data. Thumbnails can’t be reused and can be only uploaded as a new file.