API документация
Полный справочник по всем эндпоинтам загрузчика. Каждый эндпоинт потребляет разное количество кредитов на запрос.
Base URL
https://api.anysave.clickКредиты за запрос
Стоимость зависит от эндпоинта и платформы. Тарифы одинаковы для всех планов.
Какой эндпоинт выбрать?
Все четыре эндпоинта скачивают медиа — но каждый оптимизирован под свой сценарий. Выбирайте тот, что подходит вашей инфраструктуре и бюджету.
Cache Lookup
Мгновенно · 0 кредитов
/downloader/cache/lookupПроверяет, был ли файл скачан кем-либо ранее и закэширован в Telegram. Возвращает готовый file_id для прямой пересылки — без повторного скачивания. Абсолютно бесплатный — любой запрос стоит 0 кредитов. Возвращает 404, если файл ранее не запрашивался.
Плюсы
- Бесплатно — 0 кредитов за запрос
- Моментальный ответ (миллисекунды)
- Возвращает Telegram file_id для прямой пересылки с кастомными inline-клавиатурами
Минусы
- Возвращает 404, если файл не был скачан никем ранее
- Полезен только для Telegram-ботов — file_id нельзя использовать в других местах
Используйте если
Вы делаете Telegram-бота и хотите максимально дешёвую проверку перед fallback'ом на реальное скачивание.
Fast Links
Прямые CDN · почти мгновенно
/downloader/linksВозвращает прямые CDN-ссылки с исходной платформы — без обработки на нашей стороне. Оптимальный выбор для большинства задач. Может отдать HLS-стрим, файл любого размера или видео без звука + отдельную аудиодорожку (никогда просто немое видео). Всю обработку файлов делает клиент.
Плюсы
- Самый дешёвый скачивающий эндпоинт — почти мгновенный ответ
- Работает с любым размером файла, HLS, DASH — без ограничений
- Предпочтительный эндпоинт для большинства интеграций
Минусы
- Склейка HLS, объединение видео+аудио, обрезка — на стороне клиента
- CDN-ссылки могут истекать — используйте сразу
Используйте если
У вас есть способный клиент (браузер, мобильное приложение или сервер), который умеет обрабатывать сырые медиа-файлы, HLS-плейлисты или мёржить видео + аудио.
Sync Downloader
Одно соединение · всё делаем сами
/downloader/Одно HTTP-соединение держится открытым, пока файл не будет полностью готов. Наш сервер делает всё: обрезает файл если он больше ожидаемого размера, склеивает HLS-фрагменты, мёржит видео с отдельной аудиодорожкой. Медленный и тяжёлый — используйте только если клиент не может обработать файл сам. Стоит дороже, чем Fast Links.
Плюсы
- Ноль обработки на стороне клиента — получаете готовый файл
- Автоматическая склейка HLS, аудио, обрезка по размеру
- Один запрос, без polling'а
Минусы
- Держит соединение до 5 минут — тяжело для обеих сторон
- Дороже, чем Fast Links
Используйте если
Ваш клиент слабый (маломощное устройство, serverless-функция) и не может склеивать HLS или обрабатывать большие файлы. Рассмотрите наш SDK — он делает то же самое поверх Fast Links.
Async Tasks
Отправил и опрашиваешь · без блокировки
/downloader/tasksТа же мощь, что и Sync Downloader — та же обработка, тот же результат — но без блокировки. Создали задачу, опрашиваете статус, скачиваете файл когда готов. Идеально, если не хотите держать долгое HTTP-соединение открытым. Тоже дорогой; рассмотрите SDK для того же поведения поверх Fast Links.
Плюсы
- Никаких висящих соединений — подходит для serverless и мобильных
- Та же обработка, что и Sync (HLS merge, muxing, обрезка)
- URL результата живёт дольше, чем сам запрос
Минусы
- Тот же ценовой уровень, что и Sync Downloader
- Нужна логика polling'а на клиенте
Используйте если
Нужна тяжёлая обработка (4K, длинный HLS, большие файлы), но нельзя держать HTTP-соединение открытым.