telegram.Audio

class telegram.Audio(file_id, duration, performer=None, title=None, mime_type=None, file_size=None, thumb=None, bot=None, **kwargs)

Bases: telegram.base.TelegramObject

This object represents an audio file to be treated as music by the Telegram clients.

file_id

Unique identifier for this file.

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
mime_type

Optional. MIME type of the file as defined by sender.

Type:str
file_size

Optional. File size.

Type:int
thumb

Optional. Thumbnail of the album cover to which the music file belongs

Type:telegram.PhotoSize
bot

Optional. The Bot to use for instance methods.

Type:telegram.Bot
Parameters:
  • file_id (str) – Unique identifier for this file.
  • 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.
  • mime_type (str, optional) – MIME type of the file as defined by sender.
  • file_size (int, optional) – File size.
  • thumb (telegram.PhotoSize, optional) – Thumbnail of the album cover to which the music file belongs
  • bot (telegram.Bot, optional) – The Bot to use for instance methods.
  • **kwargs (dict) – Arbitrary keyword arguments.
get_file(timeout=None, **kwargs)

Convenience wrapper over telegram.Bot.get_file

Parameters:
  • timeout (int | float, optional) – If this value is specified, use it as the read timeout from the server (instead of the one specified during creation of the connection pool).
  • **kwargs (dict) – Arbitrary keyword arguments.
Returns:

telegram.File

Raises:

telegram.TelegramError