Image Processing

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

9 modules

Module	Description
Compress Image	Compress images to reduce file size while maintaining quality
Convert Image	Convert image to different format (PNG, JPEG, WEBP, etc.)
Crop Image	Crop an image to specified coordinates
Download Image	Download image from URL to local file
OCR Extract Text	Extract text from images using OCR
Generate QR Code	Generate QR codes from text, URLs, or data
Resize Image	Resize images to specified dimensions with various algorithms
Rotate Image	Rotate an image by specified degrees
Add Watermark	Add text or image watermark to an image

Modules

Compress Image

image.compress

Compress images to reduce file size while maintaining quality

Parameters:

Name	Type	Required	Default	Description
input_path	string	Yes	-	Path to the input image file
output_path	string	No	-	Path where the processed image will be saved
quality	number	No	85	Quality level (1-100, higher is better)
optimize	boolean	No	True	Apply additional optimization
max_size_kb	number	No	-	Target maximum file size in KB
format	select (png, jpeg, webp, gif, bmp, tiff)	No	png	Output image format

Output:

Field	Type	Description
output_path	string	Path to the compressed image
original_size_bytes	number	Path to the compressed image
compressed_size_bytes	number	Original file size in bytes
compression_ratio	number	Compressed file size in bytes

Example: Compress with quality setting

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

Example: Compress to target size

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

Convert Image

image.convert

Convert image to different format (PNG, JPEG, WEBP, etc.)

Parameters:

Name	Type	Required	Default	Description
input_path	string	Yes	-	Path to the input image file
output_path	string	No	-	Path where the processed image will be saved
format	select (png, jpeg, webp, gif, bmp, tiff)	Yes	png	Output image format
quality	number	No	85	Quality level (1-100, higher is better)
resize	object	No	-	Resize options:

Output:

Field	Type	Description
path	string	Path to the converted image
size	number	Path to the converted image
format	string	Path to the converted image
dimensions	object	File size in bytes

Example: Convert PNG to JPEG

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

Crop Image

image.crop

Crop an image to specified coordinates

Parameters:

Name	Type	Required	Default	Description
input_path	string	Yes	-	Path to the input image
output_path	string	Yes	-	Path for the output image
left	number	Yes	-	Left coordinate of the crop area
top	number	Yes	-	Top coordinate of the crop area
right	number	Yes	-	Right coordinate of the crop area
bottom	number	Yes	-	Bottom coordinate of the crop area

Output:

Field	Type	Description
output_path	string	Path to the cropped image
width	integer	Width of the cropped image
height	integer	Height of the cropped image
original_width	integer	Original image width
original_height	integer	Original image height

Example: Crop center region

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

Download Image

image.download

Download image from URL to local file

Parameters:

Name	Type	Required	Default	Description
url	string	Yes	-	URL of the image to download
output_path	string	No	-	Path where the processed image will be saved
output_dir	string	No	/tmp	Directory where output files will be saved
headers	object	No	{}	HTTP request headers as key-value pairs
timeout	number	No	30	Maximum time to wait in seconds

Output:

Field	Type	Description
path	string	Local file path of downloaded image
size	number	Local file path of downloaded image
content_type	string	Local file path of downloaded image
filename	string	File size in bytes

Example: Download image from URL

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

OCR Extract Text

image.ocr

Extract text from images using OCR

Parameters:

Name	Type	Required	Default	Description
image_path	string	Yes	-	Path to the image file
language	string	No	eng	Language code for OCR (e.g. eng, chi_sim)
psm	number	No	3	Tesseract page segmentation mode
output_type	select (text, data, boxes)	No	text	Type of OCR output (text or data)

Output:

Field	Type	Description
text	string	Extracted text from the image
confidence	number	OCR confidence score
language	string	Language used for OCR

Example: Extract text from image

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

Generate QR Code

image.qrcode_generate

Generate QR codes from text, URLs, or data

Parameters:

Name	Type	Required	Default	Description
data	string	Yes	-	Text, URL, or data to encode
output_path	string	No	-	Path where the processed image will be saved
format	select (png, svg)	No	png	Output image format
size	number	No	300	Size in pixels
color	string	No	#000000	Color of the QR code (hex or name)
background	string	No	#FFFFFF	Background color (hex or name)
error_correction	select (L, M, Q, H)	No	M	Error correction level
border	number	No	4	Border width in modules (quiet zone)
version	number	No	-	QR code version 1-40 (leave empty for auto-detect)
logo_path	string	No	-	Path to logo image to embed in center

Output:

Field	Type	Description
output_path	string	Path to the generated QR code image
file_size	number	Path to the generated QR code image
dimensions	object	Size of the output file in bytes

Example: Generate URL QR code

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

Example: Custom styled QR code

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

Example: SVG QR code

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

Resize Image

image.resize

Resize images to specified dimensions with various algorithms

Parameters:

Name	Type	Required	Default	Description
input_path	string	Yes	-	Path to the input image file
output_path	string	No	-	Path where the processed image will be saved
width	number	No	-	Target width in pixels
height	number	No	-	Target height in pixels
scale	number	No	-	Scale factor (e.g., 0.5 for half, 2.0 for double)
algorithm	select (lanczos, bicubic, bilinear, nearest)	No	lanczos	Resampling algorithm for resize
maintain_aspect	boolean	No	True	Maintain original aspect ratio

Output:

Field	Type	Description
output_path	string	Path to the resized image
original_size	object	Path to the resized image
new_size	object	Path to the resized image

Example: Resize to specific dimensions

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

Example: Scale by factor

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

Rotate Image

image.rotate

Rotate an image by specified degrees

Parameters:

Name	Type	Required	Default	Description
input_path	string	Yes	-	Path to the input image
output_path	string	Yes	-	Path for the output image
angle	number	Yes	-	Rotation angle in degrees
expand	boolean	No	True	Expand output to hold the entire rotated image
fill_color	string	No	#000000	Color to fill empty areas after rotation

Output:

Field	Type	Description
output_path	string	Path to the rotated image
width	integer	Width of the rotated image
height	integer	Height of the rotated image
angle	number	Angle the image was rotated

Example: Rotate 90 degrees

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

Add Watermark

image.watermark

Add text or image watermark to an image

Parameters:

Name	Type	Required	Default	Description
input_path	string	Yes	-	Path to the input image
output_path	string	Yes	-	Path for the output image
text	string	No	-	Text to use as watermark
watermark_image	string	No	-	Path to image file to use as watermark
position	select (center, top-left, top-right, bottom-left, bottom-right)	No	bottom-right	Position of the watermark on the image
opacity	number	No	0.5	Watermark opacity (0.0 to 1.0)
font_size	number	No	36	Font size for text watermark

Output:

Field	Type	Description
output_path	string	Path to the watermarked image
watermark_type	string	Type of watermark applied (text or image)

Example: Add text watermark

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