Skip to content

Image Processing

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

9 modules

ModuleDescription
Comprimir imagenComprimir imagenes para reducir tamano de archivo manteniendo calidad
Convertir imagenConvertir imagen a diferente formato (PNG, JPEG, WEBP, etc.)
Recortar ImagenRecorta una imagen a las coordenadas especificadas
Descargar imagenDescargar imagen de URL a archivo local
Extraer Texto OCRExtrae texto de imágenes usando OCR
Generar codigo QRGenerar codigos QR desde texto, URLs o datos
Redimensionar imagenRedimensionar imagenes a dimensiones especificadas con varios algoritmos
Rotar ImagenRota una imagen por grados especificados
Añadir Marca de AguaAñadir marca de agua de texto o imagen a una imagen

Modules

Comprimir imagen

image.compress

Comprimir imagenes para reducir tamano de archivo manteniendo calidad

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_pathstringRuta a la imagen comprimida
original_size_bytesnumberRuta a la imagen comprimida
compressed_size_bytesnumberTamano original del archivo en bytes
compression_rationumberTamano comprimido del archivo en 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

Convertir imagen

image.convert

Convertir imagen a diferente formato (PNG, JPEG, WEBP, etc.)

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
pathstringRuta a la imagen convertida
sizenumberRuta a la imagen convertida
formatstringRuta a la imagen convertida
dimensionsobjectTamano del archivo en bytes

Example: Convert PNG to JPEG

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

Recortar Imagen

image.crop

Recorta una imagen a las coordenadas especificadas

Parameters:

NameTypeRequiredDefaultDescription
input_pathstringYes-Ruta de la imagen de entrada
output_pathstringYes-Ruta para la imagen de salida
leftnumberYes-Coordenada izquierda del área de recorte
topnumberYes-Coordenada superior del área de recorte
rightnumberYes-Coordenada derecha del área de recorte
bottomnumberYes-Coordenada inferior del área de recorte

Output:

FieldTypeDescription
output_pathstringRuta de la imagen recortada
widthintegerAncho de la imagen recortada
heightintegerAltura de la imagen recortada
original_widthintegerAncho original de la imagen
original_heightintegerAltura original de la imagen

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

Descargar imagen

image.download

Descargar imagen de URL a archivo local

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
pathstringRuta local del archivo de imagen descargado
sizenumberRuta local del archivo de imagen descargado
content_typestringRuta local del archivo de imagen descargado
filenamestringTamano del archivo en bytes

Example: Download image from URL

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

Extraer Texto OCR

image.ocr

Extrae texto de imágenes usando OCR

Parameters:

NameTypeRequiredDefaultDescription
image_pathstringYes-Ruta al archivo de imagen
languagestringNoengCódigo de idioma para OCR (ej. eng, chi_sim)
psmnumberNo3Modo de segmentación de página de Tesseract
output_typeselect (text, data, boxes)NotextTipo de salida OCR (texto o datos)

Output:

FieldTypeDescription
textstringTexto extraído de la imagen
confidencenumberPuntuación de confianza del OCR
languagestringIdioma usado para OCR

Example: Extract text from image

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

Generar codigo QR

image.qrcode_generate

Generar codigos QR desde texto, URLs o datos

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_pathstringRuta a la imagen de codigo QR generada
file_sizenumberRuta a la imagen de codigo QR generada
dimensionsobjectTamano del archivo de salida en 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

Redimensionar imagen

image.resize

Redimensionar imagenes a dimensiones especificadas con varios algoritmos

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_pathstringRuta a la imagen redimensionada
original_sizeobjectRuta a la imagen redimensionada
new_sizeobjectRuta a la imagen redimensionada

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

Rotar Imagen

image.rotate

Rota una imagen por grados especificados

Parameters:

NameTypeRequiredDefaultDescription
input_pathstringYes-Ruta de la imagen de entrada
output_pathstringYes-Ruta para la imagen de salida
anglenumberYes-Ángulo de rotación en grados
expandbooleanNoTrueExpandir salida para contener toda la imagen rotada
fill_colorstringNo#000000Color para llenar áreas vacías después de la rotación

Output:

FieldTypeDescription
output_pathstringRuta de la imagen rotada
widthintegerAncho de la imagen rotada
heightintegerAltura de la imagen rotada
anglenumberÁngulo al que se rotó la imagen

Example: Rotate 90 degrees

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

Añadir Marca de Agua

image.watermark

Añadir marca de agua de texto o imagen a una imagen

Parameters:

NameTypeRequiredDefaultDescription
input_pathstringYes-Ruta de la imagen de entrada
output_pathstringYes-Ruta para la imagen de salida
textstringNo-Texto a usar como marca de agua
watermark_imagestringNo-Ruta al archivo de imagen para usar como marca de agua
positionselect (center, top-left, top-right, bottom-left, bottom-right)Nobottom-rightPosición de la marca de agua en la imagen
opacitynumberNo0.5Opacidad de la marca de agua (0.0 a 1.0)
font_sizenumberNo36Tamaño de fuente para la marca de agua de texto

Output:

FieldTypeDescription
output_pathstringRuta de la imagen con marca de agua
watermark_typestringTipo de marca de agua aplicada (texto o imagen)

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.