telegram.InputMediaVideo
- class telegram.InputMediaVideo(media, caption=None, width=None, height=None, duration=None, supports_streaming=None, parse_mode=None, thumb=None, caption_entities=None, filename=None)
Bases:
telegram.files.inputmedia.InputMedia
Represents a video to be sent.
Note
When using a
telegram.Video
for themedia
attribute. It will take the width, height and duration from that video, unless otherwise specified with the optional arguments.thumb
will be ignored for small video files, for which Telegram can easily generate thumb nails. However, this behaviour is undocumented and might be changed by Telegram.
- Parameters
media (
str
| filelike object |bytes
|pathlib.Path
|telegram.Video
) –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.Changed in version 13.2: Accept
bytes
as input.filename (
str
, optional) –Custom file name for the video, when uploading a new file. Convenience parameter, useful e.g. when sending files generated by the
tempfile
module.New in version 13.1.
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 intelegram.ParseMode
for the available modes.caption_entities (List[
telegram.MessageEntity
], optional) – List of special entities that appear in the caption, which can be specified instead of parse_mode.width (
int
, optional) – Video width.height (
int
, optional) – Video height.duration (
int
, optional) – Video duration.supports_streaming (
bool
, optional) – PassTrue
, if the uploaded video is suitable for streaming.thumb (filelike object |
bytes
|pathlib.Path
, 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.
Changed in version 13.2: Accept
bytes
as input.
- type
video
.- Type
str
- media
Video file to send.
- Type
str
|telegram.InputFile
- caption
Optional. Caption of the document to be sent.
- Type
str
- parse_mode
Optional. The parse mode to use for text formatting.
- Type
str
- caption_entities
Optional. List of special entities that appear in the caption.
- Type
List[
telegram.MessageEntity
]
- 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 to send.
- Type