Уменьшить фото API

Уменьшить фото API, ФотоМини подключает задачу к вашему приложению: вы отправляете файл, проверяете статус задачи и скачиваете результат. Эндпоинты выполняются на сервере без участия браузера.

Быстрый старт

Создайте ключ в разделе API для разработчиков вашего аккаунта; ключ в открытом виде отображается только в момент создания.
Отправьте запрос на https://api.pixepi.com с заголовком Authorization: Bearer <key>.
Опрашивайте задачу из ответа с помощью GET https://api.pixepi.com/api/v1/jobs/{id}; когда статус изменится на done, скачайте результат по адресу из download_url.

Пример запроса

curl -X POST "https://api.pixepi.com/api/v1/apps/gorsel-kucult/run" \
  -H "Authorization: Bearer $PIXEPI_KEY" \
  -F "file=@файл.jpg" \
  -F "options[quality]=82" \
  -F "options[format]=same"

curl -H "Authorization: Bearer $PIXEPI_KEY" "https://api.pixepi.com/api/v1/jobs/42"

Эндпоинты этого инструмента

Метод	Путь	Назначение
`POST`	`/run`	Запускает инструмент, создает задачу и возвращает результат.

Параметры

Параметры передаются как options[<field>]; для пустого поля используется значение по умолчанию.

Поле	Значения	По умолчанию
`options[quality]` Качество	40–95	`82`
`options[max_side]` Предел длинной стороны (необязательно)	0–6000	`пусто`
`options[format]` Формат вывода	same · jpeg · webp · png	`same`
`options[auto_rotate]` Автоматически исправлять ориентацию снимков с телефона	включено · отключено	`включено`

Общие эндпоинты

Метод	Путь	Назначение
`GET`	`/api/v1/apps`	Каталог API
`GET`	`/api/v1/apps/gorsel-kucult`	Контракт инструмента
`GET`	`/api/v1/jobs/{id}`	Статус задачи
`GET`	`/api/v1/jobs/{id}/download`	Скачать результат задачи
`GET`	`/api/v1/usage`	Сводка использования
`GET`	`/api/v1/openapi.json`	Документ OpenAPI 3.1

Ограничения

Не более 100 MB на файл.
Пакетная обработка: отправьте поле file несколько раз.
Информация о квотах и тарифе привязана к вашему аккаунту; проверьте текущее состояние с помощью GET /api/v1/usage.

Коды ошибок

Код	Значение
`unauthorized`	Ключ API отсутствует или недействителен.
`forbidden`	Эта операция запрещена с данным ключом.
`not_found`	Инструмент, задача или запись не найдены (404 также при доступе из другого аккаунта).
`invalid_input`	Ошибка проверки входных данных (пропущено или повреждено поле, неверная дата и т. д.).
`invalid_request`	Некорректный запрос.
`too_large`	Размер файла или тела запроса превышает лимит.
`unsupported_media`	Тип файла не поддерживается.
`not_supported`	Этот инструмент не может работать на этой конечной точке (stateful app).
`not_ready`	Задача еще не завершена.
`expired`	Срок действия файла истек.
`no_output`	Нет готовых файлов для скачивания.
`invalid_path`	Недопустимый путь к файлу.
`quota_exceeded`	Превышена квота или лимит запросов.
`rate_limited`	Слишком много запросов за короткое время; подождите немного и повторите попытку.
`csrf`	Ошибка проверки формы браузера (внешний API использует ключи).
`conflict`	Операция конфликтует с текущим состоянием.
`unavailable`	Инструмент временно недоступен.
`internal_error`	Непредвиденная ошибка сервера.

Документы

Часто задаваемые вопросы

Где получить API-ключ?

Создайте ключ в разделе API для разработчиков вашего аккаунта; ключ показывается только один раз в момент создания.

Как отправить запрос?

Эндпоинты доступны по адресу https://api.pixepi.com; каждый запрос должен содержать заголовок "Authorization: Bearer <key>".

Какие файлы принимает API ФотоМини?

Поддерживаемые форматы: JPG · JPEG · PNG · WEBP. Лимит — 100 MB на файл; параметры совпадают с указанными на странице инструмента.

Как обрабатывать ответ с ошибкой?

Тело ошибки содержит поля {ok:false, error, code, request_id}; возможные значения кода приведены в таблице кодов ошибок.