Файлы

Загрузка файлов и скачивание полученных ботом медиа работают как в Telegram, отличаются только лимиты и формат file_path.

Скачивание

Вызовите getFile с file_id, затем скачайте файл по file_path:

Shell

curl "https://api.staticgram.top/bot$TOKEN/getFile?file_id=AgACAgIAAxkBAA..."
# {"ok":true,"result":{"file_id":"...","file_unique_id":"...","file_size":48213,"file_path":"AgACAgIAAxkBAA..."}}

curl -o photo.jpg "https://api.staticgram.top/file/bot$TOKEN/AgACAgIAAxkBAA..."

В StaticGram file_path совпадает с file_id (URL-safe base64 без /), а не выглядит как photos/file_1.jpg. Используйте значение как есть. Ответ отдаётся потоком с корректными Content-Type и Content-Length.

В библиотеках ничего менять не нужно: bot.download(...) в aiogram и File.download_to_drive() в python-telegram-bot берут адрес из настроек сервера (см. Подключение библиотек).

Загрузка

Новый файл: multipart/form-data, до 25 МБ на запрос (в Telegram 50 МБ).
Повторная отправка: file_id файла, который уже есть на сервере StaticGram.
По ссылке: HTTPS-адрес, сервер скачает файл сам.
В альбомах и InputMedia: attach://<имя поля>.

Параметры thumbnail, cover, start_timestamp и supports_streaming принимаются, но игнорируются.