Dicebear Avatars

How to Use This API

1. Random Pixel-Art Avatar (SVG)

https://avatars.dicebear.com/7.x/pixel-art/svg

Returns an SVG image. Each request gives a new random avatar. Replace svg with png, jpg, or webp for raster formats.

2. Deterministic Avatar (Same Seed = Same Image)

https://avatars.dicebear.com/7.x/pixel-art/svg?seed=alice

The seed alice always generates the same avatar. Use a username or email hash as the seed for consistent profile pictures.

3. Different Styles

https://avatars.dicebear.com/7.x/bottts/svg?seed=robot
https://avatars.dicebear.com/7.x/avataaars/svg?seed=john
https://avatars.dicebear.com/7.x/identicon/svg?seed=hash
https://avatars.dicebear.com/7.x/initials/svg?seed=JD

4. JavaScript — User Avatar Component

function getAvatarUrl(username, style = 'pixel-art') {
  return `https://avatars.dicebear.com/7.x/${style}/svg?seed=${encodeURIComponent(username)}`;
}

// Display avatar for each user
const users = ['alice', 'bob', 'charlie'];
users.forEach(user => {
  const img = document.createElement('img');
  img.src = getAvatarUrl(user, 'avataaars');
  img.alt = `${user}'s avatar`;
  document.body.appendChild(img);
});

5. Python — Generate Default Avatars for Users

import requests

def avatar_url(username, style='bottts'):
    return (f'https://avatars.dicebear.com/7.x/{style}/svg'
            f'?seed={username}')

def download_avatar(username, style='pixel-art'):
    url = avatar_url(username, style)
    resp = requests.get(url)
    with open(f'{username}_avatar.svg', 'w') as f:
        f.write(resp.text)
    print(f"Saved {username}'s avatar")

usernames = ['alice', 'bob', 'charlie', 'diana']
for u in usernames:
    download_avatar(u)

# Or use initials style for clean geometric avatars
print(avatar_url('JS', 'initials'))