Zum Inhalt springen
POST AI agent ready /v1/avatar

Avatar-API – Kostenloser Identicon-Generator

Erstellen Sie deterministische, visuell unterschiedliche Avatare aus jeder Zeichenfolgeneingabe. Übergeben Sie die E-Mail-Adresse, den Benutzernamen oder die ID eines Benutzers, und die API gibt ein symmetrisches Identicon-Muster zurück. Derselbe Seed erzeugt immer das gleiche Bild, sodass Sie ihn als konsistenten Standard-Avatar verwenden können, ohne Dateien zu speichern.

Parameters

stringrequired

Input string used to generate the avatar pattern. Typically an email address or username.

number

Width and height of the output image in pixels.

string

Background color as a CSS color value. Defaults to #f0f0f0 if omitted.

Code examples

curl -X POST https://api.botoi.com/v1/avatar \
  -H "Content-Type: application/json" \
  -d '{"seed":"john@example.com","size":256,"bg_color":"#f0f0f0"}'

When to use this API

Standardprofilbilder

Weisen Sie jedem neuen Benutzer bei der Anmeldung einen eindeutigen Avatar zu, indem Sie seine E-Mail-Adresse an die API übergeben. Benutzer sehen ein farbenfrohes Identicon anstelle einer generischen grauen Silhouette, wodurch Kommentarthreads und Mitgliederlisten optisch unterschieden werden.

Symbole für Git-Commit-Autoren

Zeigen Sie Identicon-Avatare neben Commit-Nachrichten in einem benutzerdefinierten Git-Dashboard an. Hashen Sie die E-Mail des Autors, um ein konsistentes Symbol zu generieren, das dem Muster entspricht, das GitHub und GitLab für Benutzer ohne Profilfotos verwenden.

Anonyme Forumteilnehmer

Generieren Sie Avatare aus Sitzungs-IDs oder anonymen Handles, damit jeder Teilnehmer eines Diskussionsthreads auch ohne Konto eine erkennbare visuelle Identität hat.

Frequently asked questions

Erzeugt der gleiche Samen immer den gleichen Avatar?
Ja. Der Generierungsalgorithmus ist deterministisch. Wenn Sie heute „john@example.com“ übergeben, wird nächsten Monat genau das gleiche Muster zurückgegeben. Sie können sich darauf verlassen, dass die Anzeige konsistent ist, ohne dass das Bild zwischengespeichert wird.
Wie unterscheidet sich das von Gravatar?
Bei Gravatar müssen Benutzer ein Foto auf gravatar.com hochladen. Diese API generiert ein geometrisches Muster aus einer beliebigen Zeichenfolge, ohne dass eine Benutzeraktion erforderlich ist. Es funktioniert als eigenständiger Standard-Avatar oder als Gravatar-Fallback.
Kann ich die Farben anpassen?
Die Farben werden aus der Saatschnur abgeleitet, um eine visuelle Einzigartigkeit zu gewährleisten. Die API akzeptiert keine benutzerdefinierte Palette. Wenn Sie markenspezifische Farben benötigen, rufen Sie die SVG-Datei ab und ersetzen Sie die Füllwerte.
Was ist die größte Größe, die ich anfordern kann?
Sie können bis zu 512x512 Pixel anfordern. Bei der SVG-Ausgabe wird das Bild unabhängig vom Größenparameter auf jede beliebige Anzeigegröße skaliert.
Wird der Seed-Wert gespeichert oder protokolliert?
Nein. Der Seed wird im Speicher gehasht, um das Muster zu erzeugen, und dann verworfen. Die API speichert, protokolliert oder übermittelt Ihre Eingaben nicht an Dritte.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.

Sign up free View full docs