Avatar API - 免费 Identicon 生成器
根据任何字符串输入创建确定性的、视觉上独特的头像。 传递用户电子邮件、用户名或 ID,API 将返回对称标识符模式。 相同的种子始终生成相同的图像,因此您可以将其用作一致的默认头像,而无需存储文件。
Code examples
curl -X POST https://api.botoi.com/v1/avatar \
-H "Content-Type: application/json" \
-d '{"seed":"john@example.com","size":256,"bg_color":"#f0f0f0"}'When to use this API
默认个人资料图片
通过将电子邮件传递给 API,为每个新用户在注册时分配一个独特的头像。 用户看到的是彩色的标识,而不是一般的灰色轮廓,这使得评论线程和成员列表在视觉上截然不同。
Git 提交作者图标
在自定义 Git 仪表板中提交消息旁边显示标识头像。 对作者电子邮件进行哈希处理以生成一致的图标,与 GitHub 和 GitLab 针对没有个人资料照片的用户使用的模式相匹配。
匿名论坛参与者
从会话 ID 或匿名句柄生成头像,以便讨论线程中的每个参与者都具有可识别的视觉身份,即使没有帐户也是如此。
Frequently asked questions
相同的种子总是会产生相同的化身吗?
是的。 生成算法是确定性的。 今天传递“john@example.com”将在下个月返回完全相同的模式。 您可以依靠它来实现一致的显示,而无需缓存图像。
这和 Gravatar 有什么不同?
Gravatar 要求用户将照片上传到 gravatar.com。 该 API 从任何字符串生成几何图案,无需用户操作。 它可以作为独立的默认头像或 Gravatar 后备。
我可以定制颜色吗?
颜色源自种子串,以确保视觉上的独特性。 API 不接受自定义调色板。 如果您需要品牌特定的颜色,请获取 SVG 并替换填充值。
我可以要求的最大尺寸是多少?
您最多可以请求 512x512 像素。 对于 SVG 输出,无论尺寸参数如何,图像都会缩放到任何显示尺寸。
种子值是否被存储或记录?
不会。种子在内存中进行哈希处理以生成模式并被丢弃。 API 不会存储、记录您的输入或将您的输入传输给第三方。
Get your API key
Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.