← Utilitaires pour développeurs

Générer un avatar

GET /avatars/generate

Générez des URL d'images d'avatar uniques à partir d'une chaîne de graine (telle qu'un nom d'utilisateur ou un email). Renvoie des URL provenant de trois services différents : DiceBear (17 styles graphiques, SVG/PNG), UI Avatars (basé sur les initiales) et RoboHash (robots/monstres). Une même graine produit toujours le même avatar, ce qui en fait une solution parfaite pour les avatars par défaut des profils utilisateur.

Paramètres

seed requis

Seed string (username, email, any text)

style optionnel par défaut: avataaars

DiceBear style name

size optionnel par défaut: 200

Image size in pixels

Exemples de requêtes

Utilisation de base
curl "https://nordapi.ee/api/v1/avatars/generate?seed=john_doe"
Avatar for a username
curl "https://nordapi.ee/api/v1/avatars/generate?seed=john_doe"
Pixel art style, large
curl "https://nordapi.ee/api/v1/avatars/generate?seed=jane&style=pixel-art&size=400"
Robot avatar from email
curl "https://nordapi.ee/api/v1/avatars/generate?seed=user@example.com&style=bottts"

Réponse en direct

{
  "data": {
    "dicebear": "https://api.dicebear.com/9.x/avataaars/svg?seed=john_doe&size=200",
    "dicebear_png": "https://api.dicebear.com/9.x/avataaars/png?seed=john_doe&size=200",
    "robohash": "https://robohash.org/john_doe?size=200x200",
    "robohash_monster": "https://robohash.org/john_doe?set=set2&size=200x200",
    "robohash_robot_head": "https://robohash.org/john_doe?set=set3&size=200x200",
    "seed": "john_doe",
    "size": 200,
    "style": "avataaars",
    "ui_avatar": "https://ui-avatars.com/api/?name=john_doe&size=200&background=random&color=fff"
  },
  "success": true
}