Transformation Parameters

Icefiery provides a powerful set of URL-based parameters for transforming images on-the-fly. These transformations are applied instantly and cached at the edge for optimal performance.

Basic Parameters

Dimensions

Parameter	Description	Example
width	Set width in pixels	?width=400
height	Set height in pixels	?height=300
min_width	Set minimum width in pixels	?min_width=200
max_width	Set maximum width in pixels	?max_width=800
min_height	Set minimum height in pixels	?min_height=150
max_height	Set maximum height in pixels	?max_height=600
resize	Resize mode: cover, contain, fill	?resize=cover

Constraints:

• Maximum dimensions: 25 megapixels (e.g., 5000 x 5000)
• Minimum dimensions: 1 x 1 pixel

Quality and Format

Parameter	Description	Example
quality	Image quality (20-100)	?quality=85
Format	Change via file extension	.webp, .png

Resize Modes

Cover (Default)

Fills the entire target dimensions while maintaining aspect ratio. May crop parts of the image.

https://cdn.icefiery.com/res/img_abc123.jpg?width=400&height=300&resize=cover

Contain

Fits the entire image within the target dimensions while maintaining aspect ratio. May leave empty space.

https://cdn.icefiery.com/res/img_abc123.jpg?width=400&height=300&resize=contain

Fill

Stretches the image to fill the target dimensions exactly, ignoring aspect ratio.

https://cdn.icefiery.com/res/img_abc123.jpg?width=400&height=300&resize=fill

Format Conversion

Convert images to different formats by changing the file extension:

Format	Extension	Use Case
JPEG	.jpg, .jpeg	Photos, complex images
PNG	.png	Graphics, transparency
WebP	.webp	Modern browsers, better compression

Example:

# Original JPEG
https://cdn.icefiery.com/res/img_abc123.jpg

# Convert to WebP
https://cdn.icefiery.com/res/img_abc123.webp

# Convert to PNG
https://cdn.icefiery.com/res/img_abc123.png

Quality Control

The quality parameter controls the compression level and file size:

• Higher values (80-100): Better quality, larger files
• Lower values (20-40): Smaller files, visible compression
• Default: 85 (good balance of quality and size)

Example:

# High quality
https://cdn.icefiery.com/res/img_abc123.jpg?quality=95

# Optimized for size
https://cdn.icefiery.com/res/img_abc123.jpg?quality=60

Combining Parameters

Parameters can be combined to achieve the desired result:

# Resize and convert to WebP
https://cdn.icefiery.com/res/img_abc123.webp?width=400&height=300&resize=cover

# High quality PNG with specific dimensions
https://cdn.icefiery.com/res/img_abc123.png?width=800&height=600&quality=90

# Responsive image with height constraint
https://cdn.icefiery.com/res/img_abc123.webp?max_height=300&quality=85

# Complex transformation with multiple constraints
https://cdn.icefiery.com/res/img_abc123.jpg?max_width=600&max_height=400&resize=cover&quality=80

Next Steps

• Image Formats and Limits - Supported formats and size restrictions
• Rate Limiting and Usage Quotas - Usage limits and quotas
• API Reference - Complete API documentation