| name |
string |
"User" |
Full name string used to derive initials. Full Unicode supported. |
| first_name, last_name |
string |
null |
Alternative to name. Used if name is omitted. |
| size |
int |
128 |
Avatar image size in pixels (clamped between 16 and 1024). |
| length |
int |
2 |
Number of initials to extract (1, 2, or 3). |
| background |
string |
random / hex |
Hex color without hash (e.g. 4f46e5) or random. |
| gradient |
string |
null |
Two hex colors separated by comma for a linear gradient (e.g. 4f46e5,9333ea). |
| gradient_angle |
float |
135 |
Gradient angle in degrees (0 to 360). |
| rounded |
string/bool/int |
"circle" |
circle / true for circle, square / false for square, or numeric corner radius in px. |
| border, border_width |
string, int |
null, 0 |
Border color hex and border width in pixels. |
| format |
string |
"svg" |
Requested image format: svg, png, or webp. |
| theme |
string |
"auto" |
auto luminance contrast, light, or dark. |