Медиабиблиотека
Где хранить фотографии и файлы для сообщений бота. Загрузка в библиотеку и способ получить файл через Telegram без платной библиотеки.
На этой странице
Если бот часто отправляет одну и ту же программу курса или фотографию, загрузите файл в медиабиблиотеку и используйте его в сообщениях повторно. Одинаковый файл хранится в одном экземпляре, даже если загрузить его несколько раз. Эта возможность входит в платные тарифы, где доступно хранение файлов (image_storage).
Для отправки через Telegram есть и способ без платной библиотеки: загрузить файл через служебный чат и получить его Telegram-идентификатор file_id. Оба способа и их ограничения описаны ниже.
Своё хранилище
Загруженный файл сохраняется в GetMyBot и получает свой идентификатор. Выберите его в блоке сообщения «Фото» или «Файл»; при отправке бот подставит нужный файл. Для подключения через API: загрузка POST /api/bots/{id}/media, чтение для предпросмотра GET /api/bots/{id}/media/{mediaID}.
Дедупликация по содержимому
Если загрузить тот же файл ещё раз, GetMyBot найдёт уже сохранённую копию и вернёт прежний идентификатор. Одинаковые файлы не занимают место дважды. Для сравнения используется контрольная сумма файла SHA-256; такой поиск повторов называется дедупликацией.
Premium-доступ
Медиабиблиотека относится к premium-возможностям (image_storage). Она доступна на платном тарифе, который её включает; без активной подписки загрузка в библиотеку возвращает ошибку 402 (требуется оплата). Предпросмотр уже сохранённых файлов работает без ограничений.
Размер одного файла при загрузке в библиотеку ограничен 2 МиБ.
Загрузка через Telegram-чат (без платной библиотеки)
Если платная библиотека недоступна, загрузите файл через служебный Telegram-чат. GetMyBot вернёт file_id, по которому бот сможет отправлять этот файл повторно. Способ доступен без платной подписки; размер файла также ограничен 2 МиБ. Для разработчика: операция называется sink-upload, адрес POST /api/bots/{id}/chats/{chatID}/sink-upload.
Что использовать
| Задача | Подходящий способ | Требования |
|---|---|---|
| Хранить и повторно отправлять одинаковые изображения, видеть предпросмотр и не создавать дубли | Медиабиблиотека | Тариф с image_storage, файл до 2 МиБ |
Получить file_id Telegram без подписки | sink-upload через служебный чат | Telegram-чат, файл до 2 МиБ |
Что дальше
- Сообщения и кнопки: блоки «Фото» и «Файл» в ответе бота.
- Платежи и баланс: тарифы и premium-возможности.
- Импорт из sambot: перенос медиа из бандла.
- Чаты и операторы: служебные чаты для sink-upload.