API
Conversion d'images par HTTP
Aperçu
Le Convert2WebP API vous permet de convertir des images entre formats par programme. Envoyez une requête en plusieurs parties avec votre image et recevez le fichier converti dans le corps de la réponse. Tout le traitement s'effectue côté serveur avec une latence inférieure à la seconde pour la plupart des fichiers.
URL de base
https://convert2webp.com/api/v1Authentification
Aucune authentification n'est requise. Le API est gratuit et ouvert. Toutes les requêtes sont limitées à 60 requêtes par minute par adresse IP.
Limites de débit
Les limites de débit sont appliquées par adresse IP. Toutes les réponses incluent des en-têtes de limite de débit.
| Limite | Taille maximale du fichier | Nombre maximal de fichiers par lot |
|---|---|---|
| 60 requêtes / minute | 10 Mo par fichier | 20 fichiers par lot |
Les en-têtes de limite de débit sont inclus dans chaque réponse : X-RateLimit-Remaining, X-RateLimit-Reset.
Endpoints
Convertissez une seule image dans un format cible. Accepte multipart/form-data avec le fichier image et les paramètres facultatifs.
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| file | File | Obligatoire | Le fichier image à convertir. Accepte PNG, JPG, GIF, BMP, TIFF, SVG, AVIF, ICO et WebP. |
| output_format | string | Optionnel | Format de sortie cible : webp, png, jpg, gif, bmp ou pdf.(défaut: webp) |
| quality | integer | Optionnel | Qualité de sortie de 1 (la plus basse) à 100 (la plus élevée).(défaut: 80) |
| width | integer | Optionnel | Largeur de sortie maximale en pixels. Le rapport hauteur/largeur est conservé. |
| height | integer | Optionnel | Hauteur de sortie maximale en pixels. Le rapport hauteur/largeur est conservé. |
| strip_metadata | boolean | Optionnel | Supprimez les métadonnées EXIF/IPTC/XMP de la sortie.(défaut: true) |
Réponses
Exemples de code
curl -X POST https://convert2webp.com/api/v1/convert \
-F "file=@photo.png" \
-F "format=webp" \
-F "quality=80" \
-o converted.webpEssayer
Convertissez plusieurs images en une seule requête. Renvoie une archive ZIP avec tous les fichiers convertis.
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| files | File[] | Obligatoire | Tableau de fichiers image à convertir. Maximum 20 fichiers par demande. |
| format | string | Optionnel | Format de sortie cible appliqué à tous les fichiers.(défaut: webp) |
| quality | integer | Optionnel | Qualité de sortie de 1 à 100.(défaut: 80) |
Réponses
Exemples de code
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.zipRépertoriez tous les formats d’image d’entrée et de sortie pris en charge.
Réponses
Exemples de code
curl https://convert2webp.com/api/v1/formatsExemple de réponse
{
"input": [
"png", "jpg", "jpeg", "gif", "bmp",
"tiff", "svg", "avif", "ico", "webp"
],
"output": ["webp", "png", "jpg", "gif", "bmp", "pdf"]
}Vérifiez la disponibilité du service.
Réponses
Exemples de code
curl https://convert2webp.com/api/v1/healthExemple de réponse
{
"status": "ok",
"version": "1.0.0",
"timestamp": "2026-04-04T12:00:00.000Z"
}Codes d'erreur
Toutes les réponses d'erreur renvoient un corps JSON avec un error objet décrivant ce qui n'a pas fonctionné.
{
"error": {
"code": 429,
"message": "Rate limit exceeded. Please wait 30 seconds before retrying."
}
}| Code | Nom | Description |
|---|---|---|
| 400 | Mauvaise demande | La demande était mal formée. Vérifiez que tous les paramètres requis sont présents et valides. |
| 413 | Charge trop volumineuse | Le fichier téléchargé dépasse la limite de 10 Mo. |
| 415 | Type de média non pris en charge | Le format de fichier téléchargé n'est pas pris en charge pour la conversion. |
| 429 | Trop de demandes | Vous avez dépassé la limite de débit (60 requêtes par minute). Attendez et réessayez. |
| 500 | Erreur interne du serveur | Une erreur inattendue s'est produite. Si cela persiste, contactez convert2webp@deployvision.com. |