Как сохранять видео и аудио в Telegram через Media Pocket
На этой странице
Media Pocket принимает ссылку или файл в Telegram и возвращает подготовленное медиа в тот же интерфейс. Здесь разобран пользовательский путь: получить доступ, отправить материал, выбрать подходящий результат и разобраться с очередью. Для работы нужен уже развёрнутый экземпляр и приглашение от его оператора.
1. Получите доступ к экземпляру
Откройте выданного оператором бота и отправьте /start. Приглашение можно активировать обычным сообщением с кодом или командой /redeem CODE. Пока доступ не выдан, бот не принимает пользователя в рабочий контур.
Оператор управляет одноразовыми кодами, приглашениями с ограничением числа активаций и кодами со сроком действия. Поэтому неработающий код стоит проверить у него: истёкшее приглашение не исправляется сменой формата ссылки. Inline-режим также требует доступа и не заменяет активацию.
2. Отправьте ссылку или загрузите файл
Для одной загрузки достаточно отправить поддерживаемую ссылку обычным сообщением. Можно передать несколько ссылок сразу. Источниками бывают видеоплощадки, социальные публикации, аудиосервисы и прямые HTTP(S)-адреса медиафайлов. Поддержка зависит от конкретного провайдера; любая веб-страница не обязана превращаться в скачиваемое видео.
Бот также принимает загруженные в Telegram видео, аудио, фотографии, анимации, документы, голосовые и видеосообщения. Они поступают в тот же фоновый конвейер. Аудио и видео могут быть нормализованы для Telegram, фотографии — подготовлены в подходящем формате, обычные документы сохраняются файлами. В обоих случаях действуют ограничения экземпляра на размер и доступ.
3. Выберите видео, аудио или файл
Обычные ссылки запускаются сразу в естественном для источника режиме. У аудиосервиса результат остаётся аудио. Для YouTube в /settings можно сохранить предпочтение: видео, аудио или выбор при каждом запросе. Только последний вариант открывает карточку выбора перед загрузкой.
Если нужно явно запросить видео, предусмотрена команда /video URL. При этом формат содержимого и способ доставки — разные решения. Видео или аудио удобно проигрывать прямо в чате; отправка файлом по возможности сохраняет скачанный оригинал. Дополнительные действия для уже полученного результата приходят отдельно и могут предлагать другой формат, когда он применим.
4. Дождитесь результата или откройте статус
После постановки задания бот обновляет одно сообщение о ходе работы. Позиция в очереди, скорость, объём и оставшееся время показываются, когда эти данные доступны. Длительная загрузка выполняется в фоне; повторная отправка той же ссылки не является способом ускорить worker.
Команда /status показывает активные и недавние задания пользователя, а также доступные действия отмены или повтора. При ошибке остаётся компактная карточка с причиной и следующим шагом. Сначала прочитайте её: сетевой сбой, ограничение источника и слишком большой файл требуют разных решений. После успеха технический статус удаляется, а готовое медиа остаётся в чате.
5. Уточните, что делать с коллекцией
В ссылке YouTube может одновременно присутствовать отдельное видео и плейлист. В этом случае бот сначала спрашивает, нужен текущий ролик или вся коллекция, и только затем ставит работу в очередь.
Если у одиночного видео есть пригодные таймкоды в описании, появляется вариант разделить аудио на треки. Он загружает аудио один раз, использует найденные границы и отправляет треки группами с названиями и метаданными. Альбомы и обычные группы медиа также доставляются коллекциями с отдельными действиями после результата.
Несколько ссылок в одном сообщении сохраняют естественный режим каждого источника. Если среди них есть YouTube с настройкой запроса выбора, один выбор применяется к пакету с подходящим вариантом для остальных элементов.
Частые вопросы
Как получить только звук из YouTube?
Выберите аудио в настройках YouTube через /settings, затем отправьте ссылку. Если нужно каждый раз решать отдельно, сохраните режим запроса выбора. Этот выбор относится к YouTube; аудиоисточникам не требуется искусственно назначать видеорежим.
Сохранится ли исходное качество?
Режим отправки файлом по возможности сохраняет скачанный оригинал. Для проигрывания в Telegram сервис предпочитает совместимые исходные потоки и переупаковку без повторного кодирования, но несовместимый материал может потребовать преобразования. Для тяжёлых прямых ссылок бот может отдельно предложить оригинал или компактную версию. Обещания «без перекодирования при любых условиях» здесь нет.
Почему ссылка доступна в браузере, но не загружается ботом?
Закрытый, удалённый, регионально ограниченный или требующий авторизации материал может оставаться недоступным. Бот не обходит ограничения провайдера. Если экземпляру нужны браузерные cookies, это отдельная задача настройки у оператора; её границы описаны в статье о Media Cookie Broker. Практический порядок передачи cookies разобран в руководстве для серверного загрузчика. Пароли и cookie-файлы нельзя публиковать в сообщении об ошибке.
Есть ли общий бот без регистрации и приглашения?
Проект описывает самостоятельно размещаемый загрузчик с доступом по приглашениям. Для использования нужен адрес конкретного экземпляра и разрешение его оператора. Эта инструкция не обещает существования общего публичного сервиса или доступа к чужому развёртыванию.