HTTP-API
Our free HTTP-API is the easiest way to use Avatars. Just use the following URL as image source.
Replace :sprites
with male
, female
, human
, identicon
, initials
, bottts
, avataaars
, jdenticon
, gridy
or micah
. The value of :seed
can be anything you like - but don't use any sensitive or personal data here!
note
We provide a large number of avatar styles from different designers. The designs are licensed under different licenses that the designers can choose themselves. Some licenses require attribution. For a quick overview we have created an license overview for you.
#
OptionsMost options can be specified using the query string. Note that you have to encode the values.
The following URL for example sets a blue background:
And this URL sets the mood
option for the avatar style male to happy
and sad
:
#
VersioningThe API also supports versioning!
Always use the latest version:
https://avatars.dicebear.com/api/:sprites/:seed.svg
Use a specific version (4.6 for example):
https://avatars.dicebear.com/4.6/api/:sprites/:seed.svg
Currently supported versions: 4.4
, 4.5
, 4.6
, 4.7
, 4.8
and 4.9
.