telegram.InputMedia¶
- class telegram.InputMedia(media_type, media, caption=None, caption_entities=None, parse_mode=None, *, api_kwargs=None)[source]¶
Bases:
telegram.TelegramObject
Base class for Telegram InputMedia Objects.
Changed in version 20.0:: Added arguments and attributes
type
,media
,caption
,caption_entities
,parse_mode
.- Parameters
media_type (
str
) – Type of media that the instance represents.media (
str
| file object |bytes
|pathlib.Path
|telegram.Animation
|telegram.Audio
|telegram.Document
|telegram.PhotoSize
|telegram.Video
) – File to send. Pass afile_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 inlocal_mode
, passing the path of the file (as string orpathlib.Path
object) is supported as well. Lastly you can pass an existing telegram media object of the corresponding type to send.caption (
str
, optional) – Caption of the media to be sent, 0-1024
characters after entities parsing.caption_entities (List[
telegram.MessageEntity
], optional) – List of special entities that appear in the caption, which can be specified instead ofparse_mode
.parse_mode (
str
, optional) – Mode for parsing entities. Seetelegram.constants.ParseMode
and formatting options for more details.
Optional. Caption of the media to be sent.
- Type
Optional. List of special entities that appear in the caption.
- Type
List[
telegram.MessageEntity
]