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

# Reconnaissance faciale

> L'empreinte faciale des personnages : à quoi elle sert, comment la calibrer, la tester et régler son seuil de correspondance

## Introduction

Fanify sait **reconnaître le visage de vos personnages**. Pour chaque personnage, il entretient une **empreinte faciale** : une signature de son visage, apprise à partir des photos de la galerie où il apparaît.

Grâce à cette empreinte, l'instance reconnaît automatiquement le personnage sur chaque nouveau média, organise la galerie sans effort, et vérifie que les images générées par les workflows représentent bien la bonne personne.

La reconnaissance faciale fait partie de **FanifyML**, le service d'analyse d'images inclus avec votre instance (**Admin** > **Services** > **FanifyML**).

## Où la reconnaissance faciale est utilisée

| Usage                        | Ce qui se passe                                                                                                                                                                                                     |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **À l'ajout d'un média**     | Chaque image ajoutée à la galerie (importée ou générée) est analysée : si un visage correspond à l'empreinte d'un personnage, le média lui est **automatiquement assigné**                                          |
| **Conformité Dance Maker**   | Chaque image générée par [Dance Maker](/fr/advanced/content/workflows/dance-maker#étape-8--conformité-de-limage) est comparée à l'empreinte du personnage : si le visage a dérivé, l'image est rejetée et régénérée |
| **Visages similaires**       | Dans la visionneuse de la galerie, la recherche **Visages similaires** retrouve les médias au visage proche                                                                                                         |
| **Sélection des références** | Indirectement : l'assignation automatique alimente les candidats de la [sélection d'images de référence](/fr/advanced/content/reference-selection)                                                                  |

## Comment l'empreinte vit et évolue

L'empreinte d'un personnage est la **moyenne** de tous les visages qui lui ont été rattachés. Elle n'est pas figée :

* chaque **nouveau média reconnu** (ou assigné manuellement) vient enrichir la moyenne ;
* l'empreinte **s'adapte donc dans le temps** — si votre personnage prend de l'âge ou si son identité visuelle évolue au fil de vos générations, l'empreinte le suit naturellement.

C'est une force, mais aussi la raison pour laquelle **le calibrage initial compte** : une empreinte amorcée sur de mauvaises photos attirera de mauvaises reconnaissances, qui la déformeront encore davantage.

<Note>
  Les images produites par les générateurs ne sont **jamais** rattachées de force à un personnage : seule une vraie reconnaissance du visage le fait. Un visage raté ne peut donc pas polluer l'empreinte.
</Note>

## Calibrer l'empreinte d'un personnage

<Steps>
  <Step title="Assigner les bonnes photos">
    Dans la **Galerie**, assignez le personnage aux photos où son visage est **net, bien visible et parfaitement reconnaissable** (panneau **Personnage** de la visionneuse). Tous les angles conviennent ; évitez seulement les photos où le visage vous semble raté ou trop éloigné de l'identité voulue.
  </Step>

  <Step title="Ouvrir la page Empreinte faciale">
    Allez dans **Admin** > **Serveur** > **Galerie** > **Empreinte faciale**, puis sélectionnez le personnage. Le panneau de diagnostic s'affiche : présence de l'**Empreinte**, nombre de visages agrégés (**Embeddings**), **Médias taggés**, **Visages matchés** et **Seuil de match** courant.

    <Frame caption="Le diagnostic d'empreinte d'un personnage">
      <img src="https://mintcdn.com/saufrasoft/t6nZI25vLukByZwc/assets/ui-elements/pages/admin-settings/facial-fingerprint/diagnostic_fr.png?fit=max&auto=format&n=t6nZI25vLukByZwc&q=85&s=4b0552b5a27df86be65a6ac4886354b8" alt="Diagnostic de l'empreinte faciale" width="768" height="334" data-path="assets/ui-elements/pages/admin-settings/facial-fingerprint/diagnostic_fr.png" />
    </Frame>
  </Step>

  <Step title="Recalculer l'empreinte">
    Dans la carte **Recalculer l'empreinte**, cliquez sur **Recalculer**. Fanify reconstruit l'empreinte à partir de tous les visages des médias assignés au personnage. L'opération est quasi instantanée : elle réutilise les analyses déjà faites, sans réanalyser d'images.
  </Step>

  <Step title="Vérifier">
    Utilisez les cartes de contrôle décrites ci-dessous pour confirmer que l'empreinte reconnaît bien votre personnage.
  </Step>
</Steps>

<Tip>
  Faites ce calibrage **dès la création du personnage**, puis après chaque grande vague d'ajouts de photos. Une empreinte bien calibrée au départ s'entretient ensuite toute seule.
</Tip>

## Le seuil de correspondance

Quand un visage est comparé à une empreinte, Fanify calcule un **pourcentage de ressemblance**. Le visage est reconnu si ce pourcentage atteint le **Seuil de correspondance (global)** — réglable sur la même page, par défaut **70 %**.

* **Seuil plus haut** : plus strict. Moins de fausses reconnaissances, mais des vrais visages peuvent être manqués.
* **Seuil plus bas** : plus tolérant. Plus de médias reconnus, mais davantage d'erreurs possibles — et une empreinte qui risque de se déformer.

Ce seuil s'applique partout à la fois : à l'assignation automatique des nouveaux médias **et** à la vérification de conformité de Dance Maker. Modifiez-le par petites touches (± 0,05) et observez l'effet avant d'aller plus loin.

<Frame caption="Le réglage du seuil de correspondance global">
  <img src="https://mintcdn.com/saufrasoft/t6nZI25vLukByZwc/assets/ui-elements/pages/admin-settings/facial-fingerprint/threshold_fr.png?fit=max&auto=format&n=t6nZI25vLukByZwc&q=85&s=8f91bc730b626d548204deaddc9333ab" alt="Seuil de correspondance" width="768" height="278" data-path="assets/ui-elements/pages/admin-settings/facial-fingerprint/threshold_fr.png" />
</Frame>

## Tester et surveiller

La page **Empreinte faciale** offre trois outils de contrôle, tous en lecture seule :

### Comparer un média

La carte **Debug : comparer un média** répond à la question « ce visage serait-il reconnu ? » :

1. Chargez une image (depuis la galerie ou votre appareil)
2. Cliquez sur **Comparer**
3. Le verdict s'affiche — **Correspondance** ou **Pas de correspondance** — avec la **Similarité max** mesurée face au **Seuil**

Idéal pour comprendre pourquoi un média n'a pas été assigné, ou pour jauger l'effet d'un changement de seuil avant de le faire.

<Frame caption="L'outil de comparaison d'un média à l'empreinte du personnage">
  <img src="https://mintcdn.com/saufrasoft/t6nZI25vLukByZwc/assets/ui-elements/pages/admin-settings/facial-fingerprint/compare_fr.png?fit=max&auto=format&n=t6nZI25vLukByZwc&q=85&s=61d7c46c1d7ffc26b4a26ee5141d76d9" alt="Comparer un média" width="768" height="290" data-path="assets/ui-elements/pages/admin-settings/facial-fingerprint/compare_fr.png" />
</Frame>

### Les médias les plus ressemblants / divergents

Deux cartes classent les médias assignés au personnage selon leur ressemblance à l'empreinte :

* **Médias les plus ressemblants (debug)** : le cœur fidèle de l'identité — ce à quoi « ressemble » l'empreinte.
* **Médias les plus divergents (debug)** : les visages qui tirent l'empreinte ailleurs. C'est ici que se repèrent les intrus.

<Frame caption="Les médias qui divergent le plus de l'empreinte du personnage">
  <img src="https://mintcdn.com/saufrasoft/t6nZI25vLukByZwc/assets/ui-elements/pages/admin-settings/facial-fingerprint/divergent-similar_fr.png?fit=max&auto=format&n=t6nZI25vLukByZwc&q=85&s=3af9fe7a2766c00aec5aa3d157b3113d" alt="Médias divergents et ressemblants" width="768" height="748" data-path="assets/ui-elements/pages/admin-settings/facial-fingerprint/divergent-similar_fr.png" />
</Frame>

**Routine d'assainissement** : parcourez les divergents ; si un média n'est manifestement pas le personnage (ou un visage raté), retirez-lui l'assignation dans la visionneuse, puis **Recalculer**. L'empreinte redevient propre.

## Pourquoi c'est important

Une empreinte bien calibrée, c'est :

* une **galerie qui s'organise seule** — chaque nouveau média est rangé au bon personnage sans action de votre part ;
* des **workflows fiables** — la conformité de Dance Maker rejette automatiquement les images où le visage a dérivé, avant de payer la génération vidéo ;
* une **identité visuelle stable** dans le temps, même après des centaines de générations.

## Questions fréquentes

### Le diagnostic affiche « Empreinte : Absente »

Le personnage n'a encore aucun visage agrégé. Assignez-lui des photos où son visage est net, puis cliquez sur **Recalculer**.

### Un média n'est pas reconnu alors que c'est bien le personnage

Testez-le avec **Debug : comparer un média** : si la similarité est juste sous le seuil, le visage est probablement de trop petite taille, flou ou très en angle. Assignez ce média manuellement (l'assignation manuelle enrichit aussi l'empreinte), ou baissez légèrement le seuil si le cas se répète.

### Des médias sont assignés à tort à un personnage

Le seuil est trop tolérant, ou l'empreinte a été contaminée. Retirez l'assignation des médias fautifs, remontez le seuil d'un cran, puis **Recalculer**. Contrôlez ensuite la carte des médias divergents.

### L'empreinte s'est déformée au fil du temps

Symptôme classique d'une dérive : les générations récentes s'éloignent de l'identité d'origine. Passez en revue les **médias divergents**, retirez l'assignation des visages qui ne conviennent plus, puis **Recalculer**. L'empreinte revient à la moyenne des visages restants.

### « Service de détection faciale indisponible »

FanifyML ne répond pas. Vérifiez son état dans **Admin** > **Services** > **FanifyML** (carte de santé). Pendant une indisponibilité, les workflows continuent de fonctionner : ils sautent simplement les vérifications faciales.
