API-Dokumentation für Bildkonvertierung - REST API für WebP-Konvertierung

Überblick

Mit der Convert2WebP API kannst du Bilder programmatisch zwischen Formaten konvertieren. Sende eine Multipart-Anfrage mit deinem Bild und erhalte die konvertierte Datei im Response-Body. Die gesamte Verarbeitung erfolgt serverseitig und dauert bei den meisten Dateien weniger als eine Sekunde.

Basis-URL

https://convert2webp.com/api/v1

Authentifizierung

Es ist keine Authentifizierung erforderlich. Die API ist kostenlos und offen. Alle Anfragen sind auf 60 pro Minute und IP-Adresse begrenzt.

Ratenbegrenzung

Die Limits gelten pro IP-Adresse. Alle Antworten enthalten Rate-Limit-Header.

Limit	Maximale Dateigröße	Maximale Batch-Dateien
60 Anfragen / Minute	10 MB pro Datei	20 Dateien pro Batch

Rate-Limit-Header sind in jeder Antwort enthalten: X-RateLimit-Remaining, X-RateLimit-Reset.

Endpoints

Konvertiert ein einzelnes Bild in ein Zielformat. Akzeptiert multipart/form-data mit der Bilddatei und optionalen Parametern.

Parameter

Name	Typ	Erforderlich	Beschreibung
file	File	Erforderlich	Die zu konvertierende Bilddatei. Akzeptiert PNG, JPG, GIF, BMP, TIFF, SVG, AVIF, ICO und WebP.
output_format	string	Optional	Zielformat: webp, png, jpg, gif, bmp oder pdf.(Standard: `webp`)
quality	integer	Optional	Ausgabequalität von 1 (niedrigste) bis 100 (höchste).(Standard: `80`)
width	integer	Optional	Maximale Ausgabebreite in Pixel. Das Seitenverhältnis bleibt erhalten.
height	integer	Optional	Maximale Ausgabehöhe in Pixel. Das Seitenverhältnis bleibt erhalten.
strip_metadata	boolean	Optional	Entfernt EXIF/IPTC/XMP-Metadaten aus der Ausgabe.(Standard: `true`)

Antworten

200

Konvertierte Bildbinärdateiimage/webp

400

Ungültige Anfrage (fehlende Datei, nicht unterstütztes Format usw.)application/json

413

Datei zu großapplication/json

429

Ratenlimit überschrittenapplication/json

500

Interner Serverfehlerapplication/json

Codebeispiele

terminal

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

Ausprobieren

Datei

Keine Datei ausgewählt

Format

Qualität (80)

Konvertieren Sie mehrere Bilder in einer einzigen Anfrage. Gibt ein ZIP-Archiv mit allen konvertierten Dateien zurück.

Parameter

Name	Typ	Erforderlich	Beschreibung
files	File[]	Erforderlich	Liste der zu konvertierenden Bilddateien. Maximal 20 Dateien pro Anfrage.
format	string	Optional	Zielausgabeformat, das auf alle Dateien angewendet wird.(Standard: `webp`)
quality	integer	Optional	Ausgabequalität von 1 bis 100.(Standard: `80`)

Antworten

200

ZIP-Archiv mit allen konvertierten Bildernapplication/zip

400

Ungültige Anfrageapplication/json

413

Gesamtnutzlast zu großapplication/json

429

Ratenlimit überschrittenapplication/json

Codebeispiele

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

Listen Sie alle unterstützten Eingabe- und Ausgabebildformate auf.

Antworten

200

JSON-Objekt, das unterstützte Eingabe- und Ausgabeformate auflistetapplication/json

Codebeispiele

terminal

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

Beispielantwort

response.json

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

Überprüfen Sie die Serviceverfügbarkeit.

Antworten

200

Dienststatus und Versionapplication/json

Codebeispiele

terminal

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

Beispielantwort

response.json

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

Fehlercodes

Alle Fehlerantworten liefern einen JSON-Body mit einem error Objekt, das den Fehler beschreibt.

error-response.json

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

Code	Name	Beschreibung
400	Fehlerhafte Anfrage	Die Anfrage war fehlerhaft. Überprüfen Sie, ob alle erforderlichen Parameter vorhanden und gültig sind.
413	Nutzlast zu groß	Die hochgeladene Datei überschreitet die 10-MB-Grenze.
415	Nicht unterstützter Medientyp	Das hochgeladene Dateiformat wird für die Konvertierung nicht unterstützt.
429	Zu viele Anfragen	Sie haben das Ratenlimit (60 Anfragen pro Minute) überschritten. Warten Sie und versuchen Sie es erneut.
500	Interner Serverfehler	Es ist ein unerwarteter Fehler aufgetreten. Wenn das Problem bestehen bleibt, kontaktiere convert2webp@deployvision.com.