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

# Sélection automatique des images de référence

> Comment Fanify choisit les meilleures photos d'un personnage (visage et corps) pour les workflows automatiques, et comment calibrer ce choix

## Introduction

Quand un workflow automatique doit mettre un personnage en scène — comme [Dance Maker](/fr/advanced/content/workflows/dance-maker) ou le générateur de selfies — il a besoin d'images de référence de ce personnage : une photo du **visage** (pour l'identité) et une photo du **corps entier** (pour la silhouette et les proportions).

Plutôt que de vous les demander à chaque fois, Fanify les choisit automatiquement dans la galerie grâce à un **algorithme de sélection**. Cette page explique comment il raisonne, comment vérifier ce qu'il choisirait, et comment orienter ses choix pour améliorer tous vos contenus générés.

<Note>
  L'algorithme ne « regarde » pas les images : il raisonne uniquement à partir de ce que la galerie sait d'elles — le personnage assigné, les **tags** et la **notation par étoiles**. C'est vous qui, en entretenant ces informations, décidez de la qualité de ses choix.
</Note>

## Où cet algorithme intervient

* **Dance Maker** — étape [Images de référence](/fr/advanced/content/workflows/dance-maker#étape-6--images-de-référence) : présélection de la meilleure tête et du meilleur corps du personnage
* **Générateur de selfies** (workflow Selfie) : même mécanique
* **Page Empreinte faciale** : l'aperçu de debug affiche en direct ce que les workflows choisiraient (voir [Tester dans l'interface](#tester-dans-linterface))

## D'où viennent les candidats

L'algorithme considère uniquement les **images** de la galerie **assignées au personnage** concerné. Une photo non assignée n'existe pas à ses yeux, même si le personnage y figure.

L'assignation d'un personnage à un média se fait :

* **automatiquement**, par la [reconnaissance faciale](/fr/advanced/content/facial-recognition) à l'ajout de chaque média ;
* **manuellement**, depuis la visionneuse de la galerie (panneau **Personnage** du média).

## Les deux types de référence

Chaque demande précise le type d'image recherché. Les critères sont différents :

| Type                  | Sert à                                     | Idéalement                                                      |
| --------------------- | ------------------------------------------ | --------------------------------------------------------------- |
| **Portrait (visage)** | Préserver l'identité faciale               | Gros plan net du visage, personnage parfaitement reconnaissable |
| **Corps entier**      | Préserver la silhouette et les proportions | Personnage visible de la tête aux pieds                         |

## Le barème de score

Pour chaque image candidate, l'algorithme additionne des points. L'image au score le plus élevé gagne ; les suivantes forment le top des candidats proposés.

### Points liés aux tags (le cœur du barème)

Les tags posés sur le média rapportent l'essentiel des points :

**Pour une référence Portrait (visage) :**

| Tag               | Points (environ) |
| ----------------- | ---------------- |
| `PortraitClean`   | 335              |
| `PortraitAmateur` | 165              |
| `HeadShot`        | 35               |

**Pour une référence Corps entier :**

| Tag                                                                                                                       | Points (environ) |
| ------------------------------------------------------------------------------------------------------------------------- | ---------------- |
| `FullBody`                                                                                                                | 335              |
| Tags d'angle : `FaceFront`, `ProfileLeft`, `ProfileRight`, `ThreeQuarterLeft`, `ThreeQuarterRight`, `BackView`, `TopDown` | 65 chacun        |

<Tip>
  Les tags se cumulent : une photo `FullBody` + `FaceFront` marque environ 400 points. Les photos issues du [configurateur de personnage](/fr/basics/configuration/character-wizard) portent déjà ces tags ; pour vos propres photos, posez-les manuellement depuis la visionneuse de la galerie.
</Tip>

### Points liés à l'auto-tagging

L'[auto-tagging](/fr/advanced/content/auto-tagging) analyse chaque média à son arrivée et pose des tags descriptifs automatiques. Certains servent d'indices à la sélection :

* Indices « visage » : `face close-up`, `portrait`, `upper-body`, `headshot`…
* Indices « corps » : `full-body`, `standing`…

Un indice présent rapporte **25 points**, deux ou plus **50 points**. C'est un filet de sécurité appréciable : même une galerie jamais taguée à la main obtient un premier tri correct.

### Points liés à la notation (étoiles)

La **note par étoiles** que vous donnez à un média dans la visionneuse agit comme un **accélérateur de qualité** — avec une particularité importante : chaque étoile de moins **divise les points par 4**.

| Note  | Points (environ)                 |
| ----- | -------------------------------- |
| ★★★★★ | 335 — autant qu'un tag principal |
| ★★★★  | 85                               |
| ★★★   | 20                               |
| ★★    | 5                                |
| ★     | 1                                |

Concrètement : **seules les notes 4 et 5 étoiles pèsent vraiment**. Noter 5 étoiles votre meilleure photo `FullBody` est le moyen le plus direct de la « pistonner » en tête de sélection.

<Warning>
  Les étoiles ne comptent que si l'image est déjà **pertinente pour le type demandé** (au moins un tag ou un indice correspondant). Une photo 5 étoiles sans aucun signal « visage » ne remontera jamais dans la sélection Portrait — c'est voulu : la note mesure la qualité, pas le cadrage.
</Warning>

### Points liés à la fraîcheur

Un léger bonus (jusqu'à **10 points**) favorise les images récentes. Il ne sert qu'à départager des scores très proches : à tags et notes égaux, la photo la plus récente gagne.

## Tester dans l'interface

Vous pouvez voir **exactement** ce que l'algorithme choisirait, sans lancer de workflow :

1. Allez dans **Admin** > **Serveur** > **Galerie** > **Empreinte faciale**
2. Sélectionnez votre personnage
3. Consultez la carte **Aperçu des références (debug)** : deux rangées affichent le **Top 10 — Portrait (visage)** et le **Top 10 — Corps entier**, dans l'ordre de préférence de l'algorithme

<Frame caption="L'aperçu des références : ce que les workflows choisiraient pour ce personnage">
  <img src="https://mintcdn.com/saufrasoft/t6nZI25vLukByZwc/assets/ui-elements/pages/admin-settings/facial-fingerprint/ref-preview_fr.png?fit=max&auto=format&n=t6nZI25vLukByZwc&q=85&s=923002a4b632db23ec7b6cedac756113" alt="Aperçu des références" width="768" height="956" data-path="assets/ui-elements/pages/admin-settings/facial-fingerprint/ref-preview_fr.png" />
</Frame>

Cliquez sur une vignette pour l'inspecter en grand. Si la première image de chaque rangée vous convient, votre calibrage est bon : c'est elle qui partira dans les workflows.

## Améliorer les résultats

Check-list d'entretien de la galerie, par ordre d'impact :

1. **Assignez le personnage** aux photos où il est parfaitement reconnaissable (le filtre par personnage de la galerie vous montre l'existant). Peu importe l'angle de vue, tant que c'est bien lui.
2. **Posez les tags de cadrage** sur vos meilleures photos : `HeadShot` (ou `PortraitClean` pour un portrait soigné) côté visage, `FullBody` côté corps.
3. **Notez 5 étoiles** la meilleure photo de chaque catégorie — c'est le « cheat code » pour imposer votre choix.
4. **Vérifiez** dans l'aperçu de debug que le Top 10 reflète vos intentions.

## Pendant le workflow : vous gardez la main

Dans [Dance Maker](/fr/advanced/content/workflows/dance-maker), la présélection de l'algorithme vous est toujours présentée pendant **30 secondes** avant utilisation. Vous pouvez :

* ne rien faire — le meilleur candidat est validé automatiquement ;
* choisir un autre candidat du top proposé ;
* **importer** n'importe quelle image de la galerie à la place.

L'algorithme fait le gros du travail ; ces fenêtres servent de dernier contrôle qualité quand vous êtes devant l'écran.

## Questions fréquentes

### L'algorithme choisit une mauvaise photo en premier

Donnez 5 étoiles à celle que vous préférez, et vérifiez ses tags (`HeadShot` / `FullBody`). Si la mauvaise photo a un score gonflé par des tags erronés, corrigez-les. Contrôlez le résultat dans **Aperçu des références (debug)**.

### Le workflow échoue avec « Aucune image exploitable pour la référence »

Le personnage n'a **aucune image** assignée dans la galerie. Assignez-lui des photos (manuellement ou en laissant la [reconnaissance faciale](/fr/advanced/content/facial-recognition) le faire), puis relancez.

### Les Top 10 sont vides mais mon personnage a des photos

Vérifiez que les photos sont bien **assignées au personnage** (filtre personnage dans la galerie) et qu'il s'agit d'**images** (les vidéos ne sont pas candidates). Si elles sont assignées mais qu'aucune n'a de tag ni d'indice, le score est nul : posez un tag de cadrage ou attendez le passage de l'[auto-tagging](/fr/advanced/content/auto-tagging).

### Deux personnages se partagent les mêmes photos

Une photo peut être assignée à plusieurs personnages, et compter pour chacun. Si cela crée des confusions d'identité dans les générations, séparez les galeries : retirez l'assignation du mauvais personnage sur les photos concernées.
