telegram.InputMediaAudio

class telegram.InputMediaAudio(*args, **kwargs)[source]

Bases: telegram.InputMedia

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

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.

Parameters
  • media (str | file object | bytes | pathlib.Path | telegram.Audio) –

    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.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 in telegram.constants.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 (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.

    Changed in version 13.2: Accept bytes as input.

type[source]

'audio'.

Type

str

media[source]

Audio file to send.

Type

str | telegram.InputFile

caption[source]

Optional. Caption of the document to be sent.

Type

str

parse_mode[source]

Optional. The parse mode to use for text formatting.

Type

str

caption_entities[source]

Optional. List of special entities that appear in the caption.

Type

List[telegram.MessageEntity]

duration[source]

Duration of the audio in seconds.

Type

int

performer[source]

Optional. Performer of the audio as defined by sender or by audio tags.

Type

str

title[source]

Optional. Title of the audio as defined by sender or by audio tags.

Type

str

thumb[source]

Optional. Thumbnail of the file to send.

Type

telegram.InputFile