Skip to content

Image Processing

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

9 modules

ModuleDescription
Kompresuj obrazKompresuj obrazy, aby zmniejszyc rozmiar pliku, zachowujac jakosc
Konwertuj obrazKonwertuj obraz na inny format (PNG, JPEG, WEBP, itp.)
Przytnij obrazPrzytnij obraz do określonych współrzędnych
Pobierz obrazPobierz obraz z URL do pliku lokalnego
OCR Wyodrębnij tekstWyodrębnij tekst z obrazów za pomocą OCR
Generuj kod QRGeneruj kody QR z tekstu, URL lub danych
Zmien rozmiar obrazuZmien rozmiar obrazow do okreslonych wymiarow roznymi algorytmami
Obróć obrazObróć obraz o określoną liczbę stopni
Dodaj znak wodnyDodaj znak wodny tekstowy lub obrazkowy do obrazu

Modules

Kompresuj obraz

image.compress

Kompresuj obrazy, aby zmniejszyc rozmiar pliku, zachowujac jakosc

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_pathstringSciezka do skompresowanego obrazu
original_size_bytesnumberSciezka do skompresowanego obrazu
compressed_size_bytesnumberOryginalny rozmiar pliku w bajtach
compression_rationumberSkompresowany rozmiar pliku w bajtach

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

Konwertuj obraz

image.convert

Konwertuj obraz na inny format (PNG, JPEG, WEBP, itp.)

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
pathstringSciezka do przekonwertowanego obrazu
sizenumberSciezka do przekonwertowanego obrazu
formatstringSciezka do przekonwertowanego obrazu
dimensionsobjectRozmiar pliku w bajtach

Example: Convert PNG to JPEG

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

Przytnij obraz

image.crop

Przytnij obraz do określonych współrzędnych

Parameters:

NameTypeRequiredDefaultDescription
input_pathstringYes-Ścieżka do obrazu wejściowego
output_pathstringYes-Ścieżka dla obrazu wyjściowego
leftnumberYes-Lewa współrzędna obszaru przycięcia
topnumberYes-Górna współrzędna obszaru przycięcia
rightnumberYes-Prawa współrzędna obszaru przycięcia
bottomnumberYes-Dolna współrzędna obszaru przycięcia

Output:

FieldTypeDescription
output_pathstringŚcieżka do przyciętego obrazu
widthintegerSzerokość przyciętego obrazu
heightintegerWysokość przyciętego obrazu
original_widthintegerOryginalna szerokość obrazu
original_heightintegerOryginalna wysokość obrazu

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

Pobierz obraz

image.download

Pobierz obraz z URL do pliku lokalnego

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
pathstringLokalna sciezka pobranego obrazu
sizenumberLokalna sciezka pobranego obrazu
content_typestringLokalna sciezka pobranego obrazu
filenamestringRozmiar pliku w bajtach

Example: Download image from URL

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

OCR Wyodrębnij tekst

image.ocr

Wyodrębnij tekst z obrazów za pomocą OCR

Parameters:

NameTypeRequiredDefaultDescription
image_pathstringYes-Ścieżka do pliku obrazu
languagestringNoengKod języka dla OCR (np. eng, chi_sim)
psmnumberNo3Tryb segmentacji strony Tesseract
output_typeselect (text, data, boxes)NotextTyp wyjścia OCR (tekst lub dane)

Output:

FieldTypeDescription
textstringWyodrębniony tekst z obrazu
confidencenumberWynik pewności OCR
languagestringJęzyk użyty do OCR

Example: Extract text from image

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

Generuj kod QR

image.qrcode_generate

Generuj kody QR z tekstu, URL lub danych

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_pathstringSciezka do wygenerowanego obrazu kodu QR
file_sizenumberSciezka do wygenerowanego obrazu kodu QR
dimensionsobjectRozmiar pliku wyjsciowego w bajtach

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

Zmien rozmiar obrazu

image.resize

Zmien rozmiar obrazow do okreslonych wymiarow roznymi algorytmami

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_pathstringSciezka do zmienionego obrazu
original_sizeobjectSciezka do zmienionego obrazu
new_sizeobjectSciezka do zmienionego obrazu

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

Obróć obraz

image.rotate

Obróć obraz o określoną liczbę stopni

Parameters:

NameTypeRequiredDefaultDescription
input_pathstringYes-Ścieżka do obrazu wejściowego
output_pathstringYes-Ścieżka dla obrazu wyjściowego
anglenumberYes-Kąt obrotu w stopniach
expandbooleanNoTrueRozszerz wyjście, aby pomieścić cały obrócony obraz
fill_colorstringNo#000000Kolor wypełnienia pustych obszarów po obrocie

Output:

FieldTypeDescription
output_pathstringŚcieżka do obróconego obrazu
widthintegerSzerokość obróconego obrazu
heightintegerWysokość obróconego obrazu
anglenumberKąt, o jaki obrócono obraz

Example: Rotate 90 degrees

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

Dodaj znak wodny

image.watermark

Dodaj znak wodny tekstowy lub obrazkowy do obrazu

Parameters:

NameTypeRequiredDefaultDescription
input_pathstringYes-Ścieżka do obrazu wejściowego
output_pathstringYes-Ścieżka do obrazu wyjściowego
textstringNo-Tekst do użycia jako znak wodny
watermark_imagestringNo-Ścieżka do pliku obrazu do użycia jako znak wodny
positionselect (center, top-left, top-right, bottom-left, bottom-right)Nobottom-rightPozycja znaku wodnego na obrazie
opacitynumberNo0.5Przezroczystość znaku wodnego (0.0 do 1.0)
font_sizenumberNo36Rozmiar czcionki dla znaku wodnego tekstowego

Output:

FieldTypeDescription
output_pathstringŚcieżka do obrazu z znakiem wodnym
watermark_typestringRodzaj zastosowanego znaku wodnego (tekst lub obraz)

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.