blobatar API

Geometric SVG avatars generated from names or seeds. No authentication required.

Routes

• GET /avatar/<name> renders an avatar.
• GET /seeded/<seed> renders the same seed deterministically.
• GET /random renders a new avatar on every request.
• GET /docs opens the interactive Scalar reference.
• GET /openapi.json returns the OpenAPI 3.1 specification.

Examples

curl http://localhost:3000/avatar/alain?size=64

curl http://localhost:3000/seeded/team-rocket?gen=2&background=squircle

curl http://localhost:3000/random?expression=happy

Options

Optional query parameters: size/s, background, hue, tone, expression, title and gen. Use gen=1 or gen=2 to pin shape generation.

/random returns its generated value in the X-Blobatar-Seed response header. Use that value with /seeded/<seed> to reproduce the avatar.