Zum Hauptinhalt springen

Nächstes Tool finden

Dokumentation/API/Bild-API: komprimieren, skalieren und umwandeln
API

Bild-API: komprimieren, skalieren und umwandeln

Skalieren, zuschneiden, drehen, auf eine Qualitätsstufe oder Zielgröße in Bytes komprimieren und Bilder in JPG, PNG, WebP oder AVIF konvertieren – mit einem einzigen Pipeline-Aufruf.

Kurze Antwort

Senden Sie POST /api/v1/pipeline/ mit einem sourceKey und einem Schritt {"operation":"image","pipeline":[…]}, der bis zu 8 Operationen auflistet: resize (maxWidth, maxHeight), crop (x, y, width, height), rotate (degrees), compress (quality 1–100 oder targetBytes) und convert (jpg, png, webp, avif). Für Bilder, die bereits unter Meine Dokumente liegen, verwenden Sie /documents/{documentId}/process/ mit {"operation":"image","pipeline":[…]}.

Für das Web komprimieren

Eine typische Pipeline für Produktfotos begrenzt die Abmessungen und konvertiert in WebP. In unserem Test wurde ein PNG mit 224 KB in etwa 4 Sekunden zu einem 400 px breiten WebP mit 30 KB.

curl -X POST 'https://maxscanner.app/api/v1/pipeline/' \
  -H "Authorization: Bearer $MAXSCANNER_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{ "sourceKey": "users/<id>/media/inbox/…-photo.png", "steps": [ { "operation": "image", "pipeline": [ { "operation": "resize", "maxWidth": 1600 }, { "operation": "compress", "quality": 75, "format": "webp" } ] } ] }'

Eine Zieldateigröße erreichen

Upload-Portale verlangen oft „unter 200 KB“. Verwenden Sie compress mit targetBytes statt quality; der Worker sucht die höchste Qualität, die in das Ziel passt. Zielwerte müssen zwischen dem Minimum und dem Maximum liegen, das die API zulässt (bis zu 20 MB).

{ "operation": "image", "pipeline": [ { "operation": "resize", "maxWidth": 1200 }, { "operation": "compress", "targetBytes": 204800, "format": "jpg" } ] }

Bildschritte mit PDF und OCR verketten

Pipelines können nach dem Bildschritt weiterlaufen: Fügen Sie {"operation":"convert","format":"pdf"} hinzu, um das Ergebnis in ein PDF zu packen, oder {"operation":"ocr","format":"pdf"}, um es durchsuchbar zu machen. Wenn der nächste Schritt es erfordert, gibt der Bildschritt automatisch PNG aus.

Häufige Fragen

Entfernt die Komprimierung Metadaten?

Neu kodierte Bilder behalten keine EXIF-Daten wie den GPS-Standort – bei öffentlichen Bildern ist das meist erwünscht.

Welches Format sollte ich wählen?

WebP für Websites, JPG, wenn Kompatibilität am wichtigsten ist, PNG für Screenshots und Strichzeichnungen, AVIF für die kleinsten Dateien, wenn Ihr Publikum moderne Browser nutzt.

Verwandte Anleitungen