# Bloxx Pics

> Image links you can change by changing the link. Every link is public; the key is the capability.

## Links

- https://bloxx.pics/<key>: the image as uploaded.
- https://bloxx.pics/<transforms>/<key>: the same image resized, cropped or restyled.
- https://bloxx.pics/<key>.json: what the image is: width and height in pixels, bytes, type, alt text, where it came from, and the ready-made sizes with the size each comes out at. Read this before using an image to check it fits.

A key looks like 3f2b...-....png. Keys are made by Bloxx on upload; you cannot choose one.

## Transforms

Comma separated, e.g. https://bloxx.pics/w_1080,ar_4:5,c_fill,g_auto/<key>

- w_<px>: width. Snapped UP to one of: 16, 32, 48, 64, 96, 128, 160, 240, 320, 400, 480, 640, 768, 960, 1080, 1280, 1600, 1920, 2560.
- h_<px>: height, same menu.
- ar_<a>:<b>: aspect ratio, one of: 1:1, 4:5, 5:4, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9, 21:9, 1.91:1. With w_, the height follows.
- c_fill (crop to fill the box), c_fit (fit inside it), c_pad (fit and pad), c_crop. Default: shrink to fit, never enlarge.
- g_auto (keep the subject), g_face, g_center, g_north, g_south, g_east, g_west. Or fx_<0-1>,fy_<0-1> for a focal point.
- f_auto (default: AVIF or WebP when the browser takes it), f_avif, f_webp, f_jpg, f_png. Use f_jpg for link-preview cards.
- q_50, q_60, q_70, q_80, q_90. Default: automatic.
- dpr_2, dpr_3: multiplies the width and height.
- e_grayscale, e_blur:<10|25|50|100|250>.
- b_<hex>: background colour for c_pad.

VALUES ARE SNAPPED AND LINKS ARE CANONICAL. An off-menu value, a different order or a default spelled out answers 301 with the one canonical link (w_700 goes to w_768). Use the canonical link you land on; it is the one that is cached.

## Ready-made sizes

- Web, 1280 wide: https://bloxx.pics/w_1280/<key>
- Website hero, 16:9: https://bloxx.pics/w_1920,ar_16:9,c_fill,g_auto/<key>
- Square: https://bloxx.pics/w_1080,ar_1:1,c_fill,g_auto/<key>
- Instagram post, 4:5: https://bloxx.pics/w_1080,ar_4:5,c_fill,g_auto/<key>
- Story, 9:16: https://bloxx.pics/w_1080,ar_9:16,c_fill,g_auto/<key>
- Link preview card, 1.91:1: https://bloxx.pics/w_1280,ar_1.91:1,c_fill,g_auto,f_jpg/<key>
- Thumbnail: https://bloxx.pics/w_320,ar_1:1,c_fill,g_auto/<key>

## Uploading

Through the Bloxx connector (upload_image): send the bytes as base64, or a public https source_url to copy an image from. PNG, JPEG, GIF, WebP or AVIF, up to 15 MB. Alt text is required. The answer is the link, its ready-made sizes, and the image's real size.