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: telegram.files.inputmedia.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 | 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 in telegram.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

telegram.InputFile