Platzhalter-Avatar-API

Live-Beispiele

Alle Bilder unten werden live vom in dieser Seite beschriebenen Endpunkt ausgeliefert.

200roundedsquareBPgriddotsdiagonalcheckerid 237grayblur 4colors

Schnellstart

Setzen Sie die URL direkt in ein Bild-Tag. Die Maße sind in Pixeln, die Standardform ist ein Kreis, daher ist kein zusätzliches Styling nötig.

<img src="https://blankpfp.com/api/avatar/seed/alice/200" alt="Alice" width="200" height="200">

Oder als CSS-Hintergrund verwenden:

.avatar {
  width: 96px;
  height: 96px;
  border-radius: 50%;
  background-image: url("https://blankpfp.com/api/avatar/seed/alice/96");
  background-size: cover;
}

In JavaScript bauen Sie die URL aus dem, was den Benutzer identifiziert:

avatar.src = 'https://blankpfp.com/api/avatar/seed/' + encodeURIComponent(user.email) + '/200';

URL-Syntax

Alle vier Formen akzeptieren eine optionale Höhe. Hängen Sie .json an, um statt des Bildes die unten beschriebenen Metadaten zu erhalten.

Deterministische Seeds

Ein Seed wird zu einer Farbe aus einer 48-stufigen Palette gehasht, sodass derselbe Seed immer denselben Avatar liefert – ohne Datenbank und ohne Speicherung auf der Festplatte. Verwenden Sie einen Benutzernamen, eine E-Mail-Adresse oder eine Datensatz-ID. Seeds mit Leerzeichen oder Sonderzeichen müssen prozentkodiert werden; /api/avatar/id/ ist eine Kurzform für numerische IDs.

<img src="https://blankpfp.com/api/avatar/seed/alice/200" alt="alice">\n<img src="https://blankpfp.com/api/avatar/seed/bob/200" alt="bob">\n<img src="https://blankpfp.com/api/avatar/id/237/200" alt="record 237">

Abfrageparameter

Alle Parameter sind optional und kombinierbar. Ein unbekannter Wert liefert eine 400-Antwort mit JSON-Erklärung statt einem kaputten Bild.

Hex-Farben dürfen mit oder ohne führendes Rautenzeichen geschrieben werden, Kurzform wie #abc wird aufgelöst. Ohne bg stammt der Hintergrund vom Seed; ohne fg wird die Schriftfarbe automatisch für Lesbarkeit gewählt. Ein Blur-Wert über dem Maximum wird gekappt statt abgelehnt, und Initialen haben nie mehr als zwei Zeichen.

Silhouetten

Dieselben fünfzehn Büsten-Silhouetten wie im Generator, über ID oder Name erreichbar. fg färbt die Silhouette und bg den Hintergrund, daher sieht dieselbe ID je nach Palette anders aus.

Solid fill

defaultmalefemaleelderchildcartoonheadshotprofileroundheadhoodielonghairbuncapbeaniecurlytallathleticslimbroadpetitelargeshorthairwavyponytailpigtailsbaldrecedingafromohawksidepartbobfedoratophatberetcrownglasses_roundglasses_squareglasses_aviatorheadphonesbeard_fullbeard_goateemustachecollaredturtleneckscarftieprofile_leftprofile_righthipstersurfernerdexecutiveartist

Hollow outline (outline=1)

defaultmalefemaleelderchildcartoonheadshotprofileroundheadhoodielonghairbuncapbeaniecurlytallathleticslimbroadpetitelargeshorthairwavyponytailpigtailsbaldrecedingafromohawksidepartbobfedoratophatberetcrownglasses_roundglasses_squareglasses_aviatorheadphonesbeard_fullbeard_goateemustachecollaredturtleneckscarftieprofile_leftprofile_righthipstersurfernerdexecutiveartist

Ausprobieren

Wähle ein beliebiges Avatar auf dieser Seite und ändere dann die Parameter unten. Vorschau und Code werden dabei aktualisiert, und was du kopierst, liefert der Endpunkt auch genau so zurück.

Vorschau

Form circle rounded square Muster solid grid dots diagonal checker Initialen

Hintergrund automatisch

Vordergrund automatisch

Unschärfe

0

Outline Graustufen

Zurücksetzen

URL

Antwortformate

Bilder werden als SVG ausgeliefert, was ein typisches Avatar zwischen 200 und 1000 Bytes hält und bei jeder Pixeldichte scharf bleibt. Hängen Sie .json an dieselbe URL an, um stattdessen die aufgelösten Farben zu lesen – praktisch, um die umgebende Oberfläche an das Avatar anzupassen.

{
  "ok": true,
  "mode": "seed",
  "seed": "alice",
  "width": 200,
  "height": 200,
  "shape": "circle",
  "pattern": "solid",
  "figure": null,
  "background": "#9CA3AF",
  "foreground": "#111827",
  "initials": null,
  "outline": false,
  "grayscale": false,
  "blur": 0,
  "format": "svg",
  "bytes": 266,
  "url": "https://blankpfp.com/api/avatar/seed/alice/200/200.svg",
  "info": "https://blankpfp.com/api/avatar/seed/alice/200/200.json"
}

Ungültige Anfragen antworten mit 400 und einem JSON-Body:

{
  "ok": false,
  "error": "invalid_parameters",
  "errors": ["pattern: expected one of solid, grid, dots, diagonal, checker"],
  "docs": "https://blankpfp.com/docs"
}

Caching und Grenzen

Geseedete URLs sind eine reine Funktion der Adresse und werden deshalb mit einem unveränderlichen Cache-Header für ein Jahr und einem ETag ausgeliefert. Stellen Sie ein CDN vor Ihre Anwendung, dann kosten die Bilder nach der ersten Anfrage nichts mehr. Breite und Höhe dürfen zwischen 16 und 2048 Pixeln liegen; größere Werte werden geklemmt statt abgelehnt, und die aufgelöste Größe steht im JSON. Um bei jeder Anfrage ein anderes Bild zu zeigen, hängen Sie ?random= mit einem beliebigen Wert an.

FAQ

Weitere Werkzeuge