Ajutor

Folosește hashavatar.app direct din browser, frontend sau backend. Fiecare avatar URL este determinist, deci același identificator și aceleași opțiuni produc mereu același rezultat.

URL De Bază

Folosește query endpoint când vrei un image URL public simplu.

https://hashavatar.app/v1/[email protected]&algorithm=sha512&kind=robot&background=white&accessory=glasses&color=gold&expression=happy&shape=circle&format=webp&size=256

Path Style URL

Folosește forma path dacă preferi embed URLs mai curate.

https://hashavatar.app/avatar/fox/[email protected]/webp

Exemplu HTML

<img
  src="https://hashavatar.app/v1/[email protected]&algorithm=sha512&kind=monster&background=themed&accessory=horns&color=crimson&expression=grumpy&shape=hexagon&format=webp&size=256"
  alt="Generated monster avatar"
/>

Exemplu JavaScript

const avatarUrl = new URL("https://hashavatar.app/v1/avatar");
avatarUrl.search = new URLSearchParams({
  id: user.email,
  algorithm: "sha512",
  kind: "robot",
  background: "white",
  accessory: "glasses",
  color: "gold",
  expression: "happy",
  shape: "circle",
  format: "webp",
  size: "256",
}).toString();

Parametri Suportați

id: any stable identifier such as an email, username, internal user id, or one-way hash
tenant: optional namespace partition for multi-tenant apps
style_version: optional style namespace such as v2
algorithm: identity hash mode; only sha512 is supported
kind: any public hashavatar family, including cat, dog, robot, planet, rocket, frog, panda, cupcake, pizza, octopus, knight, bear, penguin, dragon, ninja, astronaut, diamond, coffee-cup, and shield
background: themed, white, black, dark, light, transparent, polka-dot, striped, checkerboard, grid, sunrise, ocean, or starry
accessory: none, glasses, hat, headphones, crown, bowtie, eyepatch, scarf, halo, or horns
color: default, neon-mint, pastel-pink, crimson, gold, or deep-sea-blue
expression: default, happy, grumpy, surprised, sleepy, winking, cool, or crying
shape: square, circle, squircle, hexagon, or octagon
format: output format; only webp is supported
size: from 64 up to 1024

Accessory și expression layers se aplică familiilor character-style. Familiile object-style precum planet, rocket, paws, mushroom, cactus, cupcake, pizza, icecream, diamond, coffee-cup și shield sunt normalizate la accessory=none și expression=default.

Linkuri De Stocare Semnate

Dacă acest deployment are object storage configurat, cere un presigned storage link de la /v1/avatar/link. Acel endpoint stochează generated object și returnează JSON cu signed URL, object key și hashed cache key. Răspunsurile standard de avatar nu expun signed-link metadata în response headers.

GET https://hashavatar.app/v1/avatar/[email protected]&algorithm=sha512&kind=robot&background=white&accessory=glasses&color=gold&expression=happy&shape=circle&format=webp&size=256

Open Source

Sursa site-ului public se află în API repository, iar reusable avatar renderer este publicat pe crates.io. Repository · crates.io