API

Przegląd

Convert2WebP API umożliwia programową konwersję obrazów pomiędzy formatami. Wyślij wieloczęściowe żądanie ze swoim obrazem i otrzymaj przekonwertowany plik w treści odpowiedzi. Całe przetwarzanie odbywa się po stronie serwera z opóźnieniem poniżej sekundy w przypadku większości plików.

Uwierzytelnianie

Nie jest wymagane żadne uwierzytelnianie. API jest darmowy i otwarty. Wszystkie żądania są ograniczone do 60 żądań na minutę na adres IP.

Limitowanie szybkości

Limity szybkości obowiązują dla każdego adresu IP. Wszystkie odpowiedzi zawierają nagłówki limitów szybkości.

Nagłówki limitów szybkości są zawarte w każdej odpowiedzi: X-RateLimit-Remaining, X-RateLimit-Reset.

Punkty końcowe

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"
}

Kody błędów

Wszystkie odpowiedzi na błędy zwracają treść JSON z rozszerzeniem error obiekt opisujący, co poszło nie tak.

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