← All endpoints / avatar
GET /avatar
Deterministic generated avatar images.
curl -s "https://freeforagents.dev/avatar?seed=ada.lovelace@math.org&style=identicon"
const res = await fetch("https://freeforagents.dev/avatar?seed=ada.lovelace@math.org&style=identicon");
const data = await res.json();
console.log(data);import requests
r = requests.get(
"https://freeforagents.dev/avatar",
params={
"seed": "ada.lovelace@math.org",
"style": "identicon"
},
)
print(r.json())GET /avatar
Deterministic generated avatar images.
Free, zero-auth JSON API served by FreeForAgents. No API key, no signup. All responses include ok, the payload fields shown below, and a docs URL. CORS is fully open (Access-Control-Allow-Origin: *).
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
seed | string | no | Any string that identifies the avatar (default: random). |
style | string | no | 'identicon' (default) or 'initials'. |
size | integer | no | Image width/height in px, 16-512 (default 120). |
format | string | no | 'json' (default) or 'svg' to get raw image/svg+xml. |
Example request
curl -s "https://freeforagents.dev/avatar?seed=ada.lovelace@math.org&style=identicon"Example response
{
"ok": true,
"docs": "https://freeforagents.dev/docs/avatar.md",
"seed": "ada.lovelace@math.org",
"style": "identicon",
"size": 120,
"palette": [
"hsl(210 55% 92%)",
"hsl(210 62% 38%)"
],
"svg": "<svg xmlns=\"http://www.w3.org/2000/svg\" …></svg>"
}See also
/ip— Look up your IP address and geolocation./uuid— Generate RFC 4122 version 4 UUIDs./ulid— Generate ULIDs (sortable unique identifiers)./hash— Hash text with SHA-1/256/384/512./base64— Encode or decode Base64 strings./convert— Convert between units (length, mass, volume, area, data, speed, time, temperature)./time— Current time in any timezone./timestamp— Current Unix timestamp./random— Cryptographically secure random integers./dice— Roll dice./password— Generate strong random passwords./lorem— Lorem ipsum placeholder text./emoji— Random emoji./joke— Random clean programming joke./fact— Random fun fact./quote— Random inspirational quote./holidays— Public holidays by country and year./fx— Foreign exchange rates (daily, no key)./headers— Echo your request headers./json— Fetch any URL and get parsed JSON back./qr— Generate a QR code for any text or URL./dns— DNS record lookup via Cloudflare DoH.