Usage

All requests returns a image stream to be used directly in a <img/> tag.

Generate a avatar with default settings, for user "John Doe".

https://uix.mnjz.sa/api/?name=John+Doe

Generate a blue avatar

https://uix.mnjz.sa/api/?background=0D8ABC&color=fff

Generate a random background avatar.

Avoid passing color as it will be automatically set between black and white.

https://uix.mnjz.sa/api/?background=random

Settings

Image Size (size)

Avatar image size in pixels. Between: 16 and 512. Default: 64

https://uix.mnjz.sa/api/?size=128

Font Size (font-size)

Font size in percentage of size. Between 0.1 and 1. Default: 0.5

https://uix.mnjz.sa/api/?font-size=0.33

Initial Characters (length)

Length of the generated initials. Default: 2

https://uix.mnjz.sa/api/?length=1

Name (name)

The name used to generate initials. You can specify the initials yourself as well. Default: John Doe

https://uix.mnjz.sa/api/?name=Elon+Musk

Rounded Image (rounded)

Boolean specifying if the returned image should be a circle. Default: false

https://uix.mnjz.sa/api/?rounded=true

Bold (bold)

Boolean specifying if the returned letters should use a bold font. Default: false

https://uix.mnjz.sa/api/?bold=true

Background Color (background)

Hex color for the image background, without the hash (#). Default: ddd

https://uix.mnjz.sa/api/?background=a0a0a0

Font Color (color)

Hex color for the font, without the hash (#). Default: 222

https://uix.mnjz.sa/api/?color=ff0000

Uppercase (uppercase)

Decide if the API should uppercase the name/initials. Default: true

https://uix.mnjz.sa/api/?uppercase=false&name=different+Case

Format (format)

Decide if the API should return SVG or PNG. Default: svg if the Accept header includes image/svg+xml, png otherwise

https://uix.mnjz.sa/api/?format=svg

All settings above can be mixed together as you desire.

Because of limitations in Gravatar, we must pass in the parameters as sub-directories, instead of query-parameters. You should also consider urlencoding the name, in case it contains special characters. It's a limitation by Gravatar, not UI Mnjz Avatar.

The order is as follows:

• name
• size
• background
• color
• length
• font-size
• rounded
• uppercase
• bold
• format

Retina

I recommend using 1.5x or 2x sizes for your avatars, but keeping the img tag the original size, to ensure crisp avatars on high DPI screens.

Language/Script support

I have added support for some unicode scripts/languages that are not supported by the typical fonts. Current support:

• Arabic
• Armenian
• Bengali
• Georgian
• Hebrew
• Chinese
• Japanese
• Mongolian
• Thai
• Tibetan

Regions

Servers are setup in the following countries/cities:

• Saudi Arabia, Jeddah
• San Francisco, CA, USA
• Bangalore, India NEW!

Privacy and Monitoring

No data is being stored on our serveres. Monitoring & logging is entirely disabled.

---