Описание
Представляет аудиофайл, который следует рассматривать как музыку для отправки.
| Поле | Тип | Описание |
|---|---|---|
| type | String | Тип результата, должен быть audio |
| media | String | Файл для отправки. Передайте file_id, чтобы отправить файл, существующий на серверах Telegram (рекомендуется), передайте HTTP-URL, чтобы Telegram получил файл из Интернета, или передайте «attach://<file_attach_name>», чтобы загрузить новый файл, используя multipart/form-data с именем <file_attach_name>. Подробнее об отправке файлов » |
| thumbnail | String | Необязательно. Миниатюра отправляемого файла; может быть проигнорирована, если генерация миниатюр для файла поддерживается на стороне сервера. Миниатюра должна быть в формате JPEG и размером менее 200 КБ. Ширина и высота миниатюры не должны превышать 320. Игнорируется, если файл не загружается с использованием multipart/form-data. Миниатюры нельзя повторно использовать, их можно загружать только как новый файл, поэтому вы можете передать «attach://<file_attach_name>», если миниатюра была загружена с использованием multipart/form-data под именем <file_attach_name>. Подробнее об отправке файлов » |
| caption | String | Необязательно. Подпись к отправляемому аудио, 0-1024 символа после обработки сущностей |
| parse_mode | String | Необязательно. Режим обработки сущностей в подписи к аудио. Подробнее см. параметры форматирования. |
| caption_entities | Массив MessageEntity | Необязательно. Список специальных сущностей, появляющихся в подписи, которые могут быть указаны вместо parse_mode |
| duration | Integer | Необязательно. Длительность аудио в секундах |
| performer | String | Необязательно. Исполнитель аудио |
| title | String | Необязательно. Название аудио |
Примеры
json
{
"type": "audio",
"media": "attach://audio_file",
"thumbnail": "attach://thumbnail_file",
"caption": "Check out this amazing track!",
"parse_mode": "HTML",
"caption_entities": [
{
"type": "bold",
"offset": 0,
"length": 4
}
],
"duration": 180,
"performer": "The Telegram Orchestra",
"title": "Bot API Symphony"
}История изменений
- API 4.0. Добавлен объект InputMediaAudio
- API 5.0. Обновлен объект InputMediaAudio: Добавлена возможность ручного указания текстовых сущностей
- API 6.6. Обновлен объект InputMediaAudio: Переименовано поле thumb в thumbnail
Дополнительно
- MessageEntity - Объект MessageEntity представляет специальную форматированную сущность в тексте сообщения, такую как упоминания, хэштеги, ссылки или стилизованный текст.