Тип данных InputMediaVideo

Объект для отправки видеофайла с дополнительными параметрами, такими как подпись, миниатюра, обложка и настройки отображения.

Описание

Представляет видео для отправки.

Поле Тип Описание
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 представляет специальную форматированную сущность в тексте сообщения, такую как упоминания, хэштеги, ссылки или стилизованный текст.
Комментарии