Aller au contenu

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/v1

Authentification

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.

LimiteTaille maximale du fichierNombre maximal de fichiers par lot
60 requêtes / minute10 Mo par fichier20 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

NomTypeObligatoireDescription
fileFileObligatoireLe fichier image à convertir. Accepte PNG, JPG, GIF, BMP, TIFF, SVG, AVIF, ICO et WebP.
output_formatstringOptionnelFormat de sortie cible : webp, png, jpg, gif, bmp ou pdf.(défaut: webp)
qualityintegerOptionnelQualité de sortie de 1 (la plus basse) à 100 (la plus élevée).(défaut: 80)
widthintegerOptionnelLargeur de sortie maximale en pixels. Le rapport hauteur/largeur est conservé.
heightintegerOptionnelHauteur de sortie maximale en pixels. Le rapport hauteur/largeur est conservé.
strip_metadatabooleanOptionnelSupprimez les métadonnées EXIF/IPTC/XMP de la sortie.(défaut: true)

Réponses

200
Image binaire convertieimage/webp
400
Demande invalide (fichier manquant, format non pris en charge, etc.)application/json
413
Fichier trop volumineuxapplication/json
429
Limite de débit dépasséeapplication/json
500
Erreur interne du serveurapplication/json

Exemples de code

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

Essayer

Aucun fichier sélectionné

Convertissez plusieurs images en une seule requête. Renvoie une archive ZIP avec tous les fichiers convertis.

Paramètres

NomTypeObligatoireDescription
filesFile[]ObligatoireTableau de fichiers image à convertir. Maximum 20 fichiers par demande.
formatstringOptionnelFormat de sortie cible appliqué à tous les fichiers.(défaut: webp)
qualityintegerOptionnelQualité de sortie de 1 à 100.(défaut: 80)

Réponses

200
Archive ZIP contenant toutes les images convertiesapplication/zip
400
Demande invalideapplication/json
413
Charge totale trop volumineuseapplication/json
429
Limite de débit dépasséeapplication/json

Exemples de code

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

Répertoriez tous les formats d’image d’entrée et de sortie pris en charge.

Réponses

200
Objet JSON répertoriant les formats d'entrée et de sortie pris en chargeapplication/json

Exemples de code

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

Exemple de réponse

response.json
{
  "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

200
État et version du serviceapplication/json

Exemples de code

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

Exemple de réponse

response.json
{
  "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-response.json
{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded. Please wait 30 seconds before retrying."
  }
}
CodeNomDescription
400Mauvaise demandeLa demande était mal formée. Vérifiez que tous les paramètres requis sont présents et valides.
413Charge trop volumineuseLe fichier téléchargé dépasse la limite de 10 Mo.
415Type de média non pris en chargeLe format de fichier téléchargé n'est pas pris en charge pour la conversion.
429Trop de demandesVous avez dépassé la limite de débit (60 requêtes par minute). Attendez et réessayez.
500Erreur interne du serveurUne erreur inattendue s'est produite. Si cela persiste, contactez convert2webp@deployvision.com.