telegram.InputMediaAudio¶

class telegram.InputMediaAudio(media, thumb=None, caption=None, parse_mode=<telegram.utils.helpers.DefaultValue object>, duration=None, performer=None, title=None)¶

Bases: telegram.files.inputmedia.InputMedia

Represents an audio file to be treated as music to be sent.

type¶

audio.

Type:	`str`

media¶

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

Type:	`str` \| filelike object \| `telegram.Audio`

caption¶

Optional. Caption of the audio 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`

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 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.Document object to send.
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 in telegram.ParseMode for the available modes.
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, 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.Audio for the media attribute. It will take the duration, performer and title from that video, unless otherwise specified with the optional arguments.