HTTP API – Generate SVG Avatars via URL
Our HTTP API is the simplest way to use DiceBear as a profile picture API or avatar placeholder API — no authentication required.
Usage
Use the following address and replace <styleName> with your preferred avatar style (camelCase). Every official avatar style is supported.
https://api.dicebear.com/9.x/<styleName>/svgA few examples
INFO
We provide a large number of avatar styles from different artists. The avatar styles are licensed under different licenses that the artists can choose themselves. For a quick overview we have created an license overview for you.
Options
All core options — such as seed, flip, rotate, scale, radius, backgroundColor, and more — are available as query parameters. Style-specific options are listed on each avatar style page. For example:
TIP
If you want to pass more options, you connect them with a & as usual with query strings.
Array options
Array values are separated by a comma. For example, the URL could look like this if you want to provide the PRNG with several hair styles in addition to the seed. Note that the avatar styles provide different options. In this example, we use the Pixel Art avatar style.
Boolean options
Boolean values can be set as strings (true and false).
File format
SVGRecommended
Recommended. Scales indefinitely, no size limit, higher rate limit.
PNG
Max. 256 × 256 px. Lower rate limit.
JPG
Max. 256 × 256 px. Lower rate limit.
WebP
Max. 256 × 256 px. Lower rate limit.
AVIF
Max. 256 × 256 px. Lower rate limit.
JSON
Returns avatar metadata as JSON — no image output.
PNG, JPG, WebP and AVIF use the Noto Sans font and currently supports the following subsets: cyrillic, cyrillic-ext, devanagari, greek, greek-ext, japanese, korean, latin, latin-ext, simplified-chinese, thai and vietnamese.
Versioning
You can set the version in the URL. Just replace the 9.x from the previous examples with the one you want.
Supported versions: 5.x, 6.x, 7.x, 8.x, 9.x
WARNING
We reserve the right to discontinue any version at any time without notice. You can create your own instance of the API to be able to access discontinued versions even afterwards.
Self-Hosted Avatar API
Need a private or commercial setup? You can host the Avatar API yourself for full control over availability, rate limits, and data privacy.
Fair Use & Rate Limits
Our API is free to use for non-commercial purposes, but please use it responsibly. We reserve the right to block abusive users.
We currently limit requests per second to 50 for SVG and 10 for PNG, JPG, WebP, and AVIF. Exceeding the limit returns HTTP 429 Too Many Requests. We reserve the right to change these limits at any time without notice.
For commercial use or higher limits, please set up your own instance. We're happy to answer questions — open a discussion on GitHub.
Changes and Availability
Please be aware that we reserve the right to update the API at any time. While we will do our best to maintain backwards compatibility, we cannot guarantee this. Even though we try to always return the same avatar, the design and especially the source code may change. Additionally, we cannot guarantee that the API will always be available. If you need consistent access to the API, we recommend setting up your own instance.