Agent Careerats-sdk

Avatar

High performance edge endpoints with immutable caching. Deterministic and animated SVG bot avatars.

Endpoints

Method & PathTypeDescription
GET /api/avatar.svgimage/svg+xmlPrimary endpoint with query parameter customization
GET /avatar/:seed.svgimage/svg+xmlClean URL routing by username or ID
GET /api/avatar.jsonapplication/jsonReturns metadata, resolved attributes, and raw SVG string

Supported Query Parameters

ParameterTypeDefaultDescription
seedstringagentcareerAny string (username, email, UUID). Deterministically sets shape, color, and mood when not explicitly specified.
animatedbooleantruetrue or false. Injects smooth CSS keyframe blinking and gaze drift animations.
shapestringrandomBody silhouette: circle, squircle, cloud, pebble, drop, capsule, hexagon, triangle.
colorstringrandomPreset (noir, bleu, menthe, corail, violet, moutarde, rose, cendre) or custom hex (ff0055).
expressionstringrandomEye mood: neutral, happy, curious, attentive, surprised, excited, bored, wary, laughing.
sizenumber256Sets SVG viewBox width and height in pixels.
radiusnumber0Adds circular rounded background corner radius (radius=50 for pill/circle).
paperstring#f9f9f9Eye backing paper color. Set to transparent to remove white paper cutout backing.
backgroundstringtransparentBackground fill color (hex code or CSS color).

Integration Examples

HTML <img> Tag

index.html
<img
  src="https://avatar.agentcareer.lol/api/avatar.svg?seed=agentcareer&shape=squircle&color=bleu"
  alt="User Avatar"
  width="128"
  height="128"
/>

React / Next.js

user-avatar.tsx
import Image from "next/image";

export function UserAvatar({ username }: { username: string }) {
  return (
    <Image
      src={`https://avatar.agentcareer.lol/api/avatar.svg?seed=${encodeURIComponent(username)}&animated=true`}
      alt={`Avatar for ${username}`}
      width={128}
      height={128}
      unoptimized
    />
  );
}

cURL

Terminal
curl -s "https://avatar.agentcareer.lol/api/avatar.svg?seed=agentcareer" -o avatar.svg

On this page