> ## 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.

# Eigene KI-Avatare

> Private Avatare aus einem Foto oder mit der Webcam erstellen.

Wähle im Widget-Editor **Avatar → Avatar auswählen → Meine Avatare → Eigenen Avatar erstellen**. Gib einen Namen ein und lade ein Foto hoch oder verwende die Webcam.

Verwende ein scharfes, quadratisches JPEG-, PNG- oder WebP-Bild bis **4,5 MB**, idealerweise mindestens **1152 × 1152** Pixel, mit Platz um Kopf und Schultern. Bestätige deine Rechte und die Erlaubnis zur Verwendung.

Die Erstellung kostet **einmalig Credits**. Der Preis wird vor der Bestätigung angezeigt. Während der Verarbeitung werden Credits reserviert und erst nach erfolgreicher Erstellung einmalig abgebucht. Bei sicher fehlgeschlagener Erstellung wird die Reservierung freigegeben. Ein unklares Ergebnis bleibt bis zur Prüfung in Verarbeitung; verwende dieselbe Auftrags-ID, statt erneut kostenpflichtig zu erstellen. Kann innerhalb von 24 Stunden kein Ergebnis bestätigt werden, wird die Reservierung freigegeben und ein verspätetes Ergebnis gelöscht. Es fallen keine laufenden Speicherkosten an. Die Live-Nutzung wird separat berechnet.

Bei unzureichendem Guthaben wird die gespeicherte, aktivierte automatische Aufladeregel zu den vereinbarten Zahlungsbedingungen versucht. Wähle andernfalls **Credits aufladen**, aktualisiere das Guthaben und versuche es erneut. Die Aufladung muss im Workspace gutgeschrieben sein.

Eigene Avatare gehören zum aktiven Workspace und können von dessen Team genutzt werden. Andere Workspaces können sie weder sehen noch auswählen. Standardavatare bleiben gemeinsam verfügbar. Wähle nach der Fertigstellung unter **Meine Avatare** den gewünschten Avatar aus. Wähle vor dem Löschen in allen betroffenen Widgets einen anderen Avatar. Erstellungskosten werden nicht erstattet.

## API, MCP, CLI und SDK

REST: `GET /api/v1/avatars/capability`, `POST /api/v1/avatars/uploads`, `POST /api/v1/avatars`, `GET /api/v1/avatars`, `GET /api/v1/avatars/{id}`, `DELETE /api/v1/avatars/{id}`, `GET /api/v1/avatars/catalog`.

MCP: `get_avatar_capability`, `create_avatar_upload`, `submit_avatar`, `list_avatars`, `get_avatar`, `delete_avatar`, `list_avatar_catalog`.

```bash theme={null}
famulor get-avatar-capability
famulor create-avatar-upload --name "My avatar" --style custom \
  --content-type image/jpeg --size-bytes 123456
# Upload the photo to the returned upload_url before submitting.
famulor submit-avatar --id <prepared-id> --consent true --expected-credits <quoted-price>
famulor get-avatar <prepared-id>
famulor list-avatars
famulor list-avatar-catalog --style realistic
famulor delete-avatar <avatar-id>
```

```typescript theme={null}
import { Famulor } from "famulor-sdk";
import { readFile } from "node:fs/promises";
const photo = new Blob([new Uint8Array(await readFile("photo.jpg"))], { type: "image/jpeg" });
const client = new Famulor({ apiKey: process.env.FAMULOR_API_KEY! });
const quote = await client.avatars.capability();
const upload = await client.avatars.prepareUpload({
  name: "My avatar", style: "custom",
  content_type: "image/jpeg", size_bytes: photo.size,
});
const form = new FormData();
form.append("", photo, "photo.jpg");
form.append("cacheControl", "0");
const uploaded = await fetch(upload.data.upload_url, {
  method: "PUT", headers: { "x-upsert": "false" }, body: form,
});
if (!uploaded.ok) throw new Error("Photo upload failed");
const avatar = await client.avatars.submit({
  id: upload.data.id, consent: true,
  expected_credits: quote.data.creation_credits,
});
const status = await client.avatars.get(avatar.data.id);
```


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