Skip to main content

​
Parameter Reference

Quick reference for all available parameters:
ParameterFull NameDescription
wwidthImage width in pixels
hheightImage height in pixels
ccropCrop mode for resizing
araspect ratioAspect ratio (format: W:H)
aangleRotation angle in degrees
ggravityFocal point for cropping
bbackgroundBackground color
qqualityCompression quality (1-100)
fformatOutput format (avif, webp, jpeg, png)

​
Core Parameters

​
w
integer
Set the width of the image in pixels.Examples:
  • w_800 - Set width to 800 pixels
  • w_1920 - Set width to Full HD
  • w_400 - Set width to 400 pixels
​
h
integer
Set the height of the image in pixels.Examples:
  • h_600 - Set height to 600 pixels
  • h_1080 - Set height to Full HD
  • h_400 - Set height to 400 pixels
​
c
string
default:"fill"
Define how the image is cropped during resizing.Available modes:
  • fill - Fill entire area, cropping if necessary (default)
  • fit - Fit within dimensions while preserving aspect ratio
  • scale - Stretch to exact dimensions, ignoring aspect ratio
  • crop - Resize and crop to exact dimensions
  • pad - Fit and add borders with background color
​
ar
string
Apply a specific aspect ratio by cropping the image. Format: W:H.Common ratios:
  • ar_16:9 - Widescreen video format
  • ar_1:1 - Square format (Instagram)
  • ar_4:3 - Classic photo format
​
a
string | number
Rotate the image by specified degrees or automatically using data.Values:
  • auto - Automatic rotation based on EXIF orientation
  • 0-360 - Rotation angle in degrees
​
g
string
Define the focal point for cropping operations.Available positions:
  • center - Center of the image (default)
  • north - Top edge
  • south - Bottom edge
  • east - Right edge
  • west - Left edge
  • face - AI-powered face detection
  • auto - Automatic detection of region of interest using entropy analysis
​
b
string
Set background color for rotation or pad crop mode.Format:
  • b_rgb:ffffff - Hexadecimal color without # (e.g., b_rgb:ffffff for white, b_rgb:ff0000 for red)
​
q
integer
default:"85"
Control compression quality level. Range: 1-100.Recommendations:
  • 90-100 - High quality, larger file size
  • 80-89 - Optimal balance (recommended)
  • 60-79 - Higher compression, smaller files
  • 1-59 - Maximum compression, visible artifacts
​
f
string
Force a specific output format.Available formats:
  • avif - Modern format, best compression (up to 50% smaller)
  • webp - Modern format, excellent compatibility
  • jpeg / jpg - Universal standard format
  • png - Lossless, supports transparency

​
Basic Examples

GET /t/w_800,h_600/image.jpg
Resize an image to 800×600 pixels using default fill mode.

​
Advanced Examples

GET /t/ar_1:1,w_1080,h_1080,g_face,q_85,f_webp/portrait.jpg
Perfect square format with face-focused cropping and WebP output for social media.
GET /t/w_400,h_300,c_pad,b_rgb:f5f5f5,q_80/thumbnail.jpg
Create a padded thumbnail with light gray background for consistent dimensions.
GET /t/a_15,w_200,h_200/logo.png
Rotate a logo by 15 degrees. PNG format preserves transparency automatically.
GET /t/w_1920,h_1080,q_85,f_avif/landscape.jpg
Full HD output with AVIF format for maximum compression and quality balance.

​
Supported Image Formats

The system accepts the following image formats as input:
  • JPEG / JPG - Standard photo format
  • PNG - With full transparency support
  • WebP - Modern web format
  • AVIF - Next-generation format
  • GIF - First frame only (static output)

​
Best Practices

Optimize for web

Use q_85 with automatic format selection for the best balance of quality and file size.

Leverage face detection

Apply g_face for portraits and profile images to ensure faces remain in frame after cropping.

Batch similar sizes

Standardize image dimensions across your application to maximize cache efficiency.

Use modern formats

Specify f_avif or f_webp for significant file size reductions on modern browsers.