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

# Entraînement de modèles

> Crée des modèles personnalisés — style, objet, personne ou décor — à partir d'images de référence.

Crée un modèle personnalisé dans l'une des quatre catégories — `style`, `object`, `person` ou
`setting` — à partir de 1 à 10 images de référence. Une fois `completed`, le modèle peut être composé
dans la [génération d'images](/fr/api-reference/images/generate),
[Magic Edit](/fr/api-reference/edits/create) et
[la vidéo stylisée](/fr/api-reference/videos/generate).

## Deux façons d'envoyer des images de référence

* **Inline** — [`POST /models`](/fr/api-reference/model-training/create) avec chaque
  image sous forme d'`url` `https` ou de `base64` inline + `mime_type`. Le plus simple pour les petites
  images et les URLs distantes.
* **Presigned upload** — pour les fichiers volumineux, appelle
  [`POST /models/prepare`](/fr/api-reference/model-training/prepare) pour obtenir des presigned URLs
  PUT, envoie chaque fichier avec `PUT`, puis
  [`POST /models/{id}/complete`](/fr/api-reference/model-training/complete) pour lancer
  le traitement.

Les deux chemins nécessitent le scope `models.write`.

## Instruction toujours appliquée

Chaque modèle porte une **`instruction`** optionnelle — une guidance toujours appliquée (max. 8000 caractères).
Contrairement à un prompt par requête, elle est injectée comme directive obligatoire ("MUST FOLLOW") dans
**chaque** génération d'image et de vidéo qui compose le modèle, si bien que les règles de marque ("toujours un
fond blanc uni") s'appliquent sans les répéter à chaque appel. Elle est distincte du `default_prompt` du modèle —
une description de capacités générée par IA qui est elle aussi ajoutée à la génération. Définis-la à la création
et modifie-la à tout moment avec [`PATCH /models/{id}`](/fr/api-reference/models/update) ; à la lecture, elle est
renvoyée sous le nom `user_instruction`.

## Modèle asynchrone

La création renvoie **`202 Accepted`** avec un `id` de modèle ; interroge
[`GET /models/{id}/status`](/fr/api-reference/model-training/status) jusqu'à ce que
`status` soit `completed` (ou `failed`). Un `webhook_url` te donne un callback push —
voir [Webhooks](/fr/guides/webhooks). La création de modèle est **gratuite** — son `estimated_credits`
vaut `0` — mais nécessite toujours un abonnement d'organisation actif ; une organisation sans abonnement
utilisable renvoie `402`. Voir [Pricing](/fr/guides/pricing).