URL Syntax

Updated: Apr 19, 2026

image-processing url-syntax

Standard Format

Key-value pairs separated by underscores:

Code

/{operation}_{param}_{value}_{param}_{value}/

Example:

Code

/resize_width_800_height_600/sharpen_sigma_1.2/quality_value_85/

Positional values separated by hyphens:

Code

/{operation}-{value1}-{value2}/

Example:

Code

/resize-800-600/sharp-1.2/q-85/

Operations are chained as path segments, processed left to right:

Code

/resize-800-600/sharp-1.2/bright-1.1/q-85/image-id.jpg

Paid plans (custom subdomain):

Code

https://{subdomain}.viucraft.com/{operations}/{image-id}.{format}

Free plan (shared endpoint):

Code

https://viucraft.com/free/acc_{id}/{operations}/{image-id}.{format}

Operation	Short	Params
resize	resize	width, height, force, scale
crop	crop	left, top, width, height
thumbnail	thumb	width, height, crop, background
smartcrop	scrop	width, height, strategy
brightness	bright	factor
contrast	con	factor
gamma	gam	exponent
saturation	sat	factor
hue	hue	angle
colorize	col	color, amount
tint	tint	highlight, shadow
invert	inv	(none)
grayscale	gray	(none)
sepia	sepia	(none)
autoenhance	auto	strength
blur	blur	sigma
sharpen	sharp	sigma, x1, y2, y3
edge	edge	(none)
emboss	emb	(none)
median	med	size
vignette	vig	scale, opacity, color
noise	noise	amount, type
pixelate	pix	size
rotate	rot	angle, background
flip	flip	direction
border	brd	width, color, radius, shadow_blur, shadow_color, shadow_x, shadow_y
watermark	wmt	text, opacity, position, size, color, rotation
tiled_watermark	twm	text, size, color, opacity, spacing, rotation
svg_overlay	svg	data, x, y, scale, opacity
quality	q	value
strip	strip	(none)
placeholder	lqip	size

| responsive | resp | widths, format |