{format}: Generate an avatar

API: dicebear.com:dicebear-avatars
Endpoint: /{style}/{format}
Response format: image/*
Auth: none
Method: GET
Last Status: 400
Latency: 120ms

Description

Generate an avatar image in the specified style and format. Returns binary image data (SVG, PNG, JPG, WebP, AVIF) or JSON metadata depending on format.

Parameters (21)

accessories (array, query, optional)

Accessories (style-specific option)

backgroundColor (string, query, optional)

Background color (hex code or 'transparent')

baseColor (array, query, optional)

Base color for bottts style (hex codes)

clothing (array, query, optional)

Clothing style (style-specific option)

clothingColor (array, query, optional)

Clothing color (style-specific)

ears (array, query, optional)

Ear style (style-specific option)

eyebrows (array, query, optional)

Eyebrow style (style-specific option)

eyes (array, query, optional)

Eye style (style-specific option)

flip (boolean, query, optional)

Flip the avatar horizontally

format (string, path, required)

The output format for the avatar

Constraints: {'enum': ['svg', 'png', 'jpg', 'jpeg', 'webp', 'avif', 'json']}

glasses (array, query, optional)

Glasses style (style-specific option)

hair (array, query, optional)

Hair style (style-specific option for adventurer, lorelei, avataaars, etc.)

hairColor (array, query, optional)

Hair color (style-specific, hex codes or color names)

mouth (array, query, optional)

Mouth style (style-specific option)

radius (integer, query, optional)

Border radius in pixels (0-50, default: 0)

Constraints: {'minimum': 0, 'maximum': 50}

rotate (integer, query, optional)

Rotate the avatar by specified degrees

Constraints: {'minimum': 0, 'maximum': 360}

scale (integer, query, optional)

Scale the avatar (0-200, default: 100)

Constraints: {'minimum': 0, 'maximum': 200}

seed (string, query, optional)

Generate deterministic avatars. Same seed will always generate the same avatar.

size (integer, query, optional)

Image size in pixels for raster formats (PNG/JPG/WebP/AVIF). Max 256px.

Constraints: {'minimum': 1, 'maximum': 256}

skinColor (array, query, optional)

Skin color (style-specific, hex codes)

style (string, path, required)

The avatar style to use

Constraints: {'enum': ['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']}

Examples (1)

Generate an avatar openapi-spec
curl 'https://api.dicebear.com/9.x/pixel-art/svg?seed=Felix&flip=True&rotate=90&scale=100&radius=10&size=128&backgroundColor=ff0000&hair=%5B%27long%27%2C+%27short%27%5D&hairColor=%5B%272c1b18%27%2C+%27a55728%27%5D&skinColor=%5B%27f8d25c%27%2C+%27f6d3b0%27%5D&eyes=%5B%27happy%27%2C+%27surprised%27%5D&mouth=%5B%27smile%27%2C+%27serious%27%5D&glasses=%5B%27round%27%2C+%27square%27%5D'
import requests

resp = requests.get(
    "https://api.dicebear.com/9.x/pixel-art/svg",
    params={
        'seed': 'Felix',
        'flip': 'True',
        'rotate': '90',
        'scale': '100',
        'radius': '10',
        'size': '128',
        'backgroundColor': 'ff0000',
        'hair': "['long', 'short']",
        'hairColor': "['2c1b18', 'a55728']",
        'skinColor': "['f8d25c', 'f6d3b0']",
        'eyes': "['happy', 'surprised']",
        'mouth': "['smile', 'serious']",
        'glasses': "['round', 'square']",
    },
)
data = resp.json()
import zingu_apis

api = zingu_apis.api("dicebear")
result = api.fetch("{style}/{format}", seed="Felix", flip="True", rotate=90, scale=100, radius=10, size=128, backgroundColor="ff0000", hair="['long', 'short']", hairColor="['2c1b18', 'a55728']", skinColor="['f8d25c', 'f6d3b0']", eyes="['happy', 'surprised']", mouth="['smile', 'serious']", glasses="['round', 'square']")

for item in result:
    print(item)
const resp = await fetch("https://api.dicebear.com/9.x/pixel-art/svg?seed=Felix&flip=True&rotate=90&scale=100&radius=10&size=128&backgroundColor=ff0000&hair=%5B%27long%27%2C+%27short%27%5D&hairColor=%5B%272c1b18%27%2C+%27a55728%27%5D&skinColor=%5B%27f8d25c%27%2C+%27f6d3b0%27%5D&eyes=%5B%27happy%27%2C+%27surprised%27%5D&mouth=%5B%27smile%27%2C+%27serious%27%5D&glasses=%5B%27round%27%2C+%27square%27%5D");
const data = await resp.json();

Probe History

Latency

Status Codes

TimeStatusLatencySize
2026-04-16 02:46:18.060497 400 120ms
2026-04-15 02:14:05.034910 400 145ms
2026-04-14 02:03:50.400496 400 132ms
2026-04-12 14:11:56.101349 400 146ms
2026-04-10 02:47:54.855135 400 162ms
2026-04-09 00:11:02.573971 400 132ms
2026-04-08 06:53:09.572230 400 134ms
2026-04-07 01:17:15.966023 400 138ms
2026-04-06 06:47:01.899094 400 196ms
2026-04-05 14:08:39.737463 400 254ms
2026-04-05 00:58:28.552184 400 184ms