Heads API

A blazing fast, Minecraft avatar rendering service.

z6me
Notch
jeb_
Dinnerbone
MHF_Steve
MHF_Alex

Input Formats

The API accepts player identifiers in three formats. Dashed UUIDs are automatically redirected to their plain, undashed formats.

1. Minecraft Username z6me OK
2. Dashed UUID 15433cdc-ac2e-410e-ab65-b20d5e02e900 REDIRECT
3. Plain UUID (Recommended) 15433cdcac2e410eab65b20d5e02e900 BEST

Endpoint Pattern

Retrieve a player's head by providing their username and requested size in the URL path. Standard sizes are between 8 and 512 pixels.

https://api.zeme.ovh/heads/{username}/{size}.png

Example

https://api.zeme.ovh/heads/z6me/128.png
z6me avatar preview
z6me (128px)