Zum Hauptinhalt springen
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.
Die Deepfake- und Impersonation-API bewertet Indikatoren oder externe Scores, die von Ihrer Anwendung für ein referenziertes Subjekt bereitgestellt werden. Sie inspiziert nicht die referenzierten Medien oder Dokumente. Ergebnisse, die den Risikoschwellenwert überschreiten, erzeugen automatisch ein Risikosignal, das Ihre Upstream-Erkennungshinweise mit der Anti-Fraud Identity Firewall-Pipeline verbindet.
Die Deepfake-Erkennung ist Teil der Anti-Fraud Identity Firewall. Scan-Ergebnisse fließen in dieselbe Risikosignal-Pipeline wie andere Betrugssignale, sodass Sie sie von der Konsolenseite Risiko & Betrug > Signale oder dem Listensignale-Endpunkt abfragen und überprüfen können.

Funktionsweise

1

Einen Scan einreichen

Senden Sie eine POST Anfrage an /v1/risk/deepfake/scan mit einer Subjekt-Referenz und entweder rohen Indikatorsignalen aus Ihrer Erkennungspipeline oder vorab berechneten Scores von einem externen Modell.
2

Das Urteil überprüfen

Die Antwort enthält Deepfake- und Imitationswerte (0–100) sowie ein Urteil: authentic, suspect, deepfake oder impersonation.
3

Automatische Signalerstellung

Wenn ein Score 60 oder höher erreicht, nimmt die Plattform automatisch ein Risikosignal in die Pipeline Ihres Mandanten auf. Die Antwort enthält die signal_id, damit Sie sie verfolgen können.
4

Ergebnisse später abrufen

Verwenden Sie GET /v1/risk/deepfake/results/{subject_ref}, um das neueste Scan-Ergebnis für jedes zuvor gescannte Subjekt abzurufen.

Voraussetzungen

  • Ein aktiver Truthlocks-Mandant mit einem API-Schlüssel
  • Subjekt-Referenzen für den Inhalt, den Sie scannen möchten (URLs, SHA-256-Hashes, Attestierungs-IDs oder undurchsichtige Bezeichner)

Scannen eines Subjekts

Einen Scan mit Indikatorsignalen aus Ihrer Erkennungspipeline einreichen:
Die Antwort enthält Scores, ein Urteil und (wenn der Schwellenwert erreicht wurde) ein verknüpftes Risikosignal:

Erkennungsmodell

Die Plattform verwendet eine heuristische Signal-Engine (heuristic_v1), die vom Anrufer bereitgestellte Indikatoren zu gewichteten Scores zuordnet. Die Engine bewertet 12 Indikatoren in zwei Kategorien:

Deepfake-Indikatoren

Indikatoren für Identitätsdiebstahl

Urteile und Schwellenwerte

Jeder Scan erzeugt ein Urteil basierend auf dem höchsten Score: Wenn einer der Werte 60 oder höher erreicht, erstellt die Plattform automatisch ein Risikosignal. Sie müssen keinen separaten API-Aufruf tätigen – der signal_id wird in der Scan-Antwort zurückgegeben.

Verwendung vorab berechneter Scores

Wenn Sie bereits Bewertungen von einem externen ML-Modell oder Erkennungsdienst haben, übergeben Sie diese direkt, um die heuristische Analyse zu überspringen:
Die Plattform wendet weiterhin dieselben Urteilsschwellenwerte und die automatische Signalerfassung an, sodass Sie eine konsistente Klassifizierung erhalten, unabhängig von der Erkennungsquelle.

Verknüpfung von Scans mit Attestierungen

Verknüpfen Sie einen Scan mit einer bestehenden Bestätigung, um Erkennungsergebnisse mit den zugehörigen Anmeldeinformationen zu verknüpfen:
Dies erleichtert das Markieren und Überprüfen verdächtiger Bestätigungen in der Konsole.

Abrufen von Scan-Ergebnissen

Das neueste Scan-Ergebnis für ein Subjekt abrufen, ohne den Scan erneut auszuführen:

Subjekttypen

Das Feld subject_type teilt der Plattform mit, welche Art von Inhalt gescannt wird:

Nutzungsabrechnung

Jede Deepfake-Scan-Anfrage erhöht den Nutzungszähler antifraud.deepfake_scans für Ihren Abrechnungszyklus. Sie können Ihren Scan-Verbrauch mit der Nutzungs-API oder in der Konsole unter Einstellungen > Abrechnung > Nutzung im Abschnitt Betrugsbekämpfung überwachen.
Deepfake-Scan-Kontingente variieren je nach Planstufe. Details zu allen Anti-Fraud-Produkten mit Zähler finden Sie in der Abrechnungsübersicht.

Was als Nächstes kommt