Avatar Generator API

POST https://api.findutils.com/api/tools/avatar-generator/execute

Make an avatar as an SVG from a name or an email address, with no external service. Initials mode draws up to two initials on a background colour derived from the input; identicon mode draws a mirrored 5×5 block pattern. Both are seeded from a SHA-256 of the trimmed, lower-cased input, so the same input always gives the same avatar. Returns the SVG, a data: URL, the colours and the initials or the grid.

Needs an API key. Running a tool needs an API key. Keys are not for sale yet: ask for early access. About API keys

Open the tool Try it

Request body

application/json

text

string required

The name or email address the avatar is made from (1-200 characters). Case and surrounding spaces do not change the result.
mode

string optional

initials (default) or identicon. One of initials · identicon. Default "initials".
shape

string optional

circle (default) or square. One of circle · square. Default "circle".
size

integer optional

Width and height of the SVG in pixels (16-1024). Default 256. The drawing scales without loss. Default 256.
font

string optional

Typeface of the initials: inter (default) or jetbrains-mono. Ignored in identicon mode. One of inter · jetbrains-mono. Default "inter".

Example arguments

Verified

{
  "text": "Ada Lovelace",
  "mode": "initials",
  "size": 128
}

curl -X POST https://api.findutils.com/api/tools/avatar-generator/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Ada Lovelace",
    "mode": "initials",
    "size": 128
  }'

const response = await fetch('https://api.findutils.com/api/tools/avatar-generator/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json', Authorization: 'Bearer YOUR_API_KEY' },
  body: JSON.stringify({"text":"Ada Lovelace","mode":"initials","size":128}),
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.findutils.com/api/tools/avatar-generator/execute",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={"text":"Ada Lovelace","mode":"initials","size":128},
)
data = response.json()

$ch = curl_init('https://api.findutils.com/api/tools/avatar-generator/execute');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json', 'Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_POSTFIELDS => '{"text":"Ada Lovelace","mode":"initials","size":128}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Also an MCP tool

Call avatar_generator from Claude, Cursor or any MCP client. Same arguments, same output.

https://mcp.findutils.com

MCP reference

Rate limit: 60 a minute, per IP
Auth: API key
REST id: avatar-generator
MCP name: avatar_generator
Category: Generators
Machine-readable: openapi.json · markdown.md

Request body

Example arguments

More Generators tools

More to explore