Перейти к содержимому
POST AI agent ready /v1/avatar

Avatar API — бесплатный генератор идентификаторов

Создавайте детерминированные, визуально различимые аватары из любой введенной строки. Передайте адрес электронной почты, имя пользователя или идентификатор пользователя, и 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 используют для пользователей без фотографий профиля.

Анонимные участники форума

Создавайте аватары на основе идентификаторов сеансов или анонимных дескрипторов, чтобы каждый участник ветки обсуждения имел узнаваемую визуальную идентичность, даже без учетной записи.

Frequently asked questions

Всегда ли одно и то же семя дает один и тот же аватар?
Да. Алгоритм генерации является детерминированным. Если передать адрес «john@example.com» сегодня, в следующем месяце будет получена та же самая картина. Вы можете рассчитывать на это для согласованного отображения без кэширования изображения.
Чем это отличается от Граватара?
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