Deterministic avatar generation API. No accounts. No rate limits.

Endpoints

GET /avatar/:name Generate an avatar for any name or identifier
GET /health Health check

Usage

SVG — default
/avatar/alice
SVG with custom size
/avatar/alice?size=400
PNG
/avatar/alice?format=png&size=200
BMP
/avatar/alice?format=bmp&size=200

Parameters

param default description
format svg Output format. One of svg, png, bmp.
size 200 Total image width & height in px. The same across all formats -- size=200 always produces a 200x200 image.

How it works

The input name is hashed to produce a deterministic seed. That seed drives a 5x5 symmetric grid of filled and empty cells, plus a foreground and background colour drawn from a fixed palette. The same name always produces the same avatar.

Avatars are suitable as placeholder profile images, identicons for user accounts, or anywhere you need a unique visual identity derived from a string.