跳转到内容
POST AI agent ready /v1/avatar

Avatar API - 免费 Identicon 生成器

根据任何字符串输入创建确定性的、视觉上独特的头像。 传递用户电子邮件、用户名或 ID，API 将返回对称标识符模式。 相同的种子始终生成相同的图像，因此您可以将其用作一致的默认头像，而无需存储文件。

Parameters

stringrequired

Input string used to generate the avatar pattern. Typically an email address or username.

number

Width and height of the output image in pixels.

string

Background color as a CSS color value. Defaults to #f0f0f0 if omitted.

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.

Sign up free View full docs