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

# Analyse de deepfake et d'usurpation d'identité

> Soumettre un sujet pour analyse de deepfake et d'usurpation d'identité. Renvoie les scores, le verdict et les indicateurs. Ingeste automatiquement un signal de risque si les scores dépassent le seuil de déclenchement automatique (60).

> [!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.

## Comment fonctionne la détection

Les analyses utilisent un **moteur de signaux heuristiques** (`heuristic_v1`) qui accepte les signaux fournis par l'appelant (provenant de modèles ML externes, de moteurs de règles ou d'une révision manuelle) et les mappe à des scores pondérés :

* **Indicateurs de deepfake :** échange de visage, éclairage incohérent, artefacts de compression, incohérence temporelle, non-concordance des métadonnées
* **Indicateurs d'usurpation d'identité :** non-concordance biométrique, non-concordance de nom, non-concordance de document d'identité, violation de la confiance de l'émetteur

Les scores ≥ 75 définissent le verdict `deepfake` ou `impersonation`. Les scores ≥ 40 définissent `suspect`. Les scores ≥ 60 ingèrent automatiquement un signal de risque.

Vous pouvez également contourner l'analyse heuristique en transmettant directement les valeurs `deepfake_score` et `impersonation_score` pré-calculées. La plateforme applique toujours les mêmes seuils de verdict et l'ingestion automatique de signaux.

Consultez le [guide de détection de deepfake](https://docs.truthlocks.com/fr/guides/deepfake-detection.md) pour le flux de travail complet, la référence des indicateurs et des exemples supplémentaires.

## Réponse

**scan\_id** `string`

UUID du résultat de l'analyse.

**subject\_ref** `string`

La référence du sujet qui a été scannée.

**subject\_type** `string`

Type de sujet : `image`, `video`, `document`, `attestation`, `identity`

**deepfake\_score** `integer`

Score de risque heuristique de deepfake (0–100).

**impersonation\_score** `integer`

Score de risque heuristique d'usurpation d'identité (0–100).

**verdict** `string`

`authentic` | `suspect` | `deepfake` | `impersonation`

**indicators** `array`

Liste des indicateurs déclenchés par l'analyse.

**detection\_model** `string`

Modèle de détection utilisé (par exemple `heuristic_v1`).

**signal\_id** `string`

UUID du signal de risque auto-ingéré (présent uniquement lorsque le score est ≥ 60).

**attestation\_id** `string`

UUID de l'attestation liée, si une a été fournie lors du scan.

**created\_at** `string`

Horodatage ISO 8601 de l'exécution de l'analyse.


## OpenAPI

````yaml fr/mint-openapi.yaml POST /v1/risk/deepfake/scan
openapi: 3.0.3
info:
  title: Truthlocks API
  description: >
    Truthlocks est une infrastructure de vérification universelle pour les
    documents, les identifiants et les actifs numériques.

    Cette spécification définit l'API canonique pour interagir avec les services
    Truthlocks.


    ## URL de base

    - **Production** : `https://api.truthlocks.com`

    - **Sandbox** : `https://sandbox-api.truthlocks.com`


    ## Authentification

    - **Clés API** : Utilisez l'en-tête `X-API-Key` pour les opérations de
    machine à machine

    - **Jetons Bearer** : Utilisez `Authorization: Bearer <jwt>` pour les
    opérations initiées par l'utilisateur


    ## Identité du locataire

    En production, l'identité du locataire est dérivée du contexte authentifié
    (clé API ou JWT).

    L'en-tête `X-Tenant-ID` est ignoré en production pour éviter l'usurpation
    d'identité.
  version: 1.0.0
  contact:
    name: Truthlocks Support
    url: https://truthlocks.com/support
    email: support@truthlocks.com
servers:
  - url: https://api.truthlocks.com
    description: API de production
  - url: https://sandbox-api.truthlocks.com
    description: Environnement de bac à sable
security:
  - APIKey: []
  - BearerAuth: []
tags:
  - name: Authentication
    description: Gestion des clés API et des jetons
  - name: Issuers
    description: Enregistrement de l'émetteur et gestion de la confiance
  - name: Keys
    description: Gestion des clés cryptographiques pour les émetteurs
  - name: Attestations
    description: Cycle de vie de l'attestation (créer, révoquer, remplacer)
  - name: Verification
    description: Vérification des attestations et lots de preuves
  - name: Governance
    description: Flux de travail de gouvernance de l'émetteur (administrateur uniquement)
  - name: Identity
    description: Gestion de l'organisation, des utilisateurs et des rôles
  - name: Audit
    description: Requêtes d'événements d'audit
  - name: Tenant Console
    description: Points de terminaison du profil et du cycle de vie du locataire
  - name: Health
    description: Points de terminaison de l'état et de la disponibilité du service
  - name: Risk
    description: Ingestion de signaux de risque et détection de fraude
  - name: Risk Enforcement
    description: >-
      Actions d'application des risques — blocage, défi, quarantaine et
      configuration
  - name: Billing
    description: Gestion de la facturation, des abonnements et des modules complémentaires
  - name: Machine Identity
    description: >-
      Protocole d'identité d'agent machine (MAIP) — enregistrement d'agent,
      sessions, confiance, témoin, conformité, orchestration et observabilité
externalDocs:
  description: API de transparence en lecture seule (spécification de service séparée)
  url: >-
    https://github.com/truthlocks/truthlock/blob/main/docs/transparency/openapi.yaml
paths:
  /v1/risk/deepfake/scan:
    post:
      tags:
        - Risk
      summary: Analyse de deepfake
      description: >-
        Évalue les indicateurs fournis par l'appelant ou les scores fournis. Ne
        récupère ni n'analyse le média référencé. Les scores sont des valeurs de
        risque heuristiques, non des probabilités calibrées ; un verdict
        authentique n'est pas une preuve d'authenticité.
      operationId: risk.deepfake.scan
      requestBody:
        required: true
        content:
          application/json:
            schema:
              properties:
                attestation_id:
                  type: string
                deepfake_score:
                  nullable: true
                  type: integer
                impersonation_score:
                  nullable: true
                  type: integer
                signals:
                  type: array
                  items:
                    type: string
                subject_ref:
                  type: string
                  description: Identifiant de référence pour le sujet
                subject_type:
                  type: string
              type: object
              required:
                - subject_ref
                - subject_type
      responses:
        '202':
          description: Analyse initiée
          content:
            application/json:
              schema:
                type: object
                properties:
                  scan_id:
                    type: string
                  status:
                    type: string
                  subject_ref:
                    type: string
        '401':
          description: Authentification requise
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
      security:
        - APIKey: []
components:
  schemas:
    ErrorEnvelope:
      type: object
      required:
        - code
        - message
        - http_status
      properties:
        code:
          type: string
          description: Code d'erreur lisible par machine
          enum:
            - AUTH_REQUIRED
            - AUTH_INVALID
            - PERMISSION_DENIED
            - TENANT_IDENTITY_UNVERIFIED
            - NOT_FOUND
            - VALIDATION_ERROR
            - CONFLICT
            - PAYLOAD_TOO_LARGE
            - RATE_LIMIT_EXCEEDED
            - QUOTA_EXCEEDED
            - SERVICE_UNAVAILABLE
            - INTERNAL_ERROR
        message:
          type: string
          description: Message d'erreur lisible par l'homme
        http_status:
          type: integer
          description: Code de statut HTTP
        retry_after_ms:
          type: integer
          description: >-
            Millisecondes à attendre avant de réessayer (pour les limites de
            débit)
        details:
          type: object
          description: Contexte d'erreur supplémentaire
      example:
        code: AUTH_REQUIRED
        message: Authentication required
        http_status: 401
  securitySchemes:
    APIKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: Clé API pour l'authentification machine-à-machine
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT pour les opérations initiées par l'utilisateur

````

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