Описание
Представляет видео для отправки.
| Поле | Тип | Описание |
|---|---|---|
| type | String | Тип результата, должен быть video |
| 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>. Подробнее об отправке файлов » |
| cover | String | Опционально. Обложка для видео в сообщении. Передайте file_id для отправки файла, существующего на серверах Telegram (рекомендуется), передайте HTTP-URL, чтобы Telegram получил файл из интернета, или передайте «attach://<file_attach_name>» для загрузки нового файла с использованием multipart/form-data под именем <file_attach_name>. Подробнее об отправке файлов » |
| start_timestamp | Integer | Опционально. Начальная временная метка для видео в сообщении |
| caption | String | Опционально. Подпись к отправляемому видео, 0-1024 символа после обработки сущностей |
| parse_mode | String | Опционально. Режим обработки сущностей в подписи к видео. Подробнее см. параметры форматирования. |
| caption_entities | Array of MessageEntity | Опционально. Список специальных сущностей, встречающихся в подписи, которые можно указать вместо parse_mode |
| show_caption_above_media | Boolean | Опционально. Передайте True, если подпись должна отображаться над медиафайлом сообщения |
| width | Integer | Опционально. Ширина видео |
| height | Integer | Опционально. Высота видео |
| duration | Integer | Опционально. Длительность видео в секундах |
| supports_streaming | Boolean | Опционально. Передайте True, если загруженное видео подходит для потоковой передачи |
| has_spoiler | Boolean | Опционально. Передайте True, если видео нужно скрыть анимацией спойлера |
Примеры
json
{
"type": "video",
"media": "attach://video_file",
"thumbnail": "attach://thumbnail_file",
"cover": "https://example.com/cover.jpg",
"start_timestamp": 5,
"caption": "Check out this amazing video! #fun",
"parse_mode": "HTML",
"caption_entities": [
{
"type": "hashtag",
"offset": 28,
"length": 4
}
],
"show_caption_above_media": true,
"width": 1920,
"height": 1080,
"duration": 120,
"supports_streaming": true,
"has_spoiler": false
}
История изменений
- API 3.6. Обновлен объект InputMediaVideo: Добавлено поле supports_streaming
- API 5.0. Обновлен объект InputMediaVideo: Добавлена возможность ручного указания текстовых сущностей
- API 6.4. Обновлен объект InputMediaVideo: Добавлено поле has_spoiler
- API 6.6. Обновлен объект InputMediaVideo: Переименовано поле thumb в thumbnail
- API 7.4. Обновлен объект InputMediaVideo: Добавлено поле show_caption_above_media
- API 8.3. Обновлен объект InputMediaVideo: Добавлены поля cover и start_timestamp для редактирования обложки и временной метки начала видео
Дополнительно
- MessageEntity - Объект MessageEntity представляет специальную форматированную сущность в тексте сообщения, такую как упоминания, хэштеги, ссылки или стилизованный текст.