Suils

Avatar API

Self-hosted Suils · 37 styles · deterministic SVG & raster avatars from any seed.

Editor → Docs → /styles (JSON)

Usage

GET /{style}/{format}?seed=<custom-seed>&<options>

# SVG (default)
https://avatars.suils.es/lorelei/svg?seed=Felix

# PNG 256px with a custom background
https://avatars.suils.es/lorelei/png?seed=Jane&size=256&backgroundColor=b6e3f4

# JSON (svg + resolved options)
https://avatars.suils.es/bottts/json?seed=Robot

Formats: svg, png, jpg, webp, avif, json. Every option from the style is accepted as a query parameter (lists comma-separated).

Styles

adventurer adventurer adventurer-neutral adventurer-neutral avataaars avataaars avataaars-neutral avataaars-neutral big-ears big-ears big-ears-neutral big-ears-neutral big-smile big-smile bottts bottts bottts-neutral bottts-neutral croodles croodles croodles-neutral croodles-neutral disco disco dylan dylan fun-emoji fun-emoji glass glass glyphs glyphs icons icons identicon identicon initial-face initial-face initials initials lorelei lorelei lorelei-neutral lorelei-neutral micah micah miniavs miniavs notionists notionists notionists-neutral notionists-neutral open-peeps open-peeps personas personas pixel-art pixel-art pixel-art-neutral pixel-art-neutral rings rings shape-grid shape-grid shapes shapes stripes stripes thumbs thumbs toon-head toon-head triangles triangles