База знаний GetMyBot

Медиабиблиотека

Своё хранилище медиа с дедупликацией, premium-доступ и загрузка через Telegram-чат.

На этой странице

В медиабиблиотеку GetMyBot можно один раз загрузить изображения и файлы, которые бот будет отправлять в сообщениях. Библиотека дедуплицирует одинаковые файлы и относится к premium-возможностям; для базового сценария есть бесплатная загрузка через Telegram-чат.

Своё хранилище

Загруженный файл сохраняется в хранилище платформы и получает идентификатор медиа. В блоке сообщения «Фото» или «Файл» можно сослаться на этот идентификатор: при отправке платформа сама подставит нужный файл. Загрузка: POST /api/bots/{id}/media, чтение для предпросмотра: GET /api/bots/{id}/media/{mediaID}.

Дедупликация по содержимому

Каждый файл идентифицируется по sha256-хешу содержимого. Если вы загрузите тот же файл повторно, платформа не создаст дубль, а вернёт ссылку на уже сохранённый объект. Так одинаковые картинки не занимают место дважды, а идентификатор остаётся стабильным.

Premium-доступ

Медиабиблиотека относится к premium-возможностям (image_storage). Она доступна на платном тарифе, который её включает; без активной подписки загрузка в библиотеку возвращает ошибку 402 (требуется оплата). Предпросмотр уже сохранённых файлов работает без ограничений.

Размер одного файла при загрузке в библиотеку ограничен 2 МиБ.

Загрузка через Telegram-чат (без premium)

Если premium-библиотека недоступна, есть бесплатный путь: sink-upload: POST /api/bots/{id}/chats/{chatID}/sink-upload. Файл отправляется через указанный Telegram-чат, а в ответ возвращается file_id Telegram, который можно использовать в сообщениях бота. Этот способ доступен всем без premium-гейта; ограничение на размер: те же 2 МиБ.

Что использовать

  • Регулярно переиспользуете одни и те же картинки и хотите дедупликацию и предпросмотр: медиабиблиотека (premium).
  • Нужно быстро получить file_id без подписки: sink-upload через служебный чат.

Что дальше