并发探测 Gravatar、Cravatar、WeAvatar 与腾讯 QQ 头像,自动返回第一个真实存在的头像;都没有时返回美观占位图。默认最大尺寸,全球缓存加速。
把 {ID} 替换成 邮箱 MD5 或 QQ 号即可,服务自动识别。
<img src="https://gravatar.bluecdn.com/avatar/{ID}" alt="头像">
在线计算邮箱小写后的 MD5,并发查 Gravatar / Cravatar / WeAvatar。
32–64 位 hex 字符串,跳过 MD5 计算直接查询。
5–12 位纯数字,自动从 q.qlogo.cn 拉取(最大 spec=640)。
用 ?s= 指定边长,1–2048 整数。不传时默认 2048(最大)。
https://gravatar.bluecdn.com/avatar/{HASH}?s=128
QQ 头像源仅支持 4 个固定 spec。本服务自动选择「不小于请求尺寸」的最近值:
请求 s | 实际取 | 说明 |
|---|---|---|
| 1 – 40 | 40 | 列表头像 |
| 41 – 100 | 100 | 聊天窗口 |
| 101 – 140 | 140 | 普通展示 |
| 141 – 640 | 640 | 高清 |
| 不传 / > 640 | 640 | 默认最大 |
X-Avatar-Source |
命中的源:gravatar / cravatar / weavatar / qq,-default 后缀代表占位图 |
X-Cache-Status |
HIT / MISS / EXPIRED / UPDATING |
Cache-Control |
真头像 max-age=1296000, immutable(15 天);占位图 max-age=3600(1 小时) |
Access-Control-Allow-Origin |
始终 *(无 CORS 限制) |
| 场景 | 边缘缓存 | 浏览器缓存 |
|---|---|---|
| 命中真实头像 | 15 天 | 15 天 + immutable |
| 所有源都没有 → 占位图 | 1 小时 | 1 小时 |
带上 ?refresh=1 参数可以跳过 nginx 缓存,立即重新探测所有源。常用于用户刚注册头像后立刻看到效果。
https://gravatar.bluecdn.com/avatar/{ID}?refresh=1
?refresh=1 强制重新探测即可。
只需把原来 URL 里的 gravatar.com 替换成 gravatar.bluecdn.com,API 格式完全兼容:
<img src="https://gravatar.bluecdn.com/avatar/{邮箱MD5}">WordPress 用户可在 functions.php 中用 get_avatar_url 过滤器替换域名,无需改动数据库。
gravatar.com 在中国大陆网络环境下访问不稳定,常出现图片加载超时或 404。本服务同时探测 Cravatar(国内镜像)、WeAvatar、Gravatar 官方 三个源,自动选取首个可用的真实头像返回,从根本上解决国内访问失败问题。
支持。将 QQ 号(5 – 12 位纯数字)直接作为 ID 传入,服务自动从腾讯官方接口拉取:
https://gravatar.bluecdn.com/avatar/10000
最大支持 640px,适合国内以 QQ 账号注册的用户社区。
边缘缓存有效期为 15 天。若需立即看到新头像,在 URL 末尾加上 ?refresh=1 参数可绕过缓存强制重新探测:
https://gravatar.bluecdn.com/avatar/{ID}?refresh=1完全免费,无需注册,无 API Key。所有响应包含 Access-Control-Allow-Origin: *,前端可直接跨域调用,无任何 CORS 限制。