Image Cover API

Transform images into 4:5 covers with two processing modes: horizontal layout with blur backgrounds, or vertical layout filling the entire frame.

Demo

API URL Builder

≥1.0 = horizontal mode, <1.0 = vertical mode

Processing Modes

Horizontal Mode

Images with aspect ratio ≥ 1.0 (square or landscape)

  • • Rounded corners (24px radius)
  • • Blur background from same image
  • • Centered with padding (48px)
  • • Maintains original aspect ratio

Vertical Mode

Images with aspect ratio < 1.0 (portrait)

  • • Fills entire 4:5 frame
  • • No background or padding
  • • No rounded corners
  • • Uses object-fit: cover

API Reference

Basic Usage:

GET /cover?url=https%3A%2F%2Fexample.com%2Fimage.jpg

Parameters:

url - Image URL (required)
aspectRatio - Width/Height ratio (determines mode)
w - Width (default: 1080)
h - Height (default: 1350)

• aspectRatio ≥ 1.0 = Horizontal mode (rounded corners + blur background)
• aspectRatio < 1.0 = Vertical mode (fills entire frame)

Examples:

Horizontal (landscape):

/cover?url=https%3A%2F%2Fimages.unsplash.com%2Fphoto-1506905925346-21bda4d32df4&aspectRatio=1.5

Vertical (portrait):

/cover?url=https%3A%2F%2Fimages.unsplash.com%2Fphoto-1544005313-94ddf0286df2&aspectRatio=0.67

Technical Details

Input Formats

  • • JPEG/JPG
  • • PNG
  • • WebP (via proxy conversion)
  • • AVIF
  • • GIF (first frame)
  • • SVG

Output

  • • Format: PNG
  • • Default size: 1080×1350 (4:5)
  • • Edge runtime optimized
  • • CDN cached responses