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/v1Autenticació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ímite | Tamaño máximo de archivo | Máximo de archivos por lote |
|---|---|---|
| 60 solicitudes / minuto | 10 MB por archivo | 20 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
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| file | File | Obligatorio | El archivo de imagen que se va a convertir. Acepta PNG, JPG, GIF, BMP, TIFF, SVG, AVIF, ICO y WebP. |
| output_format | string | Opcional | Formato de salida: webp, png, jpg, gif, bmp o pdf.(predeterminado: webp) |
| quality | integer | Opcional | Calidad de salida de 1 (mínima) a 100 (máxima).(predeterminado: 80) |
| width | integer | Opcional | Ancho máximo de salida en píxeles. Se conserva la relación de aspecto. |
| height | integer | Opcional | Altura máxima de salida en píxeles. Se conserva la relación de aspecto. |
| strip_metadata | boolean | Opcional | Elimina los metadatos EXIF/IPTC/XMP de la salida.(predeterminado: true) |
Respuestas
Ejemplos de código
curl -X POST https://convert2webp.com/api/v1/convert \
-F "file=@photo.png" \
-F "format=webp" \
-F "quality=80" \
-o converted.webpProbar
Convierte varias imágenes en una sola solicitud. Devuelve un archivo ZIP con todos los archivos convertidos.
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| files | File[] | Obligatorio | Lista de archivos de imagen para convertir. Máximo 20 archivos por solicitud. |
| format | string | Opcional | Formato de salida aplicado a todos los archivos.(predeterminado: webp) |
| quality | integer | Opcional | Calidad de salida de 1 a 100.(predeterminado: 80) |
Respuestas
Ejemplos de código
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.zipLista todos los formatos de entrada y salida compatibles.
Respuestas
Ejemplos de código
curl https://convert2webp.com/api/v1/formatsRespuesta de ejemplo
{
"input": [
"png", "jpg", "jpeg", "gif", "bmp",
"tiff", "svg", "avif", "ico", "webp"
],
"output": ["webp", "png", "jpg", "gif", "bmp", "pdf"]
}Comprueba la disponibilidad del servicio.
Respuestas
Ejemplos de código
curl https://convert2webp.com/api/v1/healthRespuesta de ejemplo
{
"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": {
"code": 429,
"message": "Rate limit exceeded. Please wait 30 seconds before retrying."
}
}| Código | Nombre | Descripción |
|---|---|---|
| 400 | Solicitud incorrecta | La solicitud está mal formada. Verifica que todos los parámetros requeridos estén presentes y sean válidos. |
| 413 | Carga demasiado grande | El archivo subido supera el límite de 10 MB. |
| 415 | Tipo de medio no compatible | El formato del archivo subido no es compatible con la conversión. |
| 429 | Demasiadas solicitudes | Has superado el límite de uso (60 solicitudes por minuto). Espera y vuelve a intentarlo. |
| 500 | Error interno del servidor | Se produjo un error inesperado. Si persiste, contacta con convert2webp@deployvision.com. |