Skip to content

Image Processing

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

9 modules

ModuleDescription
Görüntü SıkıştırKaliteyi koruyarak dosya boyutunu azaltmak için görüntüleri sıkıştır
Görüntü DönüştürGörüntüyü farklı formata dönüştür (PNG, JPEG, WEBP vb.)
Resmi KırpBir resmi belirtilen koordinatlara göre kırpın
Görüntü İndirURL'den görüntüyü yerel dosyaya indir
OCR Metin ÇıkarOCR kullanarak resimlerden metin çıkarın
QR Kodu OluşturMetin, URL veya veriden QR kodları oluştur
Görüntü Yeniden BoyutlandırGörüntüleri çeşitli algoritmalarla belirtilen boyutlara yeniden boyutlandır
Resmi DöndürBir resmi belirtilen derece kadar döndürün
Filigran EkleBir resme metin veya resim filigranı ekleyin

Modules

Görüntü Sıkıştır

image.compress

Kaliteyi koruyarak dosya boyutunu azaltmak için görüntüleri sıkıştır

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_pathstringSıkıştırılmış görüntünün yolu
original_size_bytesnumberSıkıştırılmış görüntünün yolu
compressed_size_bytesnumberOrijinal dosya boyutu (bayt)
compression_rationumberSıkıştırılmış dosya boyutu (bayt)

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

Görüntü Dönüştür

image.convert

Görüntüyü farklı formata dönüştür (PNG, JPEG, WEBP vb.)

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
pathstringDönüştürülen görüntünün yolu
sizenumberDönüştürülen görüntünün yolu
formatstringDönüştürülen görüntünün yolu
dimensionsobjectDosya boyutu (bayt)

Example: Convert PNG to JPEG

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

Resmi Kırp

image.crop

Bir resmi belirtilen koordinatlara göre kırpın

Parameters:

NameTypeRequiredDefaultDescription
input_pathstringYes-Giriş resminin yolu
output_pathstringYes-Çıktı resminin yolu
leftnumberYes-Kırpma alanının sol koordinatı
topnumberYes-Kırpma alanının üst koordinatı
rightnumberYes-Kırpma alanının sağ koordinatı
bottomnumberYes-Kırpma alanının alt koordinatı

Output:

FieldTypeDescription
output_pathstringKırpılan resmin yolu
widthintegerKırpılan resmin genişliği
heightintegerKırpılan resmin yüksekliği
original_widthintegerOrijinal resmin genişliği
original_heightintegerOrijinal resmin yüksekliği

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

Görüntü İndir

image.download

URL'den görüntüyü yerel dosyaya indir

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
pathstringİndirilen görüntünün yerel dosya yolu
sizenumberİndirilen görüntünün yerel dosya yolu
content_typestringİndirilen görüntünün yerel dosya yolu
filenamestringDosya boyutu (bayt)

Example: Download image from URL

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

OCR Metin Çıkar

image.ocr

OCR kullanarak resimlerden metin çıkarın

Parameters:

NameTypeRequiredDefaultDescription
image_pathstringYes-Resim dosyasının yolu
languagestringNoengOCR için dil kodu (örn. eng, chi_sim)
psmnumberNo3Tesseract sayfa segmentasyon modu
output_typeselect (text, data, boxes)NotextOCR çıktısı türü (metin veya veri)

Output:

FieldTypeDescription
textstringResimden çıkarılan metin
confidencenumberOCR güven puanı
languagestringOCR için kullanılan dil

Example: Extract text from image

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

QR Kodu Oluştur

image.qrcode_generate

Metin, URL veya veriden QR kodları oluştur

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_pathstringOluşturulan QR kodu görüntüsünün yolu
file_sizenumberOluşturulan QR kodu görüntüsünün yolu
dimensionsobjectÇıktı dosyasının boyutu (bayt)

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

Görüntü Yeniden Boyutlandır

image.resize

Görüntüleri çeşitli algoritmalarla belirtilen boyutlara yeniden boyutlandır

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_pathstringYeniden boyutlandırılan görüntünün yolu
original_sizeobjectYeniden boyutlandırılan görüntünün yolu
new_sizeobjectYeniden boyutlandırılan görüntünün yolu

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

Resmi Döndür

image.rotate

Bir resmi belirtilen derece kadar döndürün

Parameters:

NameTypeRequiredDefaultDescription
input_pathstringYes-Giriş resminin yolu
output_pathstringYes-Çıktı resminin yolu
anglenumberYes-Dönüş açısı (derece cinsinden)
expandbooleanNoTrueDöndürülen tüm resmi tutmak için çıktıyı genişletin
fill_colorstringNo#000000Dönüşten sonra boş alanları doldurmak için renk

Output:

FieldTypeDescription
output_pathstringDöndürülen resmin yolu
widthintegerDöndürülen resmin genişliği
heightintegerDöndürülen resmin yüksekliği
anglenumberResmin döndürüldüğü açı

Example: Rotate 90 degrees

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

Filigran Ekle

image.watermark

Bir resme metin veya resim filigranı ekleyin

Parameters:

NameTypeRequiredDefaultDescription
input_pathstringYes-Giriş resminin yolu
output_pathstringYes-Çıktı resminin yolu
textstringNo-Filigran olarak kullanılacak metin
watermark_imagestringNo-Filigran olarak kullanılacak resim dosyasının yolu
positionselect (center, top-left, top-right, bottom-left, bottom-right)Nobottom-rightResim üzerindeki filigranın konumu
opacitynumberNo0.5Filigran opaklığı (0.0 ile 1.0 arası)
font_sizenumberNo36Metin filigranı için yazı tipi boyutu

Output:

FieldTypeDescription
output_pathstringFiligranlı resmin yolu
watermark_typestringUygulanan filigran türü (metin veya resim)

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.