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

# Détection de deepfake et d'usurpation d'identité

> Évaluer les indicateurs de deepfake et d'usurpation d'identité fournis ou les scores externes, et acheminer les résultats de seuil vers les signaux de risque.

> [!WARNING]
>
> Ce point de terminaison ne télécharge ni n'inspecte l'image, la vidéo ou le document référencé. Il évalue les indicateurs ou les scores fournis par votre application. Les valeurs sont des scores de risque heuristiques, et non des probabilités calibrées. L'étiquette `authentic` signifie que le seuil de risque configuré n'a pas été atteint ; ce n'est pas une preuve que le média est authentique, surtout si aucun indicateur n'a été fourni.

L'API de détection de deepfake et d'usurpation évalue les indicateurs ou les scores externes fournis par votre application pour un sujet référencé. Elle n'inspecte pas le média ou le document référencé. Les résultats qui dépassent le seuil de risque créent automatiquement un [signal de risque](https://docs.truthlocks.com/fr/guides/risk-signals.md), connectant vos preuves de détection en amont au pipeline du pare-feu d'identité anti-fraude.

> [!NOTE]
>
> La détection de deepfake fait partie du [Pare-feu d'identité anti-fraude](https://docs.truthlocks.com/fr/guides/risk-signals.md). Les résultats de l'analyse sont intégrés au même pipeline de signaux de risque que les autres signaux de fraude, vous pouvez donc les interroger et les examiner depuis la page de la console **Risque et fraude > Signaux** ou le [point de terminaison de liste des signaux](https://docs.truthlocks.com/fr/api-reference/risk-signals/list.md).

## Comment ça marche

**1. Soumettre une analyse**

Envoyez une requête `POST` à `/v1/risk/deepfake/scan` avec une référence de sujet et soit des signaux d'indicateurs bruts de votre pipeline de détection, soit des scores pré-calculés d'un modèle externe.

**2. Examiner le verdict**

La réponse inclut les scores de deepfake et d'usurpation d'identité (0-100) et un verdict : `authentic`, `suspect`, `deepfake`, ou `impersonation`.

**3. Création automatique de signaux**

Lorsqu'un score atteint 60 ou plus, la plateforme ingère automatiquement un signal de risque dans le pipeline de votre locataire. La réponse inclut le `signal_id` afin que vous puissiez le tracer.

**4. Récupérer les résultats plus tard**

Utilisez `GET /v1/risk/deepfake/results/{subject_ref}` pour récupérer le dernier résultat d'analyse pour tout sujet précédemment analysé.

## Prérequis

* Un locataire Truthlocks actif avec une clé API
* Références de sujet pour le contenu que vous souhaitez scanner (URL, hachages SHA-256, ID d'attestation ou identifiants opaques)

## Analyse d'un sujet

Soumettez un scan avec des signaux indicateurs de votre pipeline de détection :

```bash cURL theme={null}
curl -X POST https://api.truthlocks.com/v1/risk/deepfake/scan \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "subject_ref": "sha256:a1b2c3d4...",
    "subject_type": "image",
    "signals": ["face_swap_detected", "inconsistent_lighting"]
  }'
```

```javascript JavaScript theme={null}
const response = await fetch("https://api.truthlocks.com/v1/risk/deepfake/scan", {
  method: "POST",
  headers: {
    "X-API-Key": "tl_live_...",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    subject_ref: "sha256:a1b2c3d4...",
    subject_type: "image",
    signals: ["face_swap_detected", "inconsistent_lighting"],
  }),
});
const result = await response.json();
```

```python Python theme={null}
import httpx

resp = httpx.post(
    "https://api.truthlocks.com/v1/risk/deepfake/scan",
    headers={"X-API-Key": "tl_live_..."},
    json={
        "subject_ref": "sha256:a1b2c3d4...",
        "subject_type": "image",
        "signals": ["face_swap_detected", "inconsistent_lighting"],
    },
)
result = resp.json()
```

La réponse inclut les scores, un verdict et (si le seuil a été atteint) un signal de risque lié :

```json theme={null}
{
  "scan_id": "7c8d9e0f-...",
  "subject_ref": "sha256:a1b2c3d4...",
  "subject_type": "image",
  "deepfake_score": 60,
  "impersonation_score": 0,
  "verdict": "suspect",
  "indicators": ["face_swap_detected", "inconsistent_lighting"],
  "detection_model": "heuristic_v1",
  "signal_id": "9f3a1c2d-...",
  "created_at": "2027-05-22T10:00:00Z"
}
```

## Modèle de détection

La plateforme utilise un moteur de signal heuristique (`heuristic_v1`) qui mappe les indicateurs fournis par l'appelant à des scores pondérés. Le moteur évalue 12 indicateurs répartis en deux catégories :

### Indicateurs de Deepfake

| Indicateur | Description |
| :- | :- |
| `face_swap_detected` | Remplacement ou morphing de visage détecté |
| `inconsistent_lighting` | Incohérences d'éclairage sur le sujet |
| `compression_artifacts` | Motifs de compression inhabituels suggérant une manipulation |
| `temporal_inconsistency` | Incohérences au niveau de l'image dans le contenu vidéo |
| `metadata_mismatch` | Les métadonnées du fichier ne correspondent pas aux modèles attendus |

### Indicateurs d'usurpation d'identité

| Indicateur | Description |
| :- | :- |
| `biometric_mismatch` | Les données biométriques ne correspondent pas à l'identité revendiquée |
| `name_mismatch` | Le nom sur le document d'identité ne correspond pas aux enregistrements |
| `identity_doc_mismatch` | Le document d'identité semble altéré ou incohérent |
| `issuer_trust_violation` | Le niveau de confiance de l'émetteur est insuffisant pour la revendication |

## Verdicts et seuils

Chaque analyse produit un verdict basé sur le score le plus élevé :

| Plage de scores | Verdict | Signification |
| :- | :- | :- |
| 0 – 39 | `authentic` | Aucun indicateur significatif détecté |
| 40 – 74 | `suspect` | Certains indicateurs présents — examen recommandé |
| 75 – 100 | `deepfake` ou `impersonation` | Détection à haute confiance — le verdict dépend du score dominant |

Lorsque l'un des scores atteint **60 ou plus**, la plateforme crée automatiquement un signal de risque. Vous n'avez pas besoin de faire un appel API séparé — le `signal_id` est renvoyé dans la réponse de l'analyse.

## Utilisation de scores pré-calculés

Si vous avez déjà des scores provenant d'un modèle ML externe ou d'un service de détection, transmettez-les directement pour ignorer l'analyse heuristique :

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/risk/deepfake/scan \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "subject_ref": "sha256:a1b2c3d4...",
    "subject_type": "video",
    "deepfake_score": 82,
    "impersonation_score": 15
  }'
```

La plateforme applique toujours les mêmes seuils de verdict et l'ingestion automatique de signaux, de sorte que vous obtenez une classification cohérente quelle que soit la source de détection.

## Lier les analyses aux attestations

Associez une analyse à une attestation existante pour lier les résultats de détection aux informations d'identification auxquelles ils se rapportent :

```bash theme={null}
curl -X POST https://api.truthlocks.com/v1/risk/deepfake/scan \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "subject_ref": "sha256:a1b2c3d4...",
    "subject_type": "attestation",
    "signals": ["biometric_mismatch", "identity_doc_mismatch"],
    "attestation_id": "660e8400-e29b-41d4-a716-446655440001"
  }'
```

Cela facilite le signalement et l'examen des attestations suspectes dans la console.

## Récupération des résultats d'analyse

Récupérer le dernier résultat d'analyse pour un sujet sans relancer l'analyse :

```bash theme={null}
curl https://api.truthlocks.com/v1/risk/deepfake/results/sha256:a1b2c3d4... \
  -H "X-API-Key: tl_live_..."
```

## Types de sujets

Le champ `subject_type` indique à la plateforme le type de contenu analysé :

| Type | Cas d'utilisation |
| :- | :- |
| `image` | Photos, documents d'identité, photos de profil |
| `video` | Enregistrements vidéo, captures en direct |
| `document` | PDF, documents scannés |
| `attestation` | Identifiants émis via la plateforme |
| `identity` | Revendications d'identité, soumissions KYC |

## Mesure de l'utilisation

Chaque demande d'analyse de deepfake incrémente le compteur d'utilisation `antifraud.deepfake_scans` pour votre cycle de facturation. Vous pouvez surveiller votre consommation d'analyse avec l'[API d'utilisation](https://docs.truthlocks.com/fr/api-reference/billing/usage.md) ou dans la console sous **Paramètres > Facturation > Utilisation** dans la section **Anti-fraude**.

> [!NOTE]
>
> Les quotas d'analyse de deepfake varient selon le niveau de plan. Consultez l'[aperçu de la facturation](https://docs.truthlocks.com/fr/billing/overview.md#metered-products) pour plus de détails sur tous les produits mesurés anti-fraude.

## La suite

* [Référence de l'API de scan Deepfake](https://docs.truthlocks.com/fr/api-reference/risk/deepfake-scan.md)
* [Référence de l'API des résultats de scan](https://docs.truthlocks.com/fr/api-reference/risk/deepfake-results.md)
* [Guide de détection de la prise de contrôle de compte](https://docs.truthlocks.com/fr/guides/ato-detection.md)
* [Guide de la vélocité et de la notation des anomalies](https://docs.truthlocks.com/fr/guides/velocity-scoring.md)
* [Guide des signaux de risque](https://docs.truthlocks.com/fr/guides/risk-signals.md)
* [Référence de l'API d'ingestion de signal de risque](https://docs.truthlocks.com/fr/api-reference/risk/ingest-signal.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.