{"openapi":"3.1.0","info":{"title":"Avatar API","version":"1.0.0","description":"Generate deterministic avatars and identicons from any seed — the same seed always renders the exact same avatar, so user IDs, usernames or emails map to stable, unique profile pictures with no storage. 30 art styles (bottts robots, pixel-art, avataaars, identicon, lorelei, notionists, fun-emoji, shapes, rings and more), returned as ready-to-use SVG markup or a base64 PNG data-URI, with options for size, corner radius, background colour and flip. Backed by DiceBear. Ideal for default user avatars, comment/forum placeholders, dashboards, game characters, test fixtures and any UI that needs an instant, reproducible profile image.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/avatar-api","description":"oanor gateway"}],"tags":[{"name":"Avatars"},{"name":"Reference"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/avatar":{"get":{"operationId":"get_v1_avatar","tags":["Avatars"],"summary":"Generate an avatar from a style + seed","description":"","parameters":[{"name":"style","in":"query","required":false,"description":"Avatar style (see /v1/styles), e.g. bottts, pixel-art, identicon","schema":{"type":"string"},"example":"bottts"},{"name":"seed","in":"query","required":true,"description":"Any seed — user id, username, email; same seed = same avatar","schema":{"type":"string"},"example":"oanor"},{"name":"format","in":"query","required":false,"description":"svg (markup) or png (base64 data-URI), default svg","schema":{"type":"string"},"example":"svg"},{"name":"size","in":"query","required":false,"description":"Pixel size 16-512","schema":{"type":"string"},"example":"128"},{"name":"background","in":"query","required":false,"description":"6-digit hex background colour, e.g. b6e3f4","schema":{"type":"string"}},{"name":"radius","in":"query","required":false,"description":"Corner radius 0-50","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"avatar":{"svg":"BotttsPablo Stanleyhttps://bottts.com/https://bottts.com/Remix of „Bottts” (https://bottts.com/) by „Pablo Stanley”, licensed under „Free for personal and commercial use” (https://bottts.com/)","url":"https://api.dicebear.com/9.x/bottts/svg?seed=oanor&size=128","seed":"oanor","size":128,"style":"bottts","format":"svg"}},"meta":{"timestamp":"2026-06-01T00:04:39.975Z","request_id":"48f3bc77-a6ee-468d-9e30-0ed84cb15013"},"status":"ok","message":"Avatar generated","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/random":{"get":{"operationId":"get_v1_random","tags":["Avatars"],"summary":"An avatar whose style is derived from the seed","description":"","parameters":[{"name":"seed","in":"query","required":true,"description":"Any seed, e.g. user-42","schema":{"type":"string"},"example":"user-42"},{"name":"format","in":"query","required":false,"description":"svg or png (default svg)","schema":{"type":"string"},"example":"svg"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"avatar":{"svg":"AdventurerLisa Wischofskyhttps://www.figma.com/community/file/1184595184137881796https://creativecommons.org/licenses/by/4.0/Remix of „Adventurer” (https://www.figma.com/community/file/1184595184137881796) by „Lisa Wischofsky”, licensed under „CC BY 4.0” (https://creativecommons.org/licenses/by/4.0/)","url":"https://api.dicebear.com/9.x/adventurer/svg?seed=user-42","seed":"user-42","style":"adventurer","format":"svg"}},"meta":{"timestamp":"2026-06-01T00:04:40.064Z","request_id":"3120a25f-fbed-49e6-a78e-b37b2e07e2ee"},"status":"ok","message":"Random avatar generated","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/styles":{"get":{"operationId":"get_v1_styles","tags":["Reference"],"summary":"Every available avatar style","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Pass style + seed to /v1/avatar. The same seed always renders the same avatar.","count":30,"styles":["adventurer","adventurer-neutral","avataaars","avataaars-neutral","big-ears","big-ears-neutral","big-smile","bottts","bottts-neutral","croodles","croodles-neutral","dylan","fun-emoji","glass","icons","identicon","initials","lorelei","lorelei-neutral","micah","miniavs","notionists","notionists-neutral","open-peeps","personas","pixel-art","pixel-art-neutral","rings","shapes","thumbs"],"formats":["svg","png"]},"meta":{"timestamp":"2026-06-01T00:04:40.137Z","request_id":"49707fc7-2616-4258-86ba-fda8768abd4c"},"status":"ok","message":"Styles retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Source & usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Deterministic avatars. /v1/avatar = an avatar from style + seed (format=svg returns the SVG markup, format=png returns a base64 data URI; options: size 16-512, radius 0-50, background hex, flip); /v1/random = an avatar whose style is derived from the seed; /v1/styles = all 30 styles. The same seed always yields the same avatar — perfect for user/profile placeholders.","source":"DiceBear (api.dicebear.com, v9.x)","endpoints":["/v1/avatar","/v1/random","/v1/styles","/v1/meta"],"styles_count":30},"meta":{"timestamp":"2026-06-01T00:04:40.184Z","request_id":"9255dd3f-5ec6-4ad5-8604-afef3d89cb52"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":10000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":420,"monthly_call_quota":150000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1140,"monthly_call_quota":750000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3290,"monthly_call_quota":3000000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/avatar-api"}