Файлы Telegram в Python: API и инструменты

Расширенные примеры работы с файлами Telegram

Потоковая загрузка большого файла через итерацию

Избежать занятия всей памяти можно, скачивая файл частями. В библиотеке python-telegram-bot метод download() по умолчанию загружает сразу всё. Для потоковой записи используем requests напрямую, получая ссылку через file.file_path:

import requests
from telegram import Bot

bot = Bot(token='YOUR_TOKEN')
file = bot.get_file('file_id')
url = file.file_path

response = requests.get(url, stream=True)
with open('large_file.bin', 'wb') as f:
    for chunk in response.iter_content(chunk_size=8192):
        f.write(chunk)

# Результат: файл сохраняется на диск, не загружая весь в память

Этот метод подходит для файлов размером более 50 МБ (предел для бота - 50 МБ, но если файл уже загружен в облако, то file_path выдаёт прямую ссылку).

Скачивание и обработка изображения на лету

Пример с Pillow: получим фото, изменим размер и сохраним результат:

from io import BytesIO
from PIL import Image
from telegram import Bot

bot = Bot(token='YOUR_TOKEN')
file = bot.get_file('file_id')
buffer = BytesIO()
file.download(out=buffer)
buffer.seek(0)
img = Image.open(buffer)
img_resized = img.resize((200, 200))
img_resized.save('resized.jpg')

# Результат: файл resized.jpg 200x200 создан на диске

Загрузка файла из URL напрямую в Telegram

Можно отправить файл, не сохраняя его локально, указав URL в send_document через параметр document (в aiogram передают InputFile.from_url):

from telegram import Bot, InputFile

bot = Bot(token='YOUR_TOKEN')
url = 'https://example.com/sample.pdf'
bot.send_document(chat_id='@channel', document=InputFile.from_url(url))

# Бот скачивает файл с URL и отправляет в чат

Это удобно, когда файл уже есть в сети и не требуется промежуточное хранение.

Работа с файловыми потоками в aiogram

Асинхронный пример с использованием aiofiles для записи частями:

import aiofiles
from aiogram import Bot, types

bot = Bot(token='YOUR_TOKEN')

async def download_media(message: types.Message):
    file = await message.document.get_file()
    file_path = file.file_path
    async with aiofiles.open('output.bin', 'wb') as f:
        async for chunk in bot.stream_file(file_path):
            await f.write(chunk)

# Файл записывается асинхронно, не блокируя цикл событий

Метод stream_file возвращает асинхронный генератор. Требуется aiogram версии 3.x.

Скачивание файла с перехватом прогресса

Можно отслеживать прогресс загрузки, используя кастомный callback в requests:

import requests
from tqdm import tqdm

url = 'https://api.telegram.org/file/botTOKEN/file_path'
response = requests.get(url, stream=True)
total = int(response.headers.get('content-length', 0))
with open('bigfile.zip', 'wb') as f, tqdm(total=total, unit='B', unit_scale=True) as pbar:
    for data in response.iter_content(chunk_size=1024):
        f.write(data)
        pbar.update(len(data))

# Выводится прогресс-бар загрузки