Media API

​

Overview

​

Endpoints

​

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

# Resize to width 800, maintain aspect ratio
GET https://media.enad.io/{app_id}/photo.jpg?width=800

# Convert to WebP with quality 90
GET https://media.enad.io/{app_id}/photo.jpg?format=webp&quality=90

# Resize and crop to exact dimensions
GET https://media.enad.io/{app_id}/photo.jpg?width=1920&height=1080&fit=cover

# Add blur effect
GET https://media.enad.io/{app_id}/photo.jpg?width=800&blur=5.0

# Fill transparent areas with white
GET https://media.enad.io/{app_id}/photo.png?fill=%23FFFFFF

# Custom crop position
GET https://media.enad.io/{app_id}/photo.jpg?width=500&height=500&fit=cover&crop_x=100&crop_y=50

​

Response

• Content-Type: Varies based on output format
  • image/png
  • image/jpeg
  • image/webp
  • image/avif
• Status Codes:
  • 200 OK - Success
  • 400 Bad Request - Invalid parameters
  • 404 Not Found - Image not found
  • 500 Internal Server Error - Processing error

​

Limits

• Dimensions: Maximum 5000x5000 pixels
• Minimum Dimensions: At least 1 pixel
• Image Quality: 0-100
• Blur Range: 0.0-100.0
• URL: Maximum 16 KB (typical HTTP limit)

​

Error Responses

​

400 Bad Request

• Invalid dimensions (outside 1-5000 range)
• Invalid fit mode for given dimensions
• Invalid format specified
• Invalid hex color format
• Invalid blur value
• Crop offsets exceed image bounds

​

404 Not Found

• Requested image file doesn’t exist in bucket

​

500 Internal Server Error

• Image processing fails
• Internal Server Error