Avatars on demand,
straight from your API.

API Service Subscription

Need avatars at scale? Our API subscription is built for teams and developers who want:

• Server-side rendering support (no client-side React dependency).
• Custom color palettes to perfectly match your brand identity.
• Six unique avatar styles with infinite personalization.

It’s the easiest way to deliver modern, consistent profile images without storing uploads or relying on generic placeholder icons.

Usage

Each subscription is tied to the domains you provide at checkout (one production and one development domain). Requests are validated through CORS (Cross-Origin Resource Sharing), so only your apps can call the API.

After signup, we’ll provision a custom API endpoint (your own subdomain) and email setup instructions within 24 hours.

Example Request

Once your endpoint is active, generate an avatar by calling your custom domain with query parameters:

Query Parameters

• name – The seed string (e.g. username, email).
• variant – Avatar style (beam, pixel, ring, marble, sunset, bauhaus).
• size – Image size in pixels (e.g. 120).
• colors – Comma-separated HEX codes for your palette.
• square – true for square avatars, default is round.

Embedding in HTML

Use the generated URL inside an <img> tag. Always include the crossorigin attribute to ensure CORS headers are respected:

That’s it — your app now serves unique, branded avatars on demand, optimized for scale.