Skip to content

Image Processing

Resize, crop, compress, convert, OCR, QR codes, and watermarks.

9 modules

ModuleDescription
Bild komprimierenBilder komprimieren, um Dateigröße zu reduzieren und Qualität zu erhalten
Bild konvertierenBild in anderes Format konvertieren (PNG, JPEG, WEBP usw.)
Bild zuschneidenBild auf angegebene Koordinaten zuschneiden
Bild herunterladenBild von URL in lokale Datei herunterladen
OCR-Text extrahierenText aus Bildern mit OCR extrahieren
QR-Code generierenQR-Codes aus Text, URLs oder Daten generieren
Bildgröße ändernBilder auf angegebene Abmessungen mit verschiedenen Algorithmen skalieren
Bild drehenBild um angegebene Gradzahl drehen
Wasserzeichen hinzufügenText- oder Bildwasserzeichen zu einem Bild hinzufügen

Modules

Bild komprimieren

image.compress

Bilder komprimieren, um Dateigröße zu reduzieren und Qualität zu erhalten

Parameters:

NameTypeRequiredDefaultDescription
input_pathstringYes-Path to the input image file
output_pathstringNo-Path where the processed image will be saved
qualitynumberNo85Quality level (1-100, higher is better)
optimizebooleanNoTrueApply additional optimization
max_size_kbnumberNo-Target maximum file size in KB
formatselect (png, jpeg, webp, gif, bmp, tiff)NopngOutput image format

Output:

FieldTypeDescription
output_pathstringPfad zum komprimierten Bild
original_size_bytesnumberPfad zum komprimierten Bild
compressed_size_bytesnumberOriginaldateigröße in Bytes
compression_rationumberKomprimierte Dateigröße in Bytes

Example: Compress with quality setting

yaml
input_path: /path/to/image.jpg
quality: 75

Example: Compress to target size

yaml
input_path: /path/to/image.png
max_size_kb: 500

Bild konvertieren

image.convert

Bild in anderes Format konvertieren (PNG, JPEG, WEBP usw.)

Parameters:

NameTypeRequiredDefaultDescription
input_pathstringYes-Path to the input image file
output_pathstringNo-Path where the processed image will be saved
formatselect (png, jpeg, webp, gif, bmp, tiff)YespngOutput image format
qualitynumberNo85Quality level (1-100, higher is better)
resizeobjectNo-Resize options:

Output:

FieldTypeDescription
pathstringPfad zum konvertierten Bild
sizenumberPfad zum konvertierten Bild
formatstringPfad zum konvertierten Bild
dimensionsobjectDateigröße in Bytes

Example: Convert PNG to JPEG

yaml
input_path: /tmp/image.png
format: jpeg
quality: 90

Bild zuschneiden

image.crop

Bild auf angegebene Koordinaten zuschneiden

Parameters:

NameTypeRequiredDefaultDescription
input_pathstringYes-Pfad zum Eingabebild
output_pathstringYes-Pfad für das Ausgabebild
leftnumberYes-Linke Koordinate des Zuschneidebereichs
topnumberYes-Obere Koordinate des Zuschneidebereichs
rightnumberYes-Rechte Koordinate des Zuschneidebereichs
bottomnumberYes-Untere Koordinate des Zuschneidebereichs

Output:

FieldTypeDescription
output_pathstringPfad zum zugeschnittenen Bild
widthintegerBreite des zugeschnittenen Bildes
heightintegerHöhe des zugeschnittenen Bildes
original_widthintegerOriginalbildbreite
original_heightintegerOriginalbildhöhe

Example: Crop center region

yaml
input_path: /path/to/image.png
output_path: /path/to/cropped.png
left: 100
top: 100
right: 500
bottom: 400

Bild herunterladen

image.download

Bild von URL in lokale Datei herunterladen

Parameters:

NameTypeRequiredDefaultDescription
urlstringYes-URL of the image to download
output_pathstringNo-Path where the processed image will be saved
output_dirstringNo/tmpDirectory where output files will be saved
headersobjectNo{}HTTP request headers as key-value pairs
timeoutnumberNo30Maximum time to wait in seconds

Output:

FieldTypeDescription
pathstringLokaler Dateipfad des heruntergeladenen Bildes
sizenumberLokaler Dateipfad des heruntergeladenen Bildes
content_typestringLokaler Dateipfad des heruntergeladenen Bildes
filenamestringDateigröße in Bytes

Example: Download image from URL

yaml
url: https://example.com/photo.jpg
output_dir: /tmp/images

OCR-Text extrahieren

image.ocr

Text aus Bildern mit OCR extrahieren

Parameters:

NameTypeRequiredDefaultDescription
image_pathstringYes-Pfad zur Bilddatei
languagestringNoengSprachcode für OCR (z.B. eng, chi_sim)
psmnumberNo3Tesseract-Seitensegmentierungsmodus
output_typeselect (text, data, boxes)NotextArt der OCR-Ausgabe (Text oder Daten)

Output:

FieldTypeDescription
textstringAus dem Bild extrahierter Text
confidencenumberOCR-Vertrauensbewertung
languagestringFür OCR verwendete Sprache

Example: Extract text from image

yaml
image_path: /path/to/document.png
language: eng

QR-Code generieren

image.qrcode_generate

QR-Codes aus Text, URLs oder Daten generieren

Parameters:

NameTypeRequiredDefaultDescription
datastringYes-Text, URL, or data to encode
output_pathstringNo-Path where the processed image will be saved
formatselect (png, svg)NopngOutput image format
sizenumberNo300Size in pixels
colorstringNo#000000Color of the QR code (hex or name)
backgroundstringNo#FFFFFFBackground color (hex or name)
error_correctionselect (L, M, Q, H)NoMError correction level
bordernumberNo4Border width in modules (quiet zone)
versionnumberNo-QR code version 1-40 (leave empty for auto-detect)
logo_pathstringNo-Path to logo image to embed in center

Output:

FieldTypeDescription
output_pathstringPfad zum generierten QR-Code-Bild
file_sizenumberPfad zum generierten QR-Code-Bild
dimensionsobjectGröße der Ausgabedatei in Bytes

Example: Generate URL QR code

yaml
data: https://flyto.dev
output_path: /tmp/flyto_qr.png

Example: Custom styled QR code

yaml
data: Hello World
color: #6366F1
size: 500
error_correction: H

Example: SVG QR code

yaml
data: https://flyto.dev
format: svg
border: 2

Bildgröße ändern

image.resize

Bilder auf angegebene Abmessungen mit verschiedenen Algorithmen skalieren

Parameters:

NameTypeRequiredDefaultDescription
input_pathstringYes-Path to the input image file
output_pathstringNo-Path where the processed image will be saved
widthnumberNo-Target width in pixels
heightnumberNo-Target height in pixels
scalenumberNo-Scale factor (e.g., 0.5 for half, 2.0 for double)
algorithmselect (lanczos, bicubic, bilinear, nearest)NolanczosResampling algorithm for resize
maintain_aspectbooleanNoTrueMaintain original aspect ratio

Output:

FieldTypeDescription
output_pathstringPfad zum skalierten Bild
original_sizeobjectPfad zum skalierten Bild
new_sizeobjectPfad zum skalierten Bild

Example: Resize to specific dimensions

yaml
input_path: /path/to/image.png
width: 800
height: 600

Example: Scale by factor

yaml
input_path: /path/to/image.png
scale: 0.5

Bild drehen

image.rotate

Bild um angegebene Gradzahl drehen

Parameters:

NameTypeRequiredDefaultDescription
input_pathstringYes-Pfad zum Eingabebild
output_pathstringYes-Pfad für das Ausgabebild
anglenumberYes-Drehwinkel in Grad
expandbooleanNoTrueAusgabe erweitern, um das gesamte gedrehte Bild aufzunehmen
fill_colorstringNo#000000Farbe zum Füllen leerer Bereiche nach der Drehung

Output:

FieldTypeDescription
output_pathstringPfad zum gedrehten Bild
widthintegerBreite des gedrehten Bildes
heightintegerHöhe des gedrehten Bildes
anglenumberWinkel, um den das Bild gedreht wurde

Example: Rotate 90 degrees

yaml
input_path: /path/to/image.png
output_path: /path/to/rotated.png
angle: 90

Wasserzeichen hinzufügen

image.watermark

Text- oder Bildwasserzeichen zu einem Bild hinzufügen

Parameters:

NameTypeRequiredDefaultDescription
input_pathstringYes-Pfad zum Eingabebild
output_pathstringYes-Pfad für das Ausgabebild
textstringNo-Text, der als Wasserzeichen verwendet wird
watermark_imagestringNo-Pfad zur Bilddatei, die als Wasserzeichen verwendet wird
positionselect (center, top-left, top-right, bottom-left, bottom-right)Nobottom-rightPosition des Wasserzeichens auf dem Bild
opacitynumberNo0.5Deckkraft des Wasserzeichens (0,0 bis 1,0)
font_sizenumberNo36Schriftgröße für Text-Wasserzeichen

Output:

FieldTypeDescription
output_pathstringPfad zum Bild mit Wasserzeichen
watermark_typestringArt des angewendeten Wasserzeichens (Text oder Bild)

Example: Add text watermark

yaml
input_path: /path/to/image.png
output_path: /path/to/watermarked.png
text: © 2026 Company
position: bottom-right
opacity: 0.5

Released under the Apache 2.0 License.