API

Обзор

Convert2WebP API позволяет программно конвертировать изображения между форматами. Отправьте составной запрос с вашим изображением и получите преобразованный файл в теле ответа. Вся обработка происходит на стороне сервера с задержкой менее секунды для большинства файлов.

Аутентификация

Никакой аутентификации не требуется. API бесплатен и открыт. Скорость всех запросов ограничена 60 запросами в минуту на адрес IP.

Лимиты запросов

Ограничения скорости применяются для каждого адреса IP. Все ответы включают заголовки ограничения скорости.

Заголовки ограничения скорости включены в каждый ответ: X-RateLimit-Remaining, X-RateLimit-Reset.

Эндпоинты

curl -X POST https://convert2webp.com/api/v1/convert \
  -F "file=@photo.png" \
  -F "format=webp" \
  -F "quality=80" \
  -o converted.webp

curl -X POST https://convert2webp.com/api/v1/batch \
  -F "files=@image1.png" \
  -F "files=@image2.jpg" \
  -F "files=@image3.gif" \
  -F "format=webp" \
  -F "quality=80" \
  -o converted.zip

curl https://convert2webp.com/api/v1/formats

{
  "input": [
    "png", "jpg", "jpeg", "gif", "bmp",
    "tiff", "svg", "avif", "ico", "webp"
  ],
  "output": ["webp", "png", "jpg", "gif", "bmp", "pdf"]
}

curl https://convert2webp.com/api/v1/health

{
  "status": "ok",
  "version": "1.0.0",
  "timestamp": "2026-04-04T12:00:00.000Z"
}

Коды ошибок

Все ответы об ошибках возвращают тело JSON с error объект, описывающий, что пошло не так.

{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded. Please wait 30 seconds before retrying."
  }
}