Image Proxy CDN

​

Overview

​

Endpoints

​

Proxy Image Processing

​

Path Parameters

​

Query Parameters

​

Fit Modes

• contain - Resize to fit within dimensions, maintaining aspect ratio
• cover - Scale to fill dimensions, cropping excess (centers crop unless crop_x/crop_y specified)
• scale-down - Only resize if image is larger than target dimensions
• crop - Scale and crop to exact dimensions
• pad - Resize to fit and pad remaining space with transparent background
• squeeze - Stretch/squash to exact dimensions, ignoring aspect ratio

​

Dimension Behavior

• If only width is provided: height is calculated to maintain aspect ratio
• If only height is provided: width is calculated to maintain aspect ratio
• If both are provided: behavior depends on fit mode
• If neither is provided: original dimensions are used

​

Examples

# Proxy and resize external image to width 800
GET https://image-proxy.enad.io/{app_id}?src=https://example.com/image.jpg&width=800

# Proxy, convert to WebP, and set quality
GET https://image-proxy.enad.io/{app_id}?src=https://example.com/image.jpg&format=webp&quality=90

# Proxy and crop to exact dimensions
GET https://image-proxy.enad.io/{app_id}?src=https://example.com/image.jpg&width=1920&height=1080&fit=cover

# Proxy with blur effect
GET https://image-proxy.enad.io/{app_id}?src=https://example.com/image.jpg&width=800&blur=5.0

​

Response

• Content-Type: Varies based on output format (e.g., image/jpeg, image/webp)
• Status Codes:
  • 200 OK - Success
  • 400 Bad Request - Invalid parameters or failed to fetch source image
  • 500 Internal Server Error - Processing or storage error

​

Limits

• Dimensions: Maximum 5000x5000 pixels
• Minimum Dimensions: At least 1 pixel
• Image Quality: 0-100
• Blur Range: 0.0-100.0
• URL: Must be a valid HTTP/HTTPS URL passed in src