telegram.Audio¶

class telegram.Audio(file_id: str, file_unique_id: str, duration: int, performer: str = None, title: str = None, mime_type: str = None, file_size: int = None, thumb: telegram.files.photosize.PhotoSize = None, bot: Bot = None, file_name: str = None, **_kwargs)¶

Bases: telegram.base.TelegramObject

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

Objects of this class are comparable in terms of equality. Two objects of this class are considered equal, if their file_unique_id is equal.

file_id¶

Identifier for this file.

Type:	`str`

file_unique_id¶

Unique identifier for this file, which is supposed to be the same over time and for different bots. Can’t be used to download or reuse the 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`

file_name¶

Optional. Original filename as defined by sender.

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) – Identifier for this file, which can be used to download or reuse the file.
file_unique_id (str) – Unique identifier for this file, which is supposed to be the same over time and for different bots. Can’t be used to download or reuse the 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.
file_name (str, optional) – Original filename as defined by sender.
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: int = None, api_kwargs: Dict[str, Any] = None) → File¶

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). api_kwargs (`dict`, optional) – Arbitrary keyword arguments to be passed to the Telegram API.
Returns:	`telegram.File`
Raises:	`telegram.TelegramError`