Aller au contenu
POST AI agent ready /v1/avatar

API Avatar - Générateur d'Identités Gratuit

Créez des avatars déterministes et visuellement distincts à partir de n'importe quelle chaîne d'entrée. Transmettez un e-mail, un nom d'utilisateur ou un identifiant d'utilisateur, et l'API renvoie un modèle d'identité symétrique. La même graine produit toujours la même image, vous pouvez donc l'utiliser comme avatar par défaut cohérent sans stocker de fichiers.

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

Photos de profil par défaut

Attribuez à chaque nouvel utilisateur un avatar unique lors de l'inscription en transmettant son e-mail à l'API. Les utilisateurs voient une icône colorée au lieu d'une silhouette grise générique, ce qui rend les fils de commentaires et les listes de membres visuellement distincts.

Icônes d'auteur de commit Git

Affichez les avatars d'identité à côté des messages de validation dans un tableau de bord Git personnalisé. Hachez l'e-mail de l'auteur pour générer une icône cohérente, correspondant au modèle utilisé par GitHub et GitLab pour les utilisateurs sans photo de profil.

Participants anonymes au forum

Générez des avatars à partir d'identifiants de session ou de pseudos anonymes afin que chaque participant à un fil de discussion ait une identité visuelle reconnaissable, même sans compte.

Frequently asked questions

La même graine produit-elle toujours le même avatar ?
Oui. L'algorithme de génération est déterministe. Passer "john@example.com" aujourd'hui renvoie exactement le même modèle le mois prochain. Vous pouvez compter sur cela pour un affichage cohérent sans mettre l’image en cache.
En quoi est-ce différent de Gravatar ?
Gravatar demande aux utilisateurs de télécharger une photo sur gravatar.com. Cette API génère un motif géométrique à partir de n'importe quelle chaîne, sans qu'aucune action de l'utilisateur ne soit requise. Il fonctionne comme un avatar par défaut autonome ou comme une solution de secours pour Gravatar.
Puis-je personnaliser les couleurs ?
Les couleurs sont dérivées de la chaîne de graines pour garantir l'unicité visuelle. L'API n'accepte pas de palette personnalisée. Si vous avez besoin de couleurs spécifiques à une marque, récupérez le SVG et remplacez les valeurs de remplissage.
Quelle est la plus grande taille que je peux demander ?
Vous pouvez demander jusqu'à 512x512 pixels. Pour la sortie SVG, l'image s'adapte à n'importe quelle taille d'affichage, quel que soit le paramètre de taille.
La valeur de départ est-elle stockée ou enregistrée ?
Non. La graine est hachée en mémoire pour produire le motif et supprimée. L'API ne stocke, n'enregistre ni ne transmet votre contribution à des tiers.

Get your API key

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