API

Visão geral

O Convert2WebP API permite converter imagens entre formatos programaticamente. Envie uma solicitação multipartes com sua imagem e receba o arquivo convertido no corpo da resposta. Todo o processamento acontece no lado do servidor com latência inferior a um segundo para a maioria dos arquivos.

Autenticação

Nenhuma autenticação é necessária. O API é gratuito e aberto. Todas as solicitações têm taxa limitada a 60 solicitações por minuto por endereço IP.

Limite de requisições

Os limites de taxa são aplicados por endereço IP. Todas as respostas incluem cabeçalhos de limite de taxa.

Os cabeçalhos de limite de taxa estão incluídos em todas as respostas: X-RateLimit-Remaining, X-RateLimit-Reset.

Endpoints

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

Códigos de erro

Todas as respostas de erro retornam um corpo JSON com um error objeto que descreve o problema.

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