HTTP-API

Our free HTTP-API is the easiest way to use Avatars. Just use the following URL as image source.

https://avatars.dicebear.com/api/:sprites/:seed.svg

Replace :sprites with male, female, human, identicon, initials, bottts, avataaars, jdenticon, gridy. The value of :seed can be anything you like - but don't use any sensitive or personal data here!

Options#

Most options can be specified using the query string. Note that you have to encode the values. Boolean values must be specified with 0 for false and 1 for true.

The following URL for example sets a blue background:

https://avatars.dicebear.com/api/male/john.svg?background=%230000ff

And this URL sets the mood option for the avatar style male to happy and sad:

https://avatars.dicebear.com/api/male/john.svg?mood[]=happy&mood[]=sad

Versioning#

The API also supports versioning!

Always use the latest version:
https://avatars.dicebear.com/api/:sprites/:seed.svg

Use a specific version (4.5 for example):
https://avatars.dicebear.com/4.5/api/:sprites/:seed.svg

The last 10 minor versions are supported - starting with version 4.4.