Audio

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

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

Fields

FieldTypeRequiredDescription
file_idStringAlwaysIdentifier for this file, which can be used to download or reuse the file
file_unique_idStringAlwaysUnique 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.
durationIntegerAlwaysDuration of the audio in seconds as defined by the sender
performerStringOptionalPerformer of the audio as defined by the sender or by audio tags
titleStringOptionalTitle of the audio as defined by the sender or by audio tags
file_nameStringOptionalOriginal filename as defined by the sender
mime_typeStringOptionalMIME type of the file as defined by the sender
file_sizeIntegerOptionalFile size in bytes. It can be bigger than 2^31 and some programming languages may have difficulty/silent defects in interpreting it. But it has at most 52 significant bits, so a signed 64-bit integer or double-precision float type are safe for storing this value.
thumbnailPhotoSizeOptionalThumbnail of the album cover to which the music file belongs
Botlify Cloud Runtime
Credentials are auto-injected in .env — always load them with getenv(): BOT_TOKEN, ADMIN_CHAT_ID, BOT_USERNAME. Main database: database.db (SQLite, WAL mode). Runtime errors: error.log. Quick test: send to $ADMIN_CHAT_ID. Full details: Runtime Reference.