GET
头像
/api/avatar/{user}/{size}正脸加帽子层,按像素放大,适合做头像。
https://mcers.net/api/avatar/Da_Cheng_zi/64用 Java 用户名或 UUID 获取头像、身体预览、皮肤和披风图片。可直接放进网页、论坛签名或自己的应用,无需密钥。
/api/avatar/{user}/{size}正脸加帽子层,按像素放大,适合做头像。
https://mcers.net/api/avatar/Da_Cheng_zi/64/api/bust/{user}/{size}头、身体和手臂,比全身更短的预览。
https://mcers.net/api/bust/Da_Cheng_zi/160/api/body/{user}/{size}皮肤正面全身预览,含手臂和腿。
https://mcers.net/api/body/Da_Cheng_zi/256/api/cape/{user}/{size}披风正面。没有披风时返回 404。
https://mcers.net/api/cape/Da_Cheng_zi/128/api/skin/{user}原始皮肤 PNG。没有自定义皮肤时返回默认 Steve 或 Alex。
https://mcers.net/api/skin/Da_Cheng_zi/api/player/{user}官方 UUID、模型、纹理哈希和披风信息。
https://mcers.net/api/player/Da_Cheng_zi/api/texture/{hash}按哈希缓存的皮肤或披风原图,来源 textures.minecraft.net。
<img src="https://mcers.net/api/avatar/Da_Cheng_zi/64" alt="Da_Cheng_zi" width="64" height="64" />{user} · 必填Java 用户名或 UUID,也可以在末尾加 .png。
{size} · 可选输出像素尺寸。头像 8–512,默认 64。身体/半身/披风 16–512。
overlay · 可选是否绘制第二层。默认 true。
图片和 JSON 接口都带 CORS 头,可在其他网站调用。请在你这边缓存结果。
图片接口在找不到玩家时会返回默认 Steve 皮肤,避免嵌入裂图。没有披风时返回 404。默认绘制帽子/外套层,加 overlay=false 可关闭。