gta-vi26 images
Use /api/gta-vi to pick from this set — as a circle, a square or the full image.
Drop a URL into an <img> tag and get a ready-to-use avatar at any size — as a circle, a square or the full image. Pick one by name, or pass a username and get the same face back every time.
GET /api/gta-vi/baelux/160Avatars are grouped into collections. Put a collection name in the URL to keep random or username-based picks inside that set.
Use /api/gta-vi to pick from this set — as a circle, a square or the full image.
Name an id to get that exact image. Pass a seed to give each user their own image that never changes. Leave both out for a random one.
X-Photo-Match: idPass a collection and an id.
/api/gta-vi/baelux/96X-Photo-Match: seedPass any string as seed= (email, username, uuid).
/api/gta-vi?seed=ada@example.com&size=96X-Photo-Match: randomPass no id and no seed, or add /random.
/api/gta-vi/random/96Priority: id → seed → random. Every response says which one was used in the X-Photo-Match header.
Every part of the URL is optional and can go in any order, so /api/gta-vi/raul and /api/gta-vi/240/raul both work. Exact and seeded URLs always return the same image, so browsers cache them and pages stay fast; random ones never cache.
<img src="/api/gta-vi/baelux/120" alt="" width="120" height="120" /><img src="/api/gta-vi?seed=ada@example.com&size=120" alt="" width="120" height="120" />curl "https://your-host/api/gta-vi/baelux/512?square=true" -o avatar.webpThe veyce package builds these URLs for you, with types. It has zero dependencies, is about 2 KB gzipped, and runs in the browser, Node 18+, Bun, Deno and edge runtimes. It also includes a React <Avatar> component and a CLI.
npm install veyceimport { createAvatars } from "veyce";
const avatars = createAvatars({
defaults: { collection: "gta-vi", size: 96 },
});
avatars.url({ seed: "ada@example.com" });import { Avatar } from "veyce/react";
<Avatar seed="ada@example.com" size={48} />Every image has a short, readable id. Ask for it by collection and id and you get exactly that image, every time.
A circle by default, square=true for square corners, or fit=full for the whole image at its original aspect ratio.
No API key, no sign-up, and it works from any site. Point an <img> at a URL and you're done.
Pass a username or email as seed= and the same person always gets the same avatar — nothing to store on your side.