Aller au contenu
Accueil moxon

Génération d'avatars

L'endpoint /avatar génère des images d'avatars déterministes à partir d'une chaîne seed. Le même seed produit toujours la même image, ce qui permet des représentations d'utilisateurs cohérentes.

gethttps://api.moxon.dev/v5/avatar
Essayerget/v5/avatar

Paramètres

  • seedstringoptionnel

    Par défaut : UUID aléatoire.

    Chaîne seed pour la génération déterministe — même seed, même image

  • type"identicon" | "pixel"optionnel

    Par défaut : identicon.

    Type d'avatar : identicon (grille symétrique 5×5) ou pixel (grille 8×8)

  • format"png" | "svg"optionnel

    Par défaut : png.

    Format de sortie : png ou svg

  • sizenumberoptionnel

    Par défaut : 200.

    Taille de l'image en pixels (50–2000)

  • bgstringoptionnel

    Par défaut : #f0f0f0.

    Couleur de fond en hexadécimal (ex. f0f0f0)

Réponse

Par défaut (format=png), l'endpoint retourne une image PNG directe (Content-Type: image/png), utilisable dans une balise <img> :

<img src="https://api.moxon.dev/v5/avatar?seed=alice" alt="Avatar" />

Avec format=svg, la réponse est un SVG inline (Content-Type: image/svg+xml) :

<img src="https://api.moxon.dev/v5/avatar?seed=alice&format=svg" alt="Avatar" />

Exemples de code

Gestion des erreurs

  • 400Size must be between 50 and 2000Le paramètre size est hors de la plage autorisée
  • 400Please provide a valid size (&size={50-2000})Le paramètre size n'est pas un nombre valide
  • 400Type must be one of: identicon, pixelLa valeur de type n'est pas valide
  • 400Format must be one of: png, svgLa valeur de format n'est pas valide
  • 400Invalid color (use hex like ff6600)La couleur bg n'est pas une valeur hexadécimale valide