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

# Addestramento di modelli

> Crea modelli personalizzati — stile, oggetto, persona o ambientazione — a partire da immagini di riferimento.

Crea un modello personalizzato in una di quattro categorie — `style`, `object`, `person` o
`setting` — a partire da 1–10 immagini di riferimento. Una volta `completed`, il modello può essere composto
nella [generazione di immagini](/it/api-reference/images/generate),
in [Magic Edit](/it/api-reference/edits/create) e
nei [video con stile](/it/api-reference/videos/generate).

## Due modi per inviare le immagini di riferimento

* **Inline** — [`POST /models`](/it/api-reference/model-training/create) con ogni
  immagine come `url` `https` oppure `base64` inline + `mime_type`. Il modo più semplice per immagini piccole
  e URL remoti.
* **Upload con presigned URL** — per file di grandi dimensioni, chiama
  [`POST /models/prepare`](/it/api-reference/model-training/prepare) per ottenere presigned
  PUT URL, esegui `PUT` di ogni file, quindi chiama
  [`POST /models/{id}/complete`](/it/api-reference/model-training/complete) per avviare
  l'elaborazione.

Entrambi i percorsi richiedono lo scope `models.write`.

## Istruzione sempre applicata

Ogni modello porta una **`instruction`** facoltativa — una guida sempre applicata (max. 8000 caratteri).
A differenza di un prompt per singola richiesta, viene iniettata come direttiva obbligatoria ("MUST FOLLOW") in
**ogni** generazione di immagini e video che compone il modello, così le regole di brand ("sempre uno sfondo
bianco uniforme") valgono senza ripeterle a ogni chiamata. È distinta dal `default_prompt` del modello — una
descrizione delle capacità generata dall'IA che viene anch'essa aggiunta alla generazione. Impostala alla
creazione e modificala in qualsiasi momento con [`PATCH /models/{id}`](/it/api-reference/models/update); in
lettura viene restituita come `user_instruction`.

## Pattern asincrono

La creazione restituisce **`202 Accepted`** con un `id` del modello; interroga
[`GET /models/{id}/status`](/it/api-reference/model-training/status) finché
`status` non è `completed` (o `failed`). Un `webhook_url` ti fornisce una callback push —
vedi [Webhook](/it/guides/webhooks). La creazione di un modello è **gratuita** — il suo `estimated_credits`
è `0` — ma richiede comunque un abbonamento dell'organizzazione attivo; un'organizzazione senza un
abbonamento utilizzabile restituisce `402`. Vedi [Prezzi](/it/guides/pricing).