telegram.InputMediaAudio

class telegram.InputMediaAudio(media: Union[str, IO, InputFile, pathlib.Path, telegram.files.audio.Audio], thumb: Union[str, IO, InputFile, pathlib.Path] = None, caption: str = None, parse_mode: Union[str, telegram.utils.helpers.DefaultValue] = <telegram.utils.helpers.DefaultValue object>, duration: int = None, performer: str = None, title: str = None, caption_entities: Union[List[telegram.messageentity.MessageEntity], Tuple[telegram.messageentity.MessageEntity, ...]] = 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.

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
Parameters:
  • media (str | filelike object | 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.
  • 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 | 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.

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.