Generate a deterministic initials avatar SVG with an accessible text color
GET /v1/avatar-initials-svg on media.caelaralabs.com
Request parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name | query | string | yes | Person or company name |
size | query | integer | no | Size in px (24-1024, default 128) |
shape | query | string | no | circle (default), rounded or square |
bg | query | string | no | Background color (default derived from the name) (hex, with or without #) |
fg | query | string | no | Text color (default chosen for contrast) (hex, with or without #) |
format | query | string | no | json (default, includes svg + data URI) or svg (raw image/svg+xml) |
Call it with an API key
Send your key as X-Caelara-Key. Responses are JSON; when an upstream source is unavailable the API still answers HTTP 200 with "partial": true instead of a server error.
Use it as an MCP tool
Tool name avatar_initials_svg on the remote server https://media.caelaralabs.com/mcp (registry ID com.caelaralabs/media). MCP tool calls need an X-Caelara-Key API key; to pay per call in USDC, use the direct HTTP route in the x402 section below.
Pay per call in USDC on Base
No account needed. An unauthenticated request returns HTTP 402 with an X-Payment-Required: x402 header and a JSON body whose accepts entry carries scheme exact, network base, maxAmountRequired 5000 (0.005 USDC, 6 decimals), the USDC asset and the payTo address. Settlement happens only after a successful response.