> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Assistentenbilder

> Wähle ein Maskottchen aus der Galerie oder lade ein eigenes Bild hoch.

Klicke im Assistenten-Header auf das Bild und wähle **Avatar verwenden**, um die Galerie zu öffnen. Entdecke Profilbilder, Outfits, Szenen, Länderflaggen, Trachten und Product-Hunt-Editionen. Suche nach Namen oder Land, wähle einen hellen oder dunklen Hintergrund und klicke auf **Bild verwenden**.

Wähle **Eigenen Avatar hochladen** im Bildmenü für eine PNG-, JPEG- oder WebP-Datei bis 10 MB; sie wird vor dem Upload komprimiert. Mit **Avatar entfernen** im selben Menü kehrst du zum Standard-Orb zurück. Schließt du die Galerie ohne Übernehmen, bleibt das gespeicherte Bild erhalten. Galeriebilder und eigene Uploads lassen sich jederzeit gegeneinander austauschen.

Die Bilder erscheinen in Assistentenlisten, Auswahlfeldern und Testgesprächen. Neue Widgets können das Assistentenbild als erstes Logo übernehmen; bestehende Widget-Logos bleiben unabhängig. Das statische Profilbild ist vom sprechenden Video-Avatar getrennt. Die Famulor-Galerie ist für direkte Famulor-Workspaces verfügbar; Whitelabel-Kunden nutzen eigene Uploads.

## Automatisierung

Rufe die verfügbaren Bilder ab und wähle eines über seine zurückgegebene ID. REST-Uploads akzeptieren PNG, JPEG oder WebP bis 1 MB oder eine öffentliche Bild-URL. Zum Entfernen nutze den DELETE-Endpunkt für Avatare, das MCP-Tool `delete_assistant_avatar` oder `famulor delete-assistant-avatar <id>`.

| REST | MCP | CLI |
| - | - | - |
| `GET /api/v1/assistants/avatar-gallery` | `list_assistant_avatar_gallery` | `famulor list-assistant-avatar-gallery` |
| `POST /api/v1/assistants/{id}/avatar` | `upload_assistant_avatar` | `famulor set-assistant-avatar <id>` |
| `DELETE /api/v1/assistants/{id}/avatar` | `delete_assistant_avatar` | `famulor delete-assistant-avatar <id>` |

```bash theme={null}
famulor list-assistant-avatar-gallery
famulor set-assistant-avatar <id> --gallery-id profile-headset --appearance light
famulor set-assistant-avatar <id> --file ./portrait.png
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.