Image crop to circle

POST /api/image-crop-circle

Crop an image to a circular shape with transparent corners. Output is PNG. Useful for avatars, profile pictures, and circular thumbnails.

Crops an image to a circular shape, with the corners outside the circle made transparent. Output is PNG. The circle is centred and inscribed in the image bounds — rectangular inputs become ellipse-cropped if you do not square the input first. Use `image-crop` first for a precisely-square crop, then this tool to make it circular. Common use: avatar / profile pictures.

Inputs

Name	Type	Default	Description
image*	file	—	Input image (PNG / JPEG / WebP).
feather	number (0…50)	0	Edge feathering as a percentage of the circle radius (0 = crisp).
format	enum (png \| webp)	"png"	Output format. PNG / WebP only — JPEG can't represent the transparent corners.

Response

Modes: binary, base64-json. Cache: yes (24h TTL).