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

# Modelltraining

> Erstelle eigene Modelle — Style, Objekt, Person oder Setting — aus Referenzbildern.

Erstelle ein eigenes Modell in einer von vier Kategorien — `style`, `object`, `person` oder
`setting` — aus 1–10 Referenzbildern. Sobald `completed`, kann das Modell in
[Bildgenerierung](/de/api-reference/images/generate),
[Magic Edit](/de/api-reference/edits/create) und
[gestyltes Video](/de/api-reference/videos/generate) eingebunden werden.

## Zwei Wege, Referenzbilder einzureichen

* **Inline** — [`POST /models`](/de/api-reference/model-training/create) mit jedem
  Bild als `https` `url` oder inline `base64` + `mime_type`. Am einfachsten für kleine
  Bilder und Remote-URLs.
* **Presigned Upload** — für große Dateien: Rufe
  [`POST /models/prepare`](/de/api-reference/model-training/prepare) auf, um presigned
  PUT-URLs zu erhalten, `PUT` jede Datei, dann
  [`POST /models/{id}/complete`](/de/api-reference/model-training/complete), um die
  Verarbeitung zu starten.

Beide Wege erfordern den `models.write` Scope.

## Stets angewandte Instruction

Jedes Modell trägt eine optionale **`instruction`** — stets angewandte Guidance (max. 8000 Zeichen).
Anders als ein Prompt pro Anfrage wird sie als verbindliche ("MUST FOLLOW") Vorgabe in **jede** Bild- und
Videogenerierung eingespeist, die das Modell komponiert, sodass Brand-Regeln ("immer ein nahtloser weißer
Hintergrund") greifen, ohne sie bei jedem Aufruf zu wiederholen. Sie ist vom `default_prompt` des Modells zu
unterscheiden — einer KI-generierten Fähigkeitsbeschreibung, die ebenfalls bei der Generierung angehängt wird.
Setze sie bei der Erstellung und ändere sie jederzeit mit
[`PATCH /models/{id}`](/de/api-reference/models/update); beim Abruf wird sie als `user_instruction` zurückgegeben.

## Asynchrones Muster

Die Erstellung gibt **`202 Accepted`** mit einer Modell-`id` zurück; frage
[`GET /models/{id}/status`](/de/api-reference/model-training/status) ab, bis
`status` gleich `completed` (oder `failed`) ist. Ein `webhook_url` gibt dir einen Push-Callback —
siehe [Webhooks](/de/guides/webhooks). Die Modellerstellung ist **kostenlos** — ihr `estimated_credits`
ist `0` —, erfordert aber weiterhin ein aktives Organisations-Abo; eine Organisation ohne nutzbares Abo
liefert `402`. Siehe [Preise](/de/guides/pricing).