POST AI agent ready /v1/avatar

API Avatar - Gerador de Identicon Gratuito

Crie avatares determinísticos e visualmente distintos a partir de qualquer entrada de string. Passe um e-mail, nome de usuário ou ID do usuário e a API retornará um padrão de identidade simétrico. A mesma semente sempre produz a mesma imagem, então você pode usá-la como um avatar padrão consistente sem armazenar arquivos.

Endpoint

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

Fotos de perfil padrão

Atribua a cada novo usuário um avatar exclusivo no momento da inscrição, passando seu e-mail para a API. Os usuários veem um ícone de identificação colorido em vez de uma silhueta cinza genérica, o que torna os tópicos de comentários e as listas de membros visualmente distintos.

Ícones do autor do commit do Git

Exiba avatares idênticos ao lado das mensagens de commit em um painel Git personalizado. Faça hash do e-mail do autor para gerar um ícone consistente, correspondendo ao padrão que o GitHub e o GitLab usam para usuários sem fotos de perfil.

Participantes anônimos do fórum

Gere avatares a partir de IDs de sessão ou identificadores anônimos para que cada participante de um tópico de discussão tenha uma identidade visual reconhecível, mesmo sem uma conta.

Frequently asked questions

A mesma semente produz sempre o mesmo avatar?

Sim. O algoritmo de geração é determinístico. Passar "john@example.com" hoje retorna exatamente o mesmo padrão no próximo mês. Você pode confiar nisso para uma exibição consistente sem armazenar a imagem em cache.

Como isso é diferente do Gravatar?

O Gravatar exige que os usuários carreguem uma foto no gravatar.com. Esta API gera um padrão geométrico a partir de qualquer string, sem necessidade de ação do usuário. Ele funciona como um avatar padrão independente ou um substituto do Gravatar.

Posso personalizar as cores?

As cores são derivadas da sequência de sementes para garantir exclusividade visual. A API não aceita uma paleta personalizada. Se precisar de cores específicas da marca, busque o SVG e substitua os valores de preenchimento.

Qual é o maior tamanho que posso solicitar?

Você pode solicitar até 512x512 pixels. Para saída SVG, a imagem é dimensionada para qualquer tamanho de exibição, independentemente do parâmetro de tamanho.

O valor inicial é armazenado ou registrado?

Não. A semente é criptografada na memória para produzir o padrão e descartada. A API não armazena, registra ou transmite suas informações a terceiros.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.