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

Минимальный путь для серверной интеграции: создать ключ, отправить изображение и сохранить оптимизированный результат.

1. Получите API-ключ

Откройте личный кабинет, создайте ключ и сохраните значение вида sk_live_.... Для серверных запросов передавайте ключ только в заголовке Authorization.

Authorization: Bearer sk_live_xxx

2. Отправьте первое изображение

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

3. Разберите ответ

{
  "success": true,
  "message": "optimized 1 file(s)",
  "results": [{
    "filename": "sample.jpg",
    "success": true,
    "original_size": 845122,
    "optimized_size": 312044,
    "saved_bytes": 533078,
    "saved_percent": 63.1,
    "output_format": "webp",
    "optimized_base64": "..."
  }]
}

Поле optimized_base64 содержит готовый файл в base64. Если один файл не обработан, его строка в results[] вернётся с success: false и сообщением ошибки.

Что проверить после подключения

  • Ключ активен и не отозван в кабинете.
  • Файлы отправляются как multipart/form-data, поле images можно повторять несколько раз.
  • Дневная статистика появилась в Usage API и в личном кабинете.