API-documentatie voor afbeeldingsconversie - REST API voor WebP-conversie

Overzicht

Met de Convert2WebP API kun je afbeeldingen programmatisch tussen formaten converteren. Stuur een multipart-verzoek met je afbeelding en ontvang het geconverteerde bestand in de responsebody. Alle verwerking gebeurt server-side en duurt voor de meeste bestanden minder dan een seconde.

Basis-URL

https://convert2webp.com/api/v1

Authenticatie

Authenticatie is niet vereist. De API is gratis en open. Alle verzoeken zijn beperkt tot 60 per minuut per IP-adres.

Snelheidsbeperking

Limieten gelden per IP-adres. Alle responses bevatten rate-limitheaders.

Limiet	Maximale bestandsgrootte	Maximaal aantal batchbestanden
60 verzoeken / minuut	10 MB per bestand	20 bestanden per batch

Rate-limitheaders zijn opgenomen in elke response: X-RateLimit-Remaining, X-RateLimit-Reset.

Eindpunten

Converteer een enkele afbeelding naar een doelformaat. Accepteert multipart/form-data met het afbeeldingsbestand en optionele parameters.

Parameters

Naam	Type	Vereist	Beschrijving
file	File	Vereist	Het afbeeldingsbestand dat moet worden geconverteerd. Ondersteunt PNG, JPG, GIF, BMP, TIFF, SVG, AVIF, ICO en WebP.
output_format	string	Optioneel	Doeluitvoerformaat: webp, png, jpg, gif, bmp of pdf.(standaard: `webp`)
quality	integer	Optioneel	Uitvoerkwaliteit van 1 (laagst) tot 100 (hoogst).(standaard: `80`)
width	integer	Optioneel	Maximale uitvoerbreedte in pixels. De beeldverhouding blijft behouden.
height	integer	Optioneel	Maximale uitvoerhoogte in pixels. De beeldverhouding blijft behouden.
strip_metadata	boolean	Optioneel	Verwijdert EXIF/IPTC/XMP-metadata uit de uitvoer.(standaard: `true`)

Antwoorden

200

Binaire data van geconverteerde afbeeldingimage/webp

400

Ongeldig verzoek (ontbrekend bestand, niet-ondersteund formaat, enz.)application/json

413

Bestand te grootapplication/json

429

Limiet overschredenapplication/json

500

Interne serverfoutapplication/json

Codevoorbeelden

terminal

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

Probeer het

Bestand

Geen bestand geselecteerd

Formaat

Kwaliteit (80)

Converteer meerdere afbeeldingen in één verzoek. Retourneert een ZIP-archief met alle geconverteerde bestanden.

Parameters

Naam	Type	Vereist	Beschrijving
files	File[]	Vereist	Lijst met afbeeldingsbestanden om te converteren. Maximaal 20 bestanden per verzoek.
format	string	Optioneel	Uitvoerformaat toegepast op alle bestanden.(standaard: `webp`)
quality	integer	Optioneel	Uitvoerkwaliteit van 1 tot 100.(standaard: `80`)

Antwoorden

200

ZIP-archief met alle geconverteerde afbeeldingenapplication/zip

400

Ongeldig verzoekapplication/json

413

Totale payload te grootapplication/json

429

Limiet overschredenapplication/json

Codevoorbeelden

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

Toont alle ondersteunde invoer- en uitvoerformaten.

Antwoorden

200

JSON-object met ondersteunde invoer- en uitvoerformatenapplication/json

Codevoorbeelden

terminal

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

Voorbeeldresponse

response.json

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

Controleer of de service beschikbaar is.

Antwoorden

200

Servicestatus en versieapplication/json

Codevoorbeelden

terminal

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

Voorbeeldresponse

response.json

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

Foutcodes

Alle foutresponses retourneren een JSON-body met een error object dat beschrijft wat er misging.

error-response.json

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

Code	Naam	Beschrijving
400	Ongeldig verzoek	Het verzoek is ongeldig opgebouwd. Controleer of alle vereiste parameters aanwezig en geldig zijn.
413	Payload te groot	Het geüploade bestand overschrijdt de limiet van 10 MB.
415	Niet-ondersteund mediatype	Het geüploade bestandsformaat wordt niet ondersteund voor conversie.
429	Te veel verzoeken	Je hebt de rate limit (60 verzoeken per minuut) overschreden. Wacht en probeer het opnieuw.
500	Interne serverfout	Er is een onverwachte fout opgetreden. Neem contact op met convert2webp@deployvision.com als dit blijft gebeuren.