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

# Deepfake- & Imitationsscan

> Ein Subjekt zur Deepfake- und Imitationsanalyse einreichen. Gibt Bewertungen, Urteil und Indikatoren zurück. Nimmt automatisch ein Risikosignal auf, wenn die Bewertungen den automatischen Auslöseschwellenwert (60) überschreiten.

> [!WARNING]
>
> Dieser Endpunkt lädt das referenzierte Bild, Video oder Dokument nicht herunter oder prüft es nicht. Er bewertet Indikatoren oder Scores, die von Ihrer Anwendung bereitgestellt werden. Die Werte sind heuristische Risikobewertungen, keine kalibrierten Wahrscheinlichkeiten. Das Label `authentic` bedeutet, dass der konfigurierte Risikoschwellenwert nicht erreicht wurde; es ist kein Beweis dafür, dass Medien authentisch sind, insbesondere wenn keine Indikatoren bereitgestellt wurden.

## Wie die Erkennung funktioniert

Scans verwenden eine **heuristische Signal-Engine** (`heuristic_v1`), die vom Anrufer bereitgestellte Signale (von externen ML-Modellen, Regel-Engines oder manueller Überprüfung) akzeptiert und diese auf gewichtete Scores abbildet:

* **Deepfake-Indikatoren:** Gesichtstausch, inkonsistente Beleuchtung, Kompressionsartefakte, zeitliche Inkonsistenz, Metadaten-Fehlübereinstimmung
* **Identitätsbetrugsindikatoren:** biometrische Nichtübereinstimmung, Namensnichtübereinstimmung, Nichtübereinstimmung von Identitätsdokumenten, Verletzung des Ausstellervertrauens

Bewertungen ≥ 75 setzen das Urteil `deepfake` oder `impersonation`. Bewertungen ≥ 40 setzen `suspect`. Bewertungen ≥ 60 nehmen automatisch ein Risikosignal auf.

Sie können die heuristische Analyse auch umgehen, indem Sie vorab berechnete `deepfake_score`- und `impersonation_score`-Werte direkt übergeben. Die Plattform wendet weiterhin dieselben Urteilsschwellenwerte und die automatische Signalerfassung an.

Den vollständigen Workflow, die Indikatorreferenz und zusätzliche Beispiele finden Sie im [Handbuch zur Deepfake-Erkennung](https://docs.truthlocks.com/de/guides/deepfake-detection.md).

## Antwort

**scan\_id** `string`

UUID des Scan-Ergebnisses.

**subject\_ref** `string`

Die gescannte Subjekt-Referenz.

**subject\_type** `string`

Typ des Subjekts: `image`, `video`, `document`, `attestation`, `identity`

**deepfake\_score** `integer`

Deepfake-Heuristik-Risikobewertung (0–100).

**impersonation\_score** `integer`

Imitations-Heuristik-Risikobewertung (0–100).

**verdict** `string`

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

**indicators** `array`

Liste der ausgelösten Indikatoren aus dem Scan.

**detection\_model** `string`

Verwendetes Erkennungsmodell (z.B. `heuristic_v1`).

**signal\_id** `string`

UUID des automatisch aufgenommenen Risikosignals (nur vorhanden, wenn Score ≥ 60).

**attestation\_id** `string`

UUID der verknüpften Bestätigung, falls eine während des Scans bereitgestellt wurde.

**created\_at** `string`

ISO 8601 Zeitstempel der Durchführung des Scans.


## OpenAPI

````yaml de/mint-openapi.yaml POST /v1/risk/deepfake/scan
openapi: 3.0.3
info:
  title: Truthlocks API
  description: >
    Truthlocks ist eine universelle Verifizierungsinfrastruktur für Dokumente,
    Anmeldeinformationen und digitale Assets.

    Diese Spezifikation definiert die kanonische API für die Interaktion mit
    Truthlocks-Diensten.


    ## Basis-URLs

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

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


    ## Authentifizierung

    - **API-Schlüssel**: Verwenden Sie den Header `X-API-Key` für
    Machine-to-Machine-Operationen

    - **Bearer Tokens**: Verwenden Sie `Authorization: Bearer <jwt>` für
    benutzerinitiierte Operationen


    ## Mandantenidentität

    In der Produktion wird die Mandantenidentität aus dem authentifizierten
    Kontext (API-Schlüssel oder JWT) abgeleitet.

    Der Header `X-Tenant-ID` wird in der Produktion ignoriert, um Spoofing zu
    verhindern.
  version: 1.0.0
  contact:
    name: Truthlocks Support
    url: https://truthlocks.com/support
    email: support@truthlocks.com
servers:
  - url: https://api.truthlocks.com
    description: Produktions-API
  - url: https://sandbox-api.truthlocks.com
    description: Sandbox-Umgebung
security:
  - APIKey: []
  - BearerAuth: []
tags:
  - name: Authentication
    description: API-Schlüssel- und Token-Verwaltung
  - name: Issuers
    description: Ausstellerregistrierung und Vertrauensmanagement
  - name: Keys
    description: Kryptographische Schlüsselverwaltung für Aussteller
  - name: Attestations
    description: Bestätigungslebenszyklus (prägen, widerrufen, ersetzen)
  - name: Verification
    description: Bestätigungsverifizierung und Proof-Bundles
  - name: Governance
    description: Aussteller-Governance-Workflows (nur Admin)
  - name: Identity
    description: Organisations-, Benutzer- und Rollenverwaltung
  - name: Audit
    description: Audit-Ereignisabfragen
  - name: Tenant Console
    description: Mandantenprofil- und Lebenszyklus-Endpunkte
  - name: Health
    description: Endpunkte für Dienststatus und Bereitschaft
  - name: Risk
    description: Erfassung von Risikosignalen und Betrugserkennung
  - name: Risk Enforcement
    description: >-
      Risikodurchsetzungsmaßnahmen – Blockieren, Herausfordern, Quarantäne und
      Konfiguration
  - name: Billing
    description: Verwaltung von Abrechnung, Abonnements und Add-ons
  - name: Machine Identity
    description: >-
      Machine Agent Identity Protocol (MAIP) – Agentenregistrierung, Sitzungen,
      Vertrauen, Zeugen, Compliance, Orchestrierung und Beobachtbarkeit
externalDocs:
  description: Transparenz-API nur lesend (separate Dienstspezifikation)
  url: >-
    https://github.com/truthlocks/truthlock/blob/main/docs/transparency/openapi.yaml
paths:
  /v1/risk/deepfake/scan:
    post:
      tags:
        - Risk
      summary: Deepfake-Scan
      description: >-
        Bewertet vom Anrufer bereitgestellte Indikatoren oder bereitgestellte
        Bewertungen. Ruft die referenzierten Medien nicht ab oder analysiert sie
        nicht. Bewertungen sind heuristische Risikowerte, keine kalibrierten
        Wahrscheinlichkeiten; ein authentisches Urteil ist kein Beweis für
        Authentizität.
      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: Referenz-ID für das Subjekt
                subject_type:
                  type: string
              type: object
              required:
                - subject_ref
                - subject_type
      responses:
        '202':
          description: Scan initiiert
          content:
            application/json:
              schema:
                type: object
                properties:
                  scan_id:
                    type: string
                  status:
                    type: string
                  subject_ref:
                    type: string
        '401':
          description: Authentifizierung erforderlich
          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: Maschinenlesbarer Fehlercode
          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: Menschenlesbare Fehlermeldung
        http_status:
          type: integer
          description: HTTP-Statuscode
        retry_after_ms:
          type: integer
          description: >-
            Millisekunden, die vor einem erneuten Versuch gewartet werden sollen
            (für Ratenbegrenzungen)
        details:
          type: object
          description: Zusätzlicher Fehlerkontext
      example:
        code: AUTH_REQUIRED
        message: Authentication required
        http_status: 401
  securitySchemes:
    APIKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: API-Schlüssel für die Maschine-zu-Maschine-Authentifizierung
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT für benutzerinitiierte Operationen

````

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