Saltar al contenido

API

Conversión de imágenes por HTTP

Resumen

La API de Convert2WebP te permite convertir imágenes entre formatos de forma programática. Envía una solicitud multipart con tu imagen y recibe el archivo convertido en el cuerpo de la respuesta. Todo el procesamiento ocurre en el servidor y suele tardar menos de un segundo.

URL base

https://convert2webp.com/api/v1

Autenticación

No se requiere autenticación. La API es gratuita y abierta. Todas las solicitudes están limitadas a 60 por minuto por dirección IP.

Límites de uso

Los límites se aplican por dirección IP. Todas las respuestas incluyen cabeceras de límite.

LímiteTamaño máximo de archivoMáximo de archivos por lote
60 solicitudes / minuto10 MB por archivo20 archivos por lote

Las cabeceras de límite se incluyen en cada respuesta: X-RateLimit-Remaining, X-RateLimit-Reset.

Endpoints

Convierte una sola imagen al formato de destino. Acepta multipart/form-data con el archivo y parámetros opcionales.

Parámetros

NombreTipoObligatorioDescripción
fileFileObligatorioEl archivo de imagen que se va a convertir. Acepta PNG, JPG, GIF, BMP, TIFF, SVG, AVIF, ICO y WebP.
output_formatstringOpcionalFormato de salida: webp, png, jpg, gif, bmp o pdf.(predeterminado: webp)
qualityintegerOpcionalCalidad de salida de 1 (mínima) a 100 (máxima).(predeterminado: 80)
widthintegerOpcionalAncho máximo de salida en píxeles. Se conserva la relación de aspecto.
heightintegerOpcionalAltura máxima de salida en píxeles. Se conserva la relación de aspecto.
strip_metadatabooleanOpcionalElimina los metadatos EXIF/IPTC/XMP de la salida.(predeterminado: true)

Respuestas

200
Binario de imagen convertidaimage/webp
400
Solicitud no válida (falta el archivo, formato no compatible, etc.)application/json
413
Archivo demasiado grandeapplication/json
429
Límite excedidoapplication/json
500
Error interno del servidorapplication/json

Ejemplos de código

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

Probar

Ningún archivo seleccionado

Convierte varias imágenes en una sola solicitud. Devuelve un archivo ZIP con todos los archivos convertidos.

Parámetros

NombreTipoObligatorioDescripción
filesFile[]ObligatorioLista de archivos de imagen para convertir. Máximo 20 archivos por solicitud.
formatstringOpcionalFormato de salida aplicado a todos los archivos.(predeterminado: webp)
qualityintegerOpcionalCalidad de salida de 1 a 100.(predeterminado: 80)

Respuestas

200
Archivo ZIP con todas las imágenes convertidasapplication/zip
400
Solicitud no válidaapplication/json
413
Carga total demasiado grandeapplication/json
429
Límite excedidoapplication/json

Ejemplos de código

terminal
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

Lista todos los formatos de entrada y salida compatibles.

Respuestas

200
Objeto JSON con los formatos de entrada y salida compatiblesapplication/json

Ejemplos de código

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

Respuesta de ejemplo

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

Comprueba la disponibilidad del servicio.

Respuestas

200
Estado del servicio y versiónapplication/json

Ejemplos de código

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

Respuesta de ejemplo

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

Códigos de error

Todas las respuestas de error devuelven un cuerpo JSON con un error objeto que describe el problema.

error-response.json
{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded. Please wait 30 seconds before retrying."
  }
}
CódigoNombreDescripción
400Solicitud incorrectaLa solicitud está mal formada. Verifica que todos los parámetros requeridos estén presentes y sean válidos.
413Carga demasiado grandeEl archivo subido supera el límite de 10 MB.
415Tipo de medio no compatibleEl formato del archivo subido no es compatible con la conversión.
429Demasiadas solicitudesHas superado el límite de uso (60 solicitudes por minuto). Espera y vuelve a intentarlo.
500Error interno del servidorSe produjo un error inesperado. Si persiste, contacta con convert2webp@deployvision.com.