Ir al contenido
POST AI agent ready /v1/avatar

API de Avatar - Generador de Identicon gratuito

Cree avatares deterministas y visualmente distintos a partir de cualquier entrada de cadena. Pase un correo electrónico, nombre de usuario o ID de usuario y la API devolverá un patrón de identificación simétrico. La misma semilla siempre produce la misma imagen, por lo que puedes usarla como un avatar predeterminado consistente sin almacenar archivos.

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

Imágenes de perfil predeterminadas

Asigne a cada nuevo usuario un avatar único al registrarse pasando su correo electrónico a la API. Los usuarios ven un identicon colorido en lugar de una silueta gris genérica, lo que hace que los hilos de comentarios y las listas de miembros sean visualmente distintos.

Iconos de autor de confirmación de Git

Muestre avatares de identicon junto a los mensajes de confirmación en un panel de Git personalizado. Hash el correo electrónico del autor para generar un ícono consistente, que coincida con el patrón que usan GitHub y GitLab para usuarios sin fotos de perfil.

Participantes del foro anónimas

Genere avatares a partir de ID de sesión o identificadores anónimos para que cada participante en un hilo de discusión tenga una identidad visual reconocible, incluso sin una cuenta.

Frequently asked questions

¿La misma semilla produce siempre el mismo avatar?
Sí. El algoritmo de generación es determinista. Pasar "john@example.com" hoy arroja exactamente el mismo patrón el próximo mes. Puede confiar en esto para una visualización consistente sin almacenar en caché la imagen.
¿En qué se diferencia esto de Gravatar?
Gravatar requiere que los usuarios carguen una foto en gravatar.com. Esta API genera un patrón geométrico a partir de cualquier cadena, sin necesidad de acción por parte del usuario. Funciona como un avatar predeterminado independiente o como respaldo de Gravatar.
¿Puedo personalizar los colores?
Los colores se derivan de la cadena de semillas para garantizar la singularidad visual. La API no acepta una paleta personalizada. Si necesita colores específicos de una marca, busque el SVG y reemplace los valores de relleno.
¿Cuál es la talla más grande que puedo solicitar?
Puede solicitar hasta 512x512 píxeles. Para la salida SVG, la imagen se escala a cualquier tamaño de visualización independientemente del parámetro de tamaño.
¿Se almacena o registra el valor inicial?
No. La semilla se procesa en la memoria para producir el patrón y se descarta. La API no almacena, registra ni transmite sus datos a terceros.

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