Optimize API

Метод оптимизирует изображения через gateway, учитывает лимиты пользователя и возвращает результат в base64.

Метод

POST /v1/optimize

Content-Type: multipart/form-data Authorization: Bearer sk_live_... Лимит тела: 65 MB

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

curl -X POST "https://imgfix.ru/v1/optimize" \
  -H "Authorization: Bearer sk_live_xxx" \
  -F "images=@first.png" \
  -F "images=@second.jpg" \
  -F "format=webp" \
  -F "quality=82" \
  -F "width=1600"

Параметры запроса

Параметр	Тип	Обязателен	Описание
`images`	file[]	да	Один или несколько файлов. Поле можно повторять.
`image`	file	нет	Алиас для одного файла, если удобнее отправлять single upload.
`format`	enum	нет	`original`, `jpeg`, `png`, `webp`. По умолчанию сохраняется исходный формат.
`quality`	int	нет	Качество 1..100 для JPEG/WebP. По умолчанию 82.
`width`	int	нет	Максимальная ширина результата в пикселях. Высота пересчитывается пропорционально.

Поддерживаемые входные форматы: JPEG, PNG, WebP, AVIF.

Пример ответа

{
  "success": true,
  "message": "optimized 2 file(s)",
  "total_original_size": 1345122,
  "total_optimized_size": 512044,
  "total_saved_bytes": 833078,
  "total_saved_percent": 61.9,
  "results": [{
    "filename": "first.png",
    "success": true,
    "original_size": 845122,
    "optimized_size": 312044,
    "saved_bytes": 533078,
    "saved_percent": 63.1,
    "output_format": "webp",
    "original_format": "png",
    "width": 1600,
    "height": 900,
    "resized": true,
    "optimized_base64": "..."
  }]
}

Ошибки метода

HTTP	Код	Когда возникает
400	`cannot parse form`	Некорректный multipart-запрос или превышен лимит тела.
401	`invalid_api_key`	Bearer token не найден среди активных ключей.
429	`daily_limit_exceeded`	Превышен дневной бесплатный лимит.
402	`paid_quota_exhausted`	Платный пакет исчерпан.
502	`converter_unavailable`	Внутренний converter недоступен.