telegram.InputMediaAudio
- class telegram.InputMediaAudio(media, thumb=None, caption=None, parse_mode=None, duration=None, performer=None, title=None, caption_entities=None, filename=None)
Bases:
InputMedia
Represents an audio file to be treated as music to be sent.
Note
When using a
telegram.Audio
for themedia
attribute. It will take the duration, performer and title from that video, unless otherwise specified with the optional arguments.- Parameters:
media (
str
| filelike object |bytes
|pathlib.Path
|telegram.Audio
) –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.Audio
object to send.Changed in version 13.2: Accept
bytes
as input.filename (
str
, optional) –Custom file name for the audio, 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 audio 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.duration (
int
) – Duration of the audio in seconds as defined by sender.performer (
str
, optional) – Performer of the audio as defined by sender or by audio tags.title (
str
, optional) – Title of the audio as defined by sender or by audio tags.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
audio
.- Type:
str
- media
Audio 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
]
- duration
Duration of the audio in seconds.
- Type:
int
- performer
Optional. Performer of the audio as defined by sender or by audio tags.
- Type:
str
- title
Optional. Title of the audio as defined by sender or by audio tags.
- Type:
str
- thumb
Optional. Thumbnail of the file to send.
- Type: